Tutorial: Criar um subagente no Azure SRE Agent

Neste tutorial, cria um subagente especializado no Agent Canvas com as suas próprias instruções, ferramentas e competências. Os subagentes tratam de tarefas específicas como relatórios de saúde, triagem de alertas ou entrega de notificações. Para mais informações sobre como funcionam os subagentes, consulte Subagentes.

Tempo estimado: 5 minutos

Neste tutorial, aprenderás como:

Pré-requisitos

• Um agente criado no portal Azure SRE Agent.
• Pelo menos um conector configurado, se quiseres que o subagente use ferramentas externas.

Criar um subagente

Siga estes passos para criar um novo subagente a partir do portal.

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

2. Selecione Builder>Agent Canvas.

3. Selecionar + Criar subagente.

   A caixa de diálogo Criar um subagente abre-se com dois separadores: Formulário e YAML.

4. Preencha os campos obrigatórios:

   Campo	Valor de exemplo
   Nome do subagente (obrigatório)	health-check-reporter
   Instruções (obrigatórias)	És um repórter de verificações de saúde. Verifique a saúde dos recursos Azure para aplicações de contentores no grupo de recursos de produção. Resuma as contagens saudáveis, de aviso e críticas. Envie o resumo por email."

   Sugestão

   Seleciona Refinar com IA acima do campo de instruções para que o agente melhore automaticamente as tuas instruções. Selecione Ver sugestões de IA para ver recomendações para melhorar instruções, ferramentas e competências.

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

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

   • Competências: Ative Ativar Competências para que o subagente possa usar as competências. Em Habilidades Permitidas, deixe a seleção vazia para permitir todas as habilidades ou selecione as competências específicas que o subagente pode usar. Para mais informações, consulte Competências.

   • Definições avançadas:

     • Subagentes de encaminhamento: Selecione outros subagentes para os quais este subagente pode 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 mais informações, consulte Ferramentas.
     • Ganchos: Selecione Gerir Ganchos para adicionar controlos de segurança e governação. Para os passos de configuração, consulte Criar e gerir ganchos no portal. Para mais informação, consulte Hooks do Agente.
     • Dar acesso à base de conhecimento: Ative esta opção para permitir que o subagente use documentos na base de conhecimento.

6. Selecione Criar.

O seu subagente aparece como um nó no Agent Canvas com quaisquer ferramentas ligadas exibidas.

Testar o subagente

Depois de criares o teu subagente, testa-o para confirmar se se comporta como esperado.

Teste do diálogo

No diálogo de criação ou edição, selecione o ícone de teste no canto superior direito para abrir o painel Testar agente ao vivo. Escreve um prompt e vê como o subagente responde com as instruções e ferramentas atuais.

Teste no recreio

Use o parque infantil para uma experiência de teste interativa com um layout em ecrã dividido.

1. Na barra de ferramentas do Agent Canvas, selecione a opção de ativar a vista do playground de teste .
2. O layout em ecrã dividido mostra a configuração do seu subagente de um lado e um chat ao vivo do outro.
3. Selecione o seu subagente, escreva um prompt de teste e verifique se se comporta como esperado.
4. Itera editando instruções ou trocando de ferramenta, depois testa novamente até o resultado corresponder às tuas expectativas.

Para mais informações, consulte Agente playground ou Teste uma ferramenta no playground.

Editar um subagente

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

Selecione o nó subagente e depois selecione Editar (ou clique duplo no nó). O diálogo de edição abre com todos os valores atuais pré-preenchidos.

Selecione Guardar quando terminar.

Edit com YAML

Podes ver ou editar a configuração do teu subagente como YAML para copiar configurações ou gerir a configuração como código.

Selecione o separador YAML no topo da janela de diálogo criar ou editar para mudar para o modo YAML. As alterações no modo YAML sincronizam novamente com a visualização do formulário.

Próximo passo

Conteúdo relacionado

• Subagentes
• Parque de Agentes
• Competências
• Tools
• Ganchos de agente
• Criar uma ferramenta Kusto
• Criar uma ferramenta Python
• Criar tarefas agendadas
• Teste uma ferramenta no recreio