Tutorial: Criar uma competência no Azure SRE Agent

Neste tutorial, crias uma competência personalizada que adiciona conhecimento do domínio e manuais de tarefas ao teu agente. As competências são capacidades modulares que o agente carrega automaticamente quando relevante, como resolver problemas de um serviço específico ou executar um procedimento de diagnóstico.

Neste tutorial, aprenderás como:

Tempo estimado: 10 minutos

Pré-requisitos

Antes de começar, certifique-se de que tem os seguintes pré-requisitos:

• Um agente criado no portal Azure SRE Agent.
• Uma compreensão clara do procedimento ou conhecimento do domínio que pretende codificar.

Navegar até ao construtor de subagentes

Abre o construtor de subagentes onde crias e geres competências.

1. Abra o portal do Agente SRE.
2. Selecione o seu agente.
3. Selecione Construtor na navegação da esquerda.
4. Selecionar construtor de subagentes.

Início da criação de competências

Inicia o processo de criação de competências a partir da barra de ferramentas.

1. Selecione o menu suspenso Criar na barra de ferramentas.
2. Selecionar Habilidade.

O diálogo de criação de habilidades começa com um layout de duas colunas. Campos de formulário de um lado e um editor de código do outro a mostrar SKILL.md.

Insira nome e descrição

Forneça um nome e uma descrição que ajudem o agente a decidir quando usar esta competência.

O nome tem de ser único em relação às tuas competências. A descrição aparece na lista de competências e ajuda o agente a decidir quando usar essa habilidade.

Escrever instruções de competências

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

---
name:
description:
---

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

A matéria inicial do YAML (name, description, tools) mantém-se sincronizada com os campos do formulário à esquerda. Escreva as suas instruções em Markdown abaixo do cabeçalho:

---
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 ficheiros de suporte

A secção Ficheiros de um lado mostra um navegador de ficheiros. Para além do padrão SKILL.md, podes adicionar dados de referência, modelos e consultas de exemplo.

• Selecione o ícone do novo ficheiro para adicionar ficheiros.
• Selecione o ícone da nova pasta para organizar os ficheiros em diretórios.
• Arrasta e larga uma pasta na zona de lançamento, ou seleciona o link Carregar pasta para carregar toda a estrutura de pastas.

Selecione qualquer ficheiro no navegador para o editar no editor de código. O editor suporta realce de sintaxe para Markdown, JSON, YAML, KQL, Python e scripts shell.

Selecionar ferramentas

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

1. Selecione Escolher ferramentas na secção de Ferramentas .
2. Navegue ou pesquise por ferramentas. Filtra por tipo (Ferramenta Personalizada, Ferramenta MCP) ou pesquisa por nome.
3. Verifica as ferramentas que esta competência precisa (por exemplo, kusto_query ou azure_resource_health).
4. Feche o painel.

Ferramentas selecionadas aparecem como comprimidos removíveis. Estas ferramentas estão dinamicamente disponíveis quando a habilidade é ativada.

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

Criar a competência

Selecione Criar para guardar a sua habilidade.

A tua habilidade aparece no separador de Habilidades no construtor de subagentes. O agente pode agora usar a habilidade automaticamente quando se depara com uma situação relevante.

Teste a habilidade

O agente principal pode usar habilidades por defeito, dessa forma podes testá-las diretamente no chat sem criar um subagente primeiro.

Teste num novo chat

Usa um novo tópico de chat para confirmar que o agente ativa a tua competência.

1. Selecionar Novo tópico de chat na barra lateral.
2. Escreve um prompt que deva ativar a tua habilidade. Por exemplo: "Estamos a ver uma utilização de CPU elevada na aplicação em contentor, podes verificar?"
3. Verifica se o agente ativa a competência e segue os procedimentos que definiste.

Teste no recreio

Usa o playground para testar a habilidade através de um subagente.

1. Cria um subagente e atribui-lhe essa competência.
2. Na barra de ferramentas do construtor de subagentes, selecione o alternador da vista Playground de Teste.
3. Selecione o subagente, escreva um prompt de teste e verifique se usa corretamente a competência.

Para mais informações, consulte Agente playground.

Editar uma habilidade

Pode modificar uma competência existente para atualizar as suas instruções, ferramentas ou ficheiros de suporte.

1. No separador Habilidades , selecione o nome da habilidade ou selecione-o e escolha Editar.

2. O diálogo de edição abre com todos os valores atuais pré-preenchidos. Muda os campos de que precisas:

   O que mudar	Onde atualizar
   Quando o agente o utiliza	Descrição e instruções SKILL.md
   Que procedimentos seguir	conteúdo do SKILL.md no editor
   Que ferramentas estão disponíveis	Ferramentas> Escolha ferramentas
   Dados de referência	Ficheiros> Adicionar, editar ou remover ficheiros

3. Selecione Guardar.

Dicas para escrever competências eficazes

Use as seguintes orientações para criar competências que o seu agente possa utilizar eficazmente.

• Sê específico sobre quando o usar. O agente lê a descrição e as instruções para decidir a relevância.
• Inclua procedimentos passo a passo. Passos numerados dão ao agente um manual claro.
• Especifique a saída esperada. Diga ao agente que formato devem ter os resultados.
• Adicione dados de referência. Carregue modelos de consultas, linhas de base de configuração ou valores conhecidos como ficheiros de apoio.
• Atribui ferramentas relevantes. Se a competência precisar de ferramentas específicas como consultas Kusto ou ações do Azure, adicione-as.

Próximo passo

Conteúdo relacionado

• Competências
• Carregar documentos de conhecimento
• Subagentes
• Parque de Agentes
• Tools
• Criar uma ferramenta Kusto
• Criar uma ferramenta Python
• Criar tarefas agendadas
• Teste uma ferramenta no recreio