Tutorial: Criar uma habilidade no Agente SRE do Azure

Neste tutorial, você criará uma habilidade personalizada que adiciona conhecimento de domínio e guias estratégicos de tarefas ao seu agente. As habilidades são funcionalidades modulares que seu agente carrega automaticamente quando relevantes, como solucionar problemas de um serviço específico ou executar um procedimento de diagnóstico.

Neste tutorial, você aprenderá como:

Tempo estimado: 10 minutos

Pré-requisitos

Antes de começar, verifique se você tem os seguintes pré-requisitos:

• Um agente criado no portal de agente do Azure SRE.
• Uma compreensão clara do procedimento ou do conhecimento de domínio que você deseja codificar.

Navegue até o construtor de subagentes

Abra o construtor de subagentes no qual você cria e gerencia habilidades.

1. Abra o portal do Agente SRE.
2. Selecione seu agente.
3. Selecione Construtor na navegação à esquerda.
4. Selecione o Construtor de Subagentes.

Iniciar a criação de habilidades

Inicie o processo de criação de habilidades na barra de ferramentas.

1. Selecione o menu Criar na barra de ferramentas.
2. Selecione Skill.

A caixa de diálogo de criação de habilidades é aberta com um layout de duas colunas. Campos de formulário de um lado e um editor de código do outro mostrando SKILL.md.

Inserir nome e descrição

Forneça um nome e uma descrição que ajudam o agente a decidir quando usar essa habilidade.

O nome deve ser único em todas as suas habilidades. A descrição aparece na lista de habilidades e ajuda o agente a decidir quando usar essa habilidade.

Escrever instruções de habilidade

O editor central mostra SKILL.md, que contém as instruções da habilidade. O arquivo começa com um modelo padrão.

---
name:
description:
---

<!-- Add your skill instructions here -->

O cabeçalho YAML (name, description, tools) está sincronizado com os campos de formulário à esquerda. Escreva suas instruções em Markdown abaixo do front matter:

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Adicionar arquivos de suporte

A seção Arquivos de um lado mostra um navegador de arquivos. Além do padrão SKILL.md, você pode adicionar dados de referência, modelos e consultas de exemplo.

• Selecione o novo ícone de arquivo para adicionar arquivos.
• Selecione o novo ícone de pasta para organizar arquivos em diretórios.
• Arraste e solte uma pasta na zona suspensa ou selecione o link Carregar pasta para carregar uma estrutura de pasta inteira.

Selecione qualquer arquivo no navegador para editá-lo no editor de código. O editor dá suporte ao realce de sintaxe para scripts Markdown, JSON, YAML, KQL, Python e shell.

Selecionar ferramentas

Opcionalmente, anexe as ferramentas que a habilidade usa durante a execução.

1. Selecione Escolher ferramentas na seção Ferramentas .
2. Procure ou pesquise ferramentas. Filtrar por tipo (Ferramenta Personalizada, Ferramenta MCP) ou pesquisar por nome.
3. Verifique as ferramentas de que essa habilidade precisa (por exemplo, kusto_query ou azure_resource_health).
4. Feche o painel.

As ferramentas selecionadas aparecem como elementos removíveis. Essas ferramentas ficam disponíveis dinamicamente quando a habilidade é ativada.

Para criar ferramentas personalizadas, consulte Criar uma ferramenta Kusto ou criar uma ferramenta Python. Para obter mais informações sobre ferramentas, consulte Ferramentas.

Criar a competência

Selecione Criar para salvar sua habilidade.

Sua habilidade aparece na guia Habilidades no construtor de subagentes. O agente agora pode usar a habilidade automaticamente quando encontrar uma situação relevante.

Testar a habilidade

O agente principal pode usar habilidades por padrão, para que você possa testá-las diretamente no chat sem criar um subagente primeiro.

Testar em um novo chat

Use um novo thread de chat para verificar se o agente ativa sua habilidade.

1. Selecione Novo thread de chat na barra lateral.
2. Digite um prompt que deve ativar sua funcionalidade. Por exemplo: "Estamos vendo um alto uso de CPU em nosso aplicativo em contêiner, você pode investigar?"
3. Verifique se o agente ativa a habilidade e segue os procedimentos que você definiu.

Teste no playground

Use o playground para testar a habilidade por meio de um subagente.

1. Crie um subagente e atribua essa habilidade a ele.
2. Na barra de ferramentas do construtor de subagentes, selecione a alternância para a exibição da Playground de teste.
3. Selecione o subagente, digite um prompt de teste e verifique se ele usa a habilidade corretamente.

Para obter mais informações, consulte Playground do Agente.

Editar uma habilidade

Você pode modificar uma habilidade existente para atualizar suas instruções, ferramentas ou arquivos de suporte.

1. Na guia Habilidades , selecione o nome da habilidade ou selecione-o e escolha Editar.

2. A caixa de diálogo de edição é aberta com todos os valores atuais preenchidos. Altere os campos necessários:

   O que mudar	Onde atualizar
   Quando o agente o usa	Descrição e instruções do SKILL.md
   Quais procedimentos seguir	conteúdo do SKILL.md no editor
   Quais ferramentas estão disponíveis	Ferramentas> Escolher ferramentas
   Dados de referência	Arquivos> adicionar, editar ou remover arquivos

3. Clique em Salvar.

Dicas para escrever competências eficazes

Use as diretrizes a seguir para criar habilidades que seu agente pode usar efetivamente.

• Seja específico sobre quando usá-lo. O agente lê a descrição e as instruções para decidir a relevância.
• Inclua procedimentos passo a passo. As etapas numeradas dão ao agente um guia estratégico claro.
• Especifique a saída esperada. Informe ao agente qual formato os resultados devem ter.
• Adicionar dados de referência. Carregue modelos de consulta, linhas de base de configuração ou valores conhecidos como bons como arquivos de suporte.
• Atribua ferramentas relevantes. Se a habilidade precisar de ferramentas específicas, como consultas kusto ou ações do Azure, adicione-as.

Próxima etapa

Conteúdo relacionado

• Habilidades
• Carregar documentos de conhecimento
• Subagentes
• Agente playground
• Ferramentas
• Criar uma ferramenta Kusto
• Criar uma ferramenta do Python
• Criar tarefas agendadas
• Testar uma ferramenta no playground