Use as habilidades do agente com o GitHub Copilot no SQL Server Management Studio

As habilidades do agente são conjuntos reutilizáveis de instruções que instruem GitHub Copilot como executar tarefas específicas. Cada habilidade é um arquivo de markdown que você define uma vez, economizando tempo e garantindo um comportamento consistente em seu fluxo de trabalho. Pense nas habilidades como um manual operacional, e não como um único prompt enorme. Quando você usa o modo Agent (versão prévia), Copilot descobre automaticamente e aplica habilidades relevantes com base no que você está perguntando.

Observação

O modo GitHub Copilot Agent no SSMS (SQL Server Management Studio) está atualmente em versão prévia.

Ao contrário das instruções personalizadas, que definem preferências gerais para cada resposta, as habilidades fornecem diretrizes específicas de tarefa focadas que qualquer agente pode descobrir e usar. Defina uma habilidade uma vez, e ela será aplicada de forma consistente em todas as sessões e em toda a sua equipe.

Pré-requisitos

Como as habilidades do Agente funcionam

Quando você usa o Modo de Agente, o Copilot analisa os locais conhecidos das habilidades do seu repositório e do seu perfil de usuário. Se a descrição de uma habilidade corresponder à intenção de sua solicitação, Copilot ativará a habilidade e aplicará suas instruções como contexto extra. Quando uma habilidade está ativa, seu nome aparece no chat para que você saiba que ela está sendo aplicada.

Copilot decide quais habilidades ativar com base no campo description presente no frontmatter de cada habilidade. Uma descrição clara e rica em palavras-chave ajuda Copilot identificar quando uma habilidade é relevante.

Localizações de habilidades

O Copilot identifica habilidades nos seguintes locais:

Scope Paths Detalhes
Workspace (compartilhado com sua equipe) .github/skills/, .claude/skills/, .agents/skills/ Armazenado na raiz do repositório. Comprometidos com o controle do código-fonte para que todos os membros da equipe obtenham as mesmas habilidades.
Pessoal (somente seu perfil) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/ Aplica-se em todos os seus projetos. Não submetido a nenhum repositório.

As habilidades do espaço de trabalho têm precedência sobre as convenções específicas do projeto. As habilidades pessoais são úteis para fluxos de trabalho e preferências que viajam com você entre projetos.

Criar uma habilidade

Você pode criar uma habilidade no painel Habilidades no SSMS ou manualmente em seu sistema de arquivos.

Criar uma habilidade no painel Habilidades

  1. Na janela Copilot Chat, selecione o ícone Tools.
  2. Selecione o painel Habilidades .
  3. No painel Habilidades, selecione o + botão.
  4. Escolha o escopo: uma habilidade do espaço de trabalho (armazenada no repositório) ou uma habilidade pessoal (armazenada no seu perfil de usuário).
  5. Insira um nome para a habilidade. O nome se torna o nome do diretório e deve usar apenas letras minúsculas, números e hifens.
  6. O SSMS gera um modelo SKILL.md no diretório da nova habilidade. Edite o modelo e adicione suas instruções ao arquivo.

Criar uma habilidade manualmente

  1. Crie um diretório de habilidades no local apropriado. Para uma habilidade de espaço de trabalho, crie .github/skills/ na raiz do seu repositório.
  2. Crie um subdiretório para sua habilidade. Cada habilidade deve ter seu próprio diretório. Por exemplo: .github/skills/tsql-style-guide/.
  3. Crie um SKILL.md arquivo dentro do diretório de habilidades.
  4. Opcionalmente, adicione arquivos de suporte, como scripts, documentos de referência ou saída de exemplo.

Estrutura do diretório de habilidades

your-repo/
└── .github/
    └── skills/
        └── index-verification/
        │   ├── SKILL.md          # Required: metadata and instructions
        │   └── references/       # Optional: supplementary documentation
        └── agent-job-failure-triage/
            ├── SKILL.md
            └── examples/         # Optional: example scripts

formato SKILL.md

Cada SKILL.md arquivo deve conter o frontmatter YAML seguido de instruções de Markdown. O frontmatter fornece os metadados que Copilot usa para descobrir e ativar a habilidade.

Propriedades do Frontmatter

Property Required Description
name Yes Letras minúsculas, números e hifens somente. Deve corresponder ao nome do diretório pai. Máximo de 64 caracteres.
description Yes Descreve o que a habilidade faz e quando usá-la. Máximo de 1.024 caracteres. Inclua palavras-chave específicas que sinalizam quando a habilidade é relevante.
license No Nome da licença ou referência a um arquivo de licença incluído com a skill.
compatibility No Requisitos de ambiente, como o produto pretendido ou as funcionalidades necessárias do sistema.
metadata No Pares chave-valor arbitrários para outros metadados.
allowed-tools No Lista separada por espaço de nomes de ferramentas que a habilidade é pré-aprovada para usar.

Gerencie habilidades no painel Habilidades

Selecione o ícone Tools na janela Copilot Chat para abrir o painel Skills. O painel mostra todas as habilidades que o Copilot descobre para sua sessão atual.

No painel, você pode:

  • Editar: Abra diretamente no editor o arquivo SKILL.md de qualquer habilidade no menu ....
  • Abrir o local do arquivo: ir para o diretório da habilidade no disco.
  • Pesquisa: filtrar habilidades por nome ou palavra-chave.

O painel também apresenta o diagnóstico para quaisquer erros de configuração de habilidade, para que você possa identificar e corrigir problemas rapidamente.

Dicas para escrever competências eficazes

  • Mantenha SKILL.md conciso: procure ficar com menos de 300 linhas. Mova o material de referência detalhado para separar arquivos em subdiretórios relevantes.
  • Escreva uma descrição rica em palavra-chave: Copilot usa o description para decidir quando ativar a habilidade. Inclua as tarefas, objetos e cenários específicos em que a habilidade se aplica.
  • Use etapas numeradas em procedimentos: instruções passo a passo são mais fáceis para o modelo seguir do que texto corrido.
  • Inclua exemplos da saída esperada: mostre exemplos de código, formatos de tabela ou blocos de comentários para que o modelo saiba como deve ser o resultado final.
  • Defina limites explícitos: diga à habilidade o que não fazer. Por exemplo, "Não é recomendável descartar índices em tabelas com mais de 10 milhões de linhas sem primeiro relatar volume de gravação".
  • Material de apoio de referência: armazene conteúdo e scripts relacionados em arquivos dentro de references\, scripts\ ou examples\ e aponte para conteúdo específico da habilidade.

Exemplo de habilidades de SQL

Os exemplos a seguir demonstram como escrever habilidades para tarefas comuns de SQL Server. Use-os como pontos de partida e adapte-os às convenções da sua equipe.

Verificação de índice

Examine os índices existentes antes de recomendar novos para evitar a duplicação.

---
name: index-verification
description: Use when an index recommendation has been generated and must be validated before implementation. Verifies workload benefit, redundancy, write overhead, storage impact, and existing index coverage.
---

# Index Verification

## Use this skill when

- A missing index recommendation exists
- An agent generated an index recommendation
- Query tuning suggests adding an index
- A user asks whether an index should be created

## Never assume

- Missing index DMVs are recommendations, not requirements.
- Do not recommend index creation until validation is complete.

## Verification Checklist

### 1. Check Existing Indexes

Determine whether:

- An equivalent index already exists
- A wider index already covers the workload
- Included columns already satisfy the query
- The recommendation duplicates another recommendation

### 2. Estimate Read Benefit

Evaluate:

- Query execution frequency
- Current execution cost
- Expected seek/selectivity improvement
- Number of affected queries

### 3. Evaluate Write Cost

Determine:

- Insert impact
- Update impact
- Delete impact
- Additional maintenance cost

### 4. Evaluate Storage Impact

Estimate:

- Index size on disk
- Memory pressure
- Replication impact

### 5. Make Recommendation

Return one of:

- Create index
- Modify existing index
- Consolidate with existing recommendation
- Reject recommendation

## Avoid

- Blindly trusting missing-index DMVs
- Creating overlapping indexes
- Recommending indexes for one-off queries
- Ignoring write-heavy workloads

## Output Format

Format output as a table: index name, columns, type, and recommendation (create / modify / consolidate / reject).

Triagem de falhas de tarefa do agente

Analise o histórico de trabalhos com falha do SQL Agent e faça recomendações para resolver o problema raiz.

---
name: agent-job-failure-triage
description: Use when an automated job, workflow, maintenance task, or agent execution fails. Determines root cause and appropriate remediation while avoiding unsafe recovery actions.
---
# Agent Job Failure Triage

## Objective

Identify root cause before attempting remediation.

## First Rule

Never retry repeatedly without understanding why the job failed.

## Investigation Order

### 1. Collect Failure Details

Gather:

- Job name
- Error message
- Start time
- End time
- Retry history

### 2. Classify Failure

Determine whether failure is:

- Resource-related
- Permission-related
- Configuration-related
- Data-related
- Dependency-related
- Other or unknown

### 3. Check Recent Changes

Investigate:

- Deployments
- Configuration changes
- Schema changes
- Security changes
- Infrastructure changes

### 4. Determine Blast Radius

Identify:

- Data modified by job
- Schema modified by job
- Affected users or departments
- Downstream jobs
- SLA impact
- Data correctness risk

## Safe Actions

- Collect logs
- Validate dependencies
- Escalate when root cause is unknown

## Unsafe Actions

- Retry job
- Disable job
- Force-completing jobs
- Disabling validation checks
- Modifying production data to "make it pass"
- Restarting the SQL Agent service

Conteúdo relacionado

  • Last updated on