Adicionar uma ferramenta a um agente

Pode adicionar ferramentas ao seu agente a partir do separador Criar. As ferramentas permitem que o seu agente realize ações, estabeleça ligação a serviços externos e obtenha dados em tempo real nas conversas.

Note

As funcionalidades deste artigo são utilizadas por agentes ou fluxos de trabalho suportados pela estrutura do GitHub Copilot.

A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot. Saiba mais em Gerir custos para agentes alimentados pelo harness GitHub Copilot.

Pré-requisitos

  • Um agente criado com a infraestrutura do GitHub Copilot. Veja Criar um agente.

Adicionar uma ferramenta existente a partir do separador Construir

  1. Inicie sessão no Copilot Studio e abra o seu agente.

  2. Na barra de navegação do agente, selecione o separador Build .

  3. No painel de componentes, selecione o botão Ferramentas .

  4. No diálogo Adicionar uma ferramenta , navegue ou procure a ferramenta que quer adicionar. Utilize os separadores Em destaque, Model Context Protocol (MCP), Conectores ou Fluxos de trabalho para filtrar por tipo de ferramenta.

  5. Selecione a ferramenta para visualizar os seus detalhes, incluindo uma descrição e as ações que fornece.

  6. Selecione Adicionar para adicionar a ferramenta ao seu agente.

Configure uma ferramenta depois de a adicionar

Depois de adicionar uma ferramenta, poderá precisar de:

  • Autenticar: Algumas ferramentas exigem que faça login ou forneça credenciais antes de poderem ser usadas. Siga as instruções de autenticação quando aparecerem.
  • Selecionar ações: Para conectores que fornecem múltiplas ações, pode selecionar que ações específicas disponibilizar ao seu agente.
  • Revise a descrição: Certifique-se de que a descrição da ferramenta reflete com precisão o que ela faz. O runtime de orquestração do agente usa a descrição para determinar quando invocar a ferramenta.

Adicionar uma nova ferramenta personalizada

Se a ferramenta que precisas não estiver disponível no navegador, podes adicionar uma ferramenta personalizada. Atualmente, os agentes alimentados pelo harness GitHub Copilot suportam adicionar as seguintes ferramentas personalizadas:

  • Ferramentas MCP a partir de um servidor existente do Model Context Protocol (MCP). Isto permite-lhe ligar-se a serviços personalizados, bases de dados ou APIs que expõem capacidades como ferramentas através do padrão MCP.
  • Fluxos de trabalho que cria no flow designer do Copilot Studio. Isto permite-lhe definir processos em vários passos que o seu agente pode executar a pedido.

Dicas para descrições eficazes de ferramentas

Sugestão

O nome e a descrição da ferramenta são fundamentais para uma invocação precisa da ferramenta. O runtime de orquestração melhorado usa estes para decidir quando invocar uma ferramenta, por isso:

  • Use nomes claros e específicos que descrevam a ferramenta (por exemplo, "Criar pedido de suporte" em vez de "Ferramenta de Ticket")
  • Escreva descrições que expliquem quando a ferramenta deve ser usada e o que ela retorna
  • Evite descrições vagas ou sobrepostas entre ferramentas
  • Last updated on