Tutorial: Criar um subagente no Agente SRE do Azure

Neste tutorial, você criará um subagente especializado no construtor de subagentes 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 Builder>Construtor de subagentes.

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

   A caixa de diálogo de criação é aberta com duas guias: Formulário e YAML.

4. Preencha os campos necessários:

   Campo	Valor de exemplo
   Nome do agente personalizado (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 as seções restantes na janela de diálogo. Se você ignorar essas seções, o subagente herdará todas as habilidades e ferramentas globais por padrão.

   • Habilidades: selecione Escolher habilidades para atribuir habilidades específicas ao subagente. Selecionar habilidades específicas substitui os padrões globais. Deixe a seleção vazia para permitir todas as habilidades globais. Para obter mais informações, consulte Skills.

   • Ferramentas: selecione Escolher ferramentas para abrir o painel seletor de ferramentas. Procure ou pesquise ferramentas organizadas por categoria (por exemplo, ferramentas do Kusto ou ferramentas de notificação). Selecione as ferramentas que você deseja que o subagente use. 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. Os ganchos são executados antes das ações (ganchos de prompt) ou após o uso da ferramenta (ganchos de comando). Para obter as etapas de instalação, consulte Criar e gerenciar ganchos no portal. Para obter mais informações, consulte Os ganchos do Agente.

6. Selecione Criar.

Seu subagente aparece como um nó no canvas do construtor de subagentes, exibindo as ferramentas conectadas.

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 construtor de subagentes, selecione a alternância para a exibição da 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 na tela do construtor de subagentes.

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