Adicionar habilidades ao seu agente declarativo no Agent Builder

Uma habilidade é um componente modular e reutilizável que você adiciona a um agente declarativo para ajudá-lo a executar uma tarefa empacotada específica. Uma habilidade é um diretório que contém um arquivo necessário SKILL.md com instruções, além de arquivos de recursos opcionais e scripts. Este artigo descreve como adicionar uma habilidade a um agente criado no Agent Builder, descrevendo a habilidade em linguagem natural ou carregando um pacote de habilidades.

Para saber quais são habilidades, por que usá-las e a matriz de suporte completa, tipos de arquivo com suporte, comportamento de área restrita e governança, consulte Habilidades em agentes declarativos.

Para uma habilidade pessoal usada diretamente no Copilot Chat sem um agente, consulte Desenvolver habilidades para o Copilot Chat. As etapas e os limites de upload neste artigo se aplicam ao Agent Builder, não a uploads de Chat pessoal.

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.

Pré-requisitos

  • Uma assinatura qualificada do Microsoft 365 que fornece acesso ao Microsoft 365 Copilot Chat. Não é necessária uma licença complementar do Microsoft 365 Copilot. Algumas funcionalidades do agente exigem uma licença do Microsoft 365 Copilot ou pagamento conforme o uso. Para obter detalhes, consulte Recursos do agente e modelos de licenciamento.

Observação

No Agent Builder, você pode adicionar até oito habilidades por agente, e cada pacote de habilidades é um arquivo compactado .zip de até 50 MB. Para obter a matriz de suporte completa e os limites, consulte Habilidades em agentes declarativos.

Criar uma habilidade a partir de uma descrição

Você pode pedir ao Agent Builder para criar uma habilidade reutilizável a partir de uma descrição em linguagem natural.

  1. No Copilot Chat, selecione Agentes & Habilidades e, em seguida, selecione Novo agente.

  2. Selecione a caixa de texto Message Agent Builder e peça ao Agent Builder para criar um fluxo de trabalho reutilizável.

    Create an agent that helps my team write release notes. Add a reusable skill that always follows the same steps:
    
    1. Takes a list of merged changes (a pasted list or an uploaded  .csv  of PR titles).
    2. Groups them into Features, Fixes, and Other.
    3. Runs a script to format them into a clean Markdown changelog with a version heading and today's date.
    
    Package this as a skill with clear instructions and the formatting script so the output looks the same every time.
    

    Uma captura de tela do prompt do Agent Builder para criar um agente

  3. Na guia Configurar , confirme se uma habilidade foi criada.

    Uma captura de tela da guia Configurar no Agent Builder mostrando uma habilidade anexada

  4. Selecione a habilidade para examinar seus detalhes.

    Uma captura de tela dos detalhes da habilidade recém-adicionada

Se a habilidade não for adicionada, você poderá adicionar habilidades explicitamente carregando um pacote de habilidades.

Carregar um pacote de habilidades

Para adicionar um pacote de habilidades, primeiro crie o pacote e, em seguida, carregue-o no Agent Builder.

Criar seu pacote de habilidades

Antes de adicionar uma habilidade no Agent Builder, empacote a habilidade como um .zip arquivo que contenha:

  • Um arquivo necessário SKILL.md .
  • O nome e a descrição da habilidade na matéria frontal YAML SKILL.md .
  • Arquivos de recursos opcionais com suporte.
  • Scripts opcionais com suporte e pastas de suporte.
  • Instruções de habilidade com menos de 20.000 caracteres.

O pacote é semelhante à seguinte estrutura de diretórios:

my-skill.zip
|-- SKILL.md              # required
|-- <resource files>      # optional
`-- <scripts or folders>  # optional

Para os tipos de arquivo e script com suporte, consulte Tipos de arquivo e script com suporte.

Importante

Carregue o pacote completo .zip . Não carregue SKILL.md sozinho.

Carregue seu pacote de habilidades

  1. Abra ou crie um agente declarativo no Agent Builder.

  2. Na guia Configurar , expanda Habilidades e selecione Adicionar.

    Uma captura de tela do botão Adicionar na seção Habilidades do painel Configuração do Agent Builder

  3. Carregue o pacote completo .zip de habilidades.

  4. Revise o nome da habilidade, a descrição, as instruções e os arquivos incluídos.

  5. Na guia Experimentar, experimente um prompt que deve usar a habilidade.