Competências em agentes declarativos

Este artigo aborda as habilidades ligadas a um agente declarativo. Para criar uma habilidade para uso direto no Microsoft 365 Copilot Chat sem criar um agente, consulte Criar habilidades para o Copilot Chat. A matriz de suporte neste artigo se aplica às habilidades com escopo do agente, não a todas as habilidades ou pacotes de plug-ins.

Importante

Em locatários que usam IBs (Barreiras de Informações do Microsoft Purview), os administradores podem implantar agentes declarativos com habilidades, mas os usuários finais não podem adicionar habilidades aos agentes declarativos criados por eles.

Uma habilidade é um recurso modular que você adiciona a um agente declarativo para ajudá-lo a realizar uma tarefa específica de forma mais confiável e repetitiva. Uma habilidade é um diretório de arquivos que contém um arquivo necessário SKILL.md , além de arquivos de recursos opcionais e scripts. O SKILL.md arquivo contém as instruções que direcionam o modelo para concluir a tarefa.

As habilidades são um componente distinto de um agente declarativo. Nas orientações anteriores, a palavra habilidades se referia às descrições de tarefas que você escrevia embutidas nas instruções de um agente. As habilidades substituem essa abordagem: em vez de escrever detalhes da tarefa diretamente nas instruções, você a empacota como um componente separado que o agente faz referência. Para obter orientação sobre como as instruções devem fazer referência às habilidades, consulte Escreva instruções eficazes para agentes declarativos.

Você pode adicionar habilidades a um agente declarativo usando o Agent Builder ou o Microsoft 365 Agents Toolkit.

O que é uma habilidade

Uma habilidade é um diretório com o seguinte conteúdo:

  • Um arquivo necessário SKILL.md que contém:
    • O nome e a descrição da habilidade na matéria frontal YAML.
    • Instruções de habilidade, que devem ter menos de 20.000 caracteres.
  • Arquivos de recursos opcionais, como modelos, dados de referência ou definições.
  • Scripts opcionais e pastas de suporte.

Por exemplo, uma equipe financeira pode criar uma habilidade de revisão de negócios trimestral que agrupa as instruções para produzir a revisão, scripts que transformam dados e geram gráficos e ativos como modelos financeiros, definições de KPI e modelos de slide com marca. O agente usa a habilidade quando um usuário solicita essa tarefa.

Por que usar habilidades em agentes declarativos

As habilidades ajudam você a criar fluxos de trabalho de agentes mais confiáveis e repetíveis:

  • Uso otimizado do contexto e precisão aprimorada. As habilidades usam divulgação progressiva: o modelo carrega as instruções e o conteúdo de uma habilidade no contexto somente quando a tarefa os exige. O contexto do agente permanece focado mesmo quando sua biblioteca de habilidades cresce. Fornecer scripts, em vez de depender de código gerado por modelo, também traz mais repetibilidade aos seus fluxos de trabalho.
  • Instruções de escala sem perda de qualidade. Você pode decompor instruções complexas em habilidades modulares e reutilizáveis. Essa abordagem permite que você forneça orientações mais longas e específicas sem degradar a qualidade das instruções e sem atingir o limite de 8.000 caracteres em instruções de agente declarativo.
  • Empacotar ativos reutilizáveis. Você pode empacotar instruções, recursos e scripts juntos como uma habilidade e integrar esse recurso ao seu agente declarativo.
  • Pronto para empresas. Os scripts são executados em uma área restrita segura, os rótulos de confidencialidade nos arquivos de habilidade são retidos e respeitados e a governança de administrador está disponível.

Matriz de suporte

Alguns limites diferem dependendo se você adiciona a habilidade com o Agent Builder ou o Agents Toolkit.

Item Construtor de Agentes Kit de Ferramentas de Agentes
Máximo de habilidades por agente 8 8
Pacote de habilidades Compactado .zip, máximo de 50 MB Diretório de habilidades; .zip Não há suporte
Tamanho máximo do arquivo 25 MB por arquivo Sem limite de nível de habilidade; o pacote completo do aplicativo é limitado a 10 MB
Máximo de arquivos por pacote 350 arquivos em todas as habilidades 350 arquivos em todas as habilidades
Criar uma habilidade com base em uploads individuais Sem suporte; Carregue o arquivo completo .zip Adicionar ou importar o diretório de habilidades completo
Hierarquia de diretório A profundidade máxima do diretório é 3 A profundidade máxima do diretório é 3
Reutilização entre agentes Sem suporte Sem suporte

Tipos de arquivo e script compatíveis

Uma habilidade pode incluir os seguintes tipos de arquivo:

Categoria Tipos de arquivos
Instruções e arquivos de recursos .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
Scripts e binários .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

Área restrita de execução de script

Os scripts de habilidade são executados em uma área restrita segura com os seguintes limites:

Recursos Suporte
Acesso à Internet ou rede a partir de scripts Sem suporte. A área restrita não tem acesso à rede em tempo de execução.
Instalação do pacote Sem suporte. Uma habilidade não pode instalar pacotes em tempo de execução.
Chamadas de rede autenticadas a partir de scripts Sem suporte.
Pacotes pré-instalados Uma habilidade pode usar pacotes já presentes na área restrita. Não dependa de um pacote, a menos que sua disponibilidade seja confirmada.
Conectores, plug-ins de API e servidores MCP O agente pode usar recursos habilitados por meio do orquestrador. Os scripts não podem chamá-los por meio da área restrita.

Confidencialidade e armazenamento

Item Suporte
Rótulos de confidencialidade A área restrita retém rótulos de confidencialidade e respeita as políticas de rótulos. Ele não dá suporte a permissões definidas pelo usuário ou criptografia de chave dupla.
Armazenamento O sistema armazena arquivos de habilidade carregados em contêineres do SharePoint Embedded no escopo do locatário.