Tutorial: Criar um subagente no Azure SRE Agent

Neste tutorial, crias um subagente especializado no construtor de subagentes 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 Construtor>Subagente Construtor.

3. Selecione a lista suspensa Criar na barra de ferramentas e em seguida selecione Agente Personalizado.

   O diálogo de criação abre com dois separadores: Formulário e YAML.

4. Preencha os campos obrigatórios:

   Campo	Valor de exemplo
   Nome do agente alfândego (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) Configura as secções restantes no diálogo. Se saltar estas secções, o subagente herda todas as competências e ferramentas globais por padrão.

   • Competências: Selecionar Escolher competências para atribuir competências específicas ao subagente. Selecionar competências específicas sobrepõe-se aos padrões globais. Deixe a seleção vazia para permitir todas as competências globais. Para mais informações, consulte Competências.

   • Ferramentas: Selecionar Escolher ferramentas para abrir o painel seletor de ferramentas. Navegue ou pesquise ferramentas organizadas por categoria (por exemplo, ferramentas Kusto ou ferramentas de notificação). Seleciona as ferramentas que queres que o subagente use. 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. Os ganchos funcionam antes da ação (ganchos de prompt) ou depois do uso da ferramenta (ganchos de comando). Para os passos de configuração, consulte Criar e gerir ganchos no portal. Para mais informação, consulte Hooks do Agente.

6. Selecione Criar.

O teu subagente aparece como um nó na tela do construtor de subagentes 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 construtor de subagentes, selecione o alternador da vista 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, abre a sua configuração na tela construtora de subagentes.

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