Habilidades como recursos de plug-in

Uma habilidade fornece instruções reutilizáveis ou um fluxo de trabalho que ensina a um agente ou experiência com suporte da Microsoft como executar um trabalho específico. Uma habilidade é representada por um diretório com um arquivo necessário SKILL.md e pode incluir recursos de suporte ou scripts.

Um plug-in pode reunir uma habilidade com outros recursos com suporte, como agentes, conectores do Copilot ou ferramentas baseadas em MCP. O plug-in é a unidade de extensibilidade; A habilidade continua sendo uma capacidade reutilizável distinta.

Importante

A disponibilidade de habilidades, o compartilhamento, o uso automático e o suporte ao host variam de acordo com a experiência da Microsoft. A documentação atual aborda principalmente a adição de habilidades aos agentes. Siga as diretrizes para a experiência de criação e o host de destino em vez de presumir que todas as habilidades podem ser empacotadas ou distribuídas de forma independente.

Decida se você precisa de uma habilidade

Escolha uma habilidade quando:

  • A solução requer instruções repetíveis ou um fluxo de trabalho para um trabalho específico.
  • A experiência deve ser reutilizável em agentes ou experiências compatíveis.
  • O trabalho pode ser expresso por meio de instruções e recursos de apoio.
  • A habilidade pode chamar ferramentas ou scripts aprovados quando a experiência de destino os suportar.

Uma habilidade pode não ser o componente certo quando:

  • O requisito é a experiência de conversação completa. Considere um agente declarativo.
  • O requisito é principalmente o acesso a dados externos. Considere um conector.
  • O requisito é expor ferramentas ou recursos hospedados remotamente. Considere um servidor MCP.

Decida se deseja compilar ou reutilizar

Antes de criar uma habilidade:

  • Procure uma habilidade aprovada que já executa o trabalho.
  • Determine se uma habilidade existente pode ser reutilizada no estado em que se encontra ou configurada para o cenário.
  • Confirme se o formato da habilidade e seus recursos são compatíveis com a ferramenta de criação de destino e com a experiência da Microsoft.
  • Examine as instruções e os arquivos de suporte para dados, segurança, IA responsável e requisitos de manutenção.
  • Identifique as lacunas que exijam uma habilidade nova ou estendida.

Se você reutilizar uma habilidade, confirme quem é o proprietário de seu conteúdo, controle de versão, teste, suporte e distribuição.

Registrar dependências de habilidades

Ao decidir se deseja desenvolver ou reutilizar uma habilidade, observe:

  • O trabalho, as entradas, a saída esperada e os critérios de êxito.
  • O agente ou a experiência da Microsoft com suporte que usa a habilidade.
  • Conhecimento necessário, conectores, ferramentas baseadas em MCP, scripts ou outros recursos.
  • Requisitos de autenticação, permissões, dados e execução.
  • Restrições de formato, versão, compartilhamento e host.
  • Proprietário, contato de suporte e requisitos de teste.

Depois de decidir criar ou reutilizar uma habilidade, escolha ferramentas de desenvolvimento.