Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As habilidades no Microsoft 365 Copilot Chat geralmente estão disponíveis. A skill pacotes de instruções específicas da tarefa, critérios de qualidade e arquivos ou scripts de suporte opcionais para que os usuários não precisem repetir o mesmo fluxo de trabalho em cada conversa.
Você pode criar uma habilidade para uso direto no Copilot Chat sem criar um agente declarativo. Os usuários podem selecionar uma habilidade instalada explicitamente ou permitir que o Copilot a selecione automaticamente quando for relevante. Os usuários controlam a invocação automática para cada habilidade.
Importante
Em locatários que usam IB (Barreiras de Informações do Microsoft Purview), não há suporte para habilidades no Copilot Chat. Essa restrição se aplica a habilidades pessoais e habilidades distribuídas como parte de um plug-in.
Escolha o escopo da habilidade
| Destino | Caminho de criação e distribuição |
|---|---|
| Uma habilidade pessoal usada diretamente no Copilot Chat | Crie um arquivo autônomo SKILL.md ou um ZIP de habilidade. Os usuários também podem criar e editar habilidades pessoais com o Copilot Chat. |
| Uma habilidade distribuída como parte de um plug-in | Use as Ferramentas de Desenvolvimento do Work IQ para criar um pacote do aplicativo Microsoft 365 e, em seguida, use um método de compartilhamento ou publicação com suporte. |
Criar uma habilidade pessoal
Dica
Se você estiver planejando empacotar sua habilidade como um plug-in, siga as etapas em Empacotar uma habilidade em um plug-in . As Ferramentas de Desenvolvimento do Work IQ automatizam a maioria das etapas nesta seção.
Cada skill requer um arquivo chamado SKILL.md. Adicione scripts e recursos opcionais somente quando a tarefa precisar deles.
release-notes/
|-- SKILL.md
|-- references/
| `-- release-note-format.md
`-- scripts/
`-- format_release_notes.py
Comece SKILL.md com elementos textuais YAML contendo um nome e uma descrição. Para habilidades de plug-in WIQD, o nome deve corresponder exatamente à pasta que o contém. Use de 1 a 64 caracteres alfanuméricos minúsculos e hifens, sem hifens à esquerda, à direita ou consecutivos. A descrição pode conter de 1 a 1.024 caracteres e deve identificar as solicitações que ativam a habilidade.
Por exemplo:
---
name: release-notes
description: Draft release notes or a changelog from a supplied list of changes, grouped into Features, Fixes, and Other.
---
# Release notes
Use this skill when the user asks for release notes or a changelog.
1. Use the change list supplied by the user. If it is missing, ask for it.
2. Group the changes into Features, Fixes, and Other.
3. Use references/release-note-format.md for the output structure.
4. Preserve issue and pull request links from the supplied input.
5. Don't invent changes, links, version numbers, or release dates.
6. Return the draft and identify any missing information.
Inclua todos os arquivos aos quais as instruções fazem referência. Por exemplo, se você adicionar um script de formatação, explique quando executá-lo, quais entradas ele aceita e como lidar com falhas. Mantenha credenciais, tokens e segredos fora da habilidade.
Diretrizes de design
Mantenha a habilidade focada
- Dê à habilidade um trabalho definido, com entradas, saídas e limites claros.
- Inclua frases na descrição que os usuários provavelmente usarão para esse trabalho.
- Mantenha
SKILL.mdmenos de 20.000 caracteres como uma recomendação de criação. Mova o material de referência detalhada para arquivos de suporte e explique quando lê-lo. - Mantenha o diretório superficial e inclua apenas os arquivos necessários para a tarefa. Confirme a contagem de arquivos, a profundidade do diretório e os limites de tamanho do pacote para cada host de destino.
Adicionar recursos e scripts compatíveis
Use tipos de arquivo compatíveis com o runtime da habilidade de chat:
| Categoria | Tipos de arquivos |
|---|---|
| Instruções e arquivos de recursos |
.json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .txt, .rtf, .md, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log |
| Scripts |
.py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash |
As habilidades de chat e as habilidades anexadas ao agente têm caminhos de upload separados. Não aplique os limites do Agent Builder e do Agents Toolkit a um upload de habilidade pessoal do Chat.
Respeitar o limite de tempo de execução do script
Scripts de habilidades:
- Não é possível acessar a Internet ou a rede em tempo de execução.
- Não é possível instalar pacotes em tempo de execução.
- Pode usar apenas pacotes já disponíveis no tempo de execução.
- Não é possível fazer chamadas de rede autenticadas.
Quando uma tarefa exigir dados ou ações externas, faça com que o Copilot invoque um conector habilitado ou outro recurso externo com suporte. Não coloque chamadas de rede em um script de habilidade como substituto.
Para um plug-in que inclui um conector MCP remoto, use a configuração do manifesto do agentConnectors aplicativo. Nas instruções de habilidade, explique quando e por que o Copilot deve usar o conector. A configuração da conexão e as permissões do usuário permanecem separadas das instruções de habilidade.
Conta para proteção de dados
Os arquivos de habilidade de chat carregados são armazenados em contêineres do SharePoint Embedded no escopo do locatário. Os rótulos de confidencialidade são retidos e as políticas de rótulos são respeitadas. Não há suporte para permissões definidas pelo usuário e Criptografia de Chave Dupla.
Examine as instruções, os recursos, os scripts, o acesso a dados e as saídas em relação aos requisitos da sua organização. Use Planeje dados, privacidade e segurança para uma solução mais ampla.
Carregar a habilidade
Para um upload direto de habilidade, forneça SKILL.md sozinho ou um ZIP com SKILL.md na raiz e todos os arquivos de suporte abaixo dele. Não inclua um diretório delimitador extra acima SKILL.md no ZIP.
No Copilot Chat, selecione Agentes>Mais agentes. Selecione o menu suspenso ao lado de Adicionar e selecione Carregar habilidade.
Adicione seu arquivo SKILL.md ou ZIP e selecione Carregar.
Empacotar uma habilidade em um plug-in
O Work IQ Dev Tools fornece um fluxo de trabalho de código profissional para criar, validar, provisionar, empacotar e compartilhar um plug-in baseado em habilidades.
Siga os pré-requisitos de instalação e autenticação do WIQD em Criar um plug-in.
Crie um projeto de plug-in e adicione uma habilidade:
wiqd plugin create --name release-notes-plugin Set-Location release-notes-plugin wiqd plugin add skill --name "Release Notes"Edite o gerado
appPackage/skills/release-notes/SKILL.mde adicione quaisquer recursos ou scripts referenciados, seguindo as orientações nas Diretrizes de design.Siga o fluxo de trabalho WIQD para provisionar o ambiente pretendido, empacotar o plug-in e validar o ZIP real criado. A validação de origem por si só não inspeciona o conteúdo da habilidade nem comprova o comportamento do tempo de execução.
Publique ou compartilhe o plug-in e disponibilize-o para os usuários pretendidos.
Observação
O manifesto do aplicativo Microsoft 365 registra habilidades no nível do plug-in por meio agentSkillsdo Um agente declarativo faz referência às suas habilidades agent_skills com escopo de agente no manifesto do agente declarativo. Não troque essas propriedades ou presuma que declarar uma habilidade em uma superfície a registra na outra.
Para regras de formato, detalhes do manifesto e restrições específicas do host, consulte a referência de criação do plug-in WIQD. Uma habilidade destinada ao chat e ao cowork deve atender aos requisitos de ambos os anfitriões.
Descoberta e invocação de teste
Teste a habilidade instalada em cada experiência do Microsoft 365 que você pretende dar suporte:
- Confirme se um usuário pretendido pode localizar e selecionar a habilidade.
- Selecione explicitamente a habilidade, forneça informações representativas e verifique sua saída e arquivos de suporte.
- Habilite a invocação automática e use uma solicitação que corresponda à descrição da habilidade. Confirme se o Copilot seleciona a habilidade pretendida.
- Desative a invocação automática e confirme se a habilidade não é selecionada automaticamente. A seleção explícita é um caso de uso separado.
- Teste entradas ausentes, solicitações ambíguas, ferramentas indisponíveis e falhas de script. Certifique-se de que a resposta identifique o problema em vez de retornar silenciosamente um resultado incompleto.
- Se o plug-in incluir outros recursos, teste-os juntos. Confirme se o conector pretendido ou a ferramenta MCP é realmente invocado.
- Se você der suporte ao Chat e ao Cowork, verifique a descoberta, a instalação e a execução em ambos. Não deduza a disponibilidade ou o suporte à edição em um produto a partir de um teste bem-sucedido no outro.
A publicação, a implantação, o compartilhamento e a instalação são etapas distintas. Verifique a experiência instalada para o público-alvo em vez de tratar um upload de pacote bem-sucedido como prova de que a habilidade é detectável.