Desenvolver ou reutilizar habilidades

Se você tiver uma tarefa repetível e uma experiência de destino da Microsoft, use este artigo para decidir se deseja desenvolver uma habilidade ou adaptar o conteúdo de habilidade existente. Em seguida, escolha as etapas de criação do produto. Você está em Construir ou reutilizar. O resultado é uma implementação de habilidade com suas dependências e evidências de teste, pronta para integração antes do pacote & teste.

Reutilizar ou estender uma habilidade

Para agentes declarativos, o Agent Builder e o Agents Toolkit não oferecem suporte à reutilização entre agentes. Siga a matriz de apoio em Competências em agentes declarativos; Não assuma que uma habilidade anexada a um agente pode ser compartilhada com outro.

Antes de criar uma habilidade:

  1. Revise as habilidades aprovadas que já executam o trabalho necessário.
  2. Confirme se o agente de destino ou a experiência da Microsoft dá suporte ao formato e aos recursos de habilidade.
  3. Examine suas instruções, recursos, scripts, ferramentas e acesso a dados.
  4. Verifique os limites de reutilização documentados da experiência de destino antes de adaptar o conteúdo de habilidade existente.
  5. Confirme a propriedade, o controle de versão, o compartilhamento, o suporte e atualize as expectativas.
  6. Teste a habilidade com entradas representativas e saídas esperadas.

Crie uma nova habilidade quando nenhuma habilidade aprovada existente atender ao requisito ou a experiência de destino não for compatível com a reutilização.

Escolha o caminho de implementação

Comece com o Work IQ Dev Tools para desenvolvimento profissional. Escolha a rota para sua experiência de destino e tipo de projeto; Um formato compartilhado SKILL.md não estabelece a reutilização entre agentes ou a qualificação para publicação.

Abordagem de desenvolvimento Artefato e escopo da habilidade Comece com
Ferramentas de desenvolvimento do Work IQ Uma pasta de habilidades de nível superior em um plug-in independente ou uma habilidade adicionada a um projeto de agente declarativo existente. Essas são rotas de criação separadas. Crie um plug-in com o Work IQ Dev Tools e os detalhes da rota abaixo
Criação de habilidades e distribuição de plug-ins do Copilot Chat Siga as diretrizes de criação e distribuição específicas do produto. Desenvolver habilidades para o Copilot Chat
Construtor de Agentes Um ZIP de habilidade completo carregado em um agente declarativo ou uma habilidade criada a partir de uma descrição no Agent Builder. Adicionar habilidades com o Agent Builder
Microsoft 365 Agents Toolkit Um diretório de habilidades adicionado a um projeto de agente declarativo existente, não um ZIP de habilidades autônomo. Adicionar habilidades com o Kit de Ferramentas de Agentes
Copilot Cowork Pastas de habilidades registradas em um pacote do aplicativo Microsoft 365. Use os requisitos e limites do pacote Cowork. Criar plug-ins para o Copilot Cowork

Corresponder o artefato à sua rota de publicação

Siga as diretrizes de publicação para seu artefato:

O suporte para um artefato não estabelece a qualificação de publicação para todos os pacotes de plug-ins. A publicação não conclui o acesso do usuário, o consentimento ou a configuração da conexão.

O GitHub Copilot pode ajudar com instruções de habilidades, scripts de suporte, recursos, testes e alterações no repositório. A experiência de destino e a ferramenta de criação determinam o formato e o tempo de execução da habilidade com suporte.

Ferramentas de desenvolvimento do Work IQ

O WIQD fornece duas rotas diferentes de criação de habilidades.

  • wiqd plugin add skill Adiciona uma habilidade de nível superior a um projeto de plug-in autônomo. O plug-in pode ser apenas de habilidade ou combinar a habilidade com agentes compatíveis ou conectores MCP remotos. Confirme o suporte do produto de destino separadamente.
  • wiqd agent add skill Adiciona uma habilidade a um projeto de agente declarativo existente. Essa rota usa o sinalizador de agent-skills recurso, que está desativado por padrão.

Ambas as rotas criam uma SKILL.mdfuncionalidade baseada em , mas operam em tipos de projeto diferentes. No formato do plugin WIQD, o nome da habilidade deve corresponder ao nome da pasta e sua descrição deve incluir as frases que a ativam. Consulte O que é um plug-in? e a referência de criação de plug-ins.

A validação de origem WIQD (wiqd plugin validate --mode source) não inspeciona o conteúdo da habilidade. Após o empacotamento, execute wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" com o caminho ZIP real. A validação de pacote carrega uma cópia capturada desse ZIP no serviço de validação do Microsoft 365 e pode exigir autenticação. Revise as descobertas retornadas; Uma passagem não estabelece o comportamento do tempo de execução. Consulte Validação e MVL.

Implementar a habilidade

Conclua o trabalho aplicável:

  1. Defina o trabalho, as entradas, as saídas esperadas, os limites e os critérios de sucesso.
  2. Crie ou importe as instruções de habilidade.
  3. Adicione os scripts e recursos de suporte necessários.
  4. Configure qualquer ferramenta necessária, servidor MCP remoto, API, identidade, permissão ou dependência de dados.
  5. Confirme os tipos de arquivo, os tipos de script, o comportamento da área restrita, o armazenamento e os requisitos de confidencialidade com suporte.
  6. Teste cenários esperados, ambíguos, sem suporte e de falha.
  7. Registre a versão da habilidade, o proprietário, as dependências, as limitações conhecidas e o processo de suporte.

Para habilidades usadas diretamente no Copilot Chat, consulte Criar habilidades para o Copilot Chat. Para obter as restrições atuais de suporte e tempo de execução em agentes declarativos, consulte Habilidades em agentes declarativos. Para o Copilot Cowork, consulte Limites de arquivos complementares. Aplique os requisitos de cada host de destino ao distribuir uma habilidade para mais de uma experiência.

Confirme se a habilidade está funcionando

A habilidade estará pronta para integração quando:

  • O agente ou experiência de destino pode carregá-lo e usá-lo.
  • Suas instruções executam o trabalho definido de forma consistente.
  • Os recursos, scripts, ferramentas e dados necessários estão disponíveis.
  • As permissões e dependências externas funcionam no ambiente de desenvolvimento ou teste.
  • Operações sem suporte ou com falha produzem um comportamento compreensível.
  • A propriedade, o controle de versão, as limitações e as evidências de teste são registrados.

Continue com outros componentes do plano. Quando estiverem concluídos, integre e teste seus componentes e, em seguida, vá para o Pacote & teste para criar o pacote de plug-ins.