Tutorial: Criar um subagente no Agente SRE do Azure

Neste tutorial, você cria um subagente especializado no Agent Canvas com suas próprias instruções, ferramentas e habilidades. Os subagentes lidam com tarefas focadas, como relatórios de saúde, triagem de alertas ou envio de notificações. Para obter mais informações sobre como os subagentes funcionam, consulte Subagentes.

Tempo estimado: 5 minutos

Neste tutorial, você aprenderá como:

Pré-requisitos

• Um agente criado no portal de agente do Azure SRE.
• Pelo menos um conector configurado, se você quiser que o subagente use ferramentas externas.

Criar um subagente

Siga estas etapas para criar um novo subagente no portal.

1. Abra o portal do Agente SRE e selecione seu agente.

2. Selecione Construtor>Agent Canvas.

3. Selecionar + Criar subagente.

   A janela de diálogo Criar um subagente abre com duas abas: Formulário e YAML.

4. Preencha os campos necessários:

   Campo	Valor de exemplo
   Nome do subagente (obrigatório)	health-check-reporter
   Instruções (obrigatório)	"Você é um relator de verificação de integridade. Verifique a saúde dos recursos do Azure para aplicativos de contêiner no grupo de recursos de produção. Resumir contagens saudáveis, de aviso e críticas. Envie o resumo por email."

   Dica

   Selecione Refinar com IA acima do campo de instruções para permitir que o agente melhore suas instruções automaticamente. Selecione Exibir sugestões de IA para ver recomendações para aprimorar instruções, ferramentas e habilidades.

5. (Opcional) Configure os campos e seções restantes no diálogo.

   • Instruções de entrega: Descreva quando outro agente deve delegar trabalho a esse subagente.

   • Habilidades: Ative Habilitar Habilidades para permitir que o subagente use habilidades. Em Habilidades Permitidas, deixe a seleção vazia para permitir todas as habilidades ou selecione as habilidades específicas que o subagente pode usar. Para obter mais informações, consulte Skills.

   • Configurações avançadas:

     • Subagentes de transferência: Selecione outros subagentes para os quais esse subagente possa delegar trabalho.
     • Ferramentas: Selecione Escolher ferramentas e depois selecione as ferramentas que o subagente pode usar. Para criar ferramentas personalizadas primeiro, consulte Criar uma ferramenta Kusto ou criar uma ferramenta python. Para obter mais informações, consulte Ferramentas.
     • Ganchos: selecione Gerenciar Ganchos para adicionar controles de segurança e governança. Para obter as etapas de instalação, consulte Criar e gerenciar ganchos no portal. Para obter mais informações, consulte Os ganchos do Agente.
     • Dê acesso à base de conhecimento: Ative essa opção para permitir que o subagente use documentos na base de conhecimento.

6. Selecione Criar.

Seu subagente aparece como um nó no Agent Canvas, com todas as ferramentas conectadas a ele exibidas.

Testar o subagente

Depois de criar o subagente, teste-o para verificar se ele se comporta conforme o esperado.

Testar a partir do diálogo

Na caixa de diálogo de criação ou edição, selecione o ícone de teste no canto superior direito para abrir o painel Agente humano de teste. Digite um prompt e veja como o subagente responde com suas instruções e ferramentas atuais.

Teste no playground

Use o playground para uma experiência de teste interativa com um layout de tela dividida.

1. Na barra de ferramentas do Agent Canvas, selecione a opção de ativar a visualização do playground de teste .
2. O layout de tela dividida mostra a configuração do subagente de um lado e um chat ao vivo do outro.
3. Selecione o subagente, digite um prompt de teste e verifique se ele se comporta conforme o esperado.
4. Itera editando instruções ou trocando ferramentas e teste novamente até que a saída corresponda às suas expectativas.

Para obter mais informações, consulte Playground de agente ou Teste uma ferramenta no playground.

Editar um subagente

Para modificar um subagente existente, abra sua configuração no Agent Canvas.

Selecione o nó do subagente e, em seguida, selecione Editar (ou clique duas vezes no nó). A caixa de diálogo de edição é aberta com todos os valores atuais preenchidos.

Selecione Salvar quando terminar.

Editar com YAML

Você pode exibir ou editar a configuração do subagente como YAML para copiar configurações ou gerenciar a configuração como código.

Selecione a guia YAML na parte superior da caixa de diálogo criar ou editar para alternar para o modo YAML. Alterações no modo YAML sincronizam novamente com o modo de exibição de formulário.

Próxima etapa

Conteúdo relacionado

• Subagentes
• Agente playground
• Habilidades
• Ferramentas
• Ganchos de agente
• Criar uma ferramenta Kusto
• Criar uma ferramenta do Python
• Criar tarefas agendadas
• Testar uma ferramenta no playground