Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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:
- Revise as habilidades aprovadas que já executam o trabalho necessário.
- Confirme se o agente de destino ou a experiência da Microsoft dá suporte ao formato e aos recursos de habilidade.
- Examine suas instruções, recursos, scripts, ferramentas e acesso a dados.
- Verifique os limites de reutilização documentados da experiência de destino antes de adaptar o conteúdo de habilidade existente.
- Confirme a propriedade, o controle de versão, o compartilhamento, o suporte e atualize as expectativas.
- 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:
- Plug-in WIQD autônomo:Compartilhe com usuários selecionados ou envie para o catálogo da sua organização. Compartilhar não é publicação de catálogo.
- Pacote do Copilot Cowork: siga Publicar para seu locatário.
- Agente declarativo com habilidades: Siga Publique seu agente para o envio do Microsoft Marketplace.
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 skillAdiciona 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 skillAdiciona uma habilidade a um projeto de agente declarativo existente. Essa rota usa o sinalizador deagent-skillsrecurso, 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:
- Defina o trabalho, as entradas, as saídas esperadas, os limites e os critérios de sucesso.
- Crie ou importe as instruções de habilidade.
- Adicione os scripts e recursos de suporte necessários.
- Configure qualquer ferramenta necessária, servidor MCP remoto, API, identidade, permissão ou dependência de dados.
- Confirme os tipos de arquivo, os tipos de script, o comportamento da área restrita, o armazenamento e os requisitos de confidencialidade com suporte.
- Teste cenários esperados, ambíguos, sem suporte e de falha.
- 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.