Adicionar uma ferramenta a um agente

Você pode adicionar ferramentas ao seu agente pela aba Build . As ferramentas permitem que seu agente realize ações, conecte-se a serviços externos e recupere dados em tempo real durante as conversas.

Note

Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

Pré-requisitos

  • Um agente criado com a estrutura do GitHub Copilot. Consulte Criar um agente.

Adicionar uma ferramenta existente na aba Build

  1. Faça login no Copilot Studio e abra seu agente.

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

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

  4. No diálogo Adicionar uma ferramenta , navegue ou pesquise pela ferramenta que deseja adicionar. Use as abas Em destaque, Model Context Protocol (MCP), Conectores ou Fluxos de trabalho para filtrar por tipo de ferramenta.

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

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

Configure uma ferramenta depois de adicioná-la

Depois de adicionar uma ferramenta, talvez você precise:

  • Autenticar: Algumas ferramentas exigem que você faça login ou forneça credenciais antes de serem usadas. Siga as solicitações de autenticação quando aparecerem.
  • Selecione ações: Para conectores que oferecem múltiplas ações, você pode selecionar quais ações específicas disponibilizar ao seu agente.
  • Revise a descrição: Certifique-se de que a descrição da ferramenta reflita 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 você precisa não estiver disponível no navegador, você pode adicionar uma ferramenta personalizada. Atualmente, os agentes alimentados pela estrutura do GitHub Copilot permitem adicionar as seguintes ferramentas personalizadas:

  • Ferramentas MCP de um servidor Model Context Protocol (MCP) existente. Isso permite que você se conecte a serviços personalizados, bancos de dados ou APIs que expõem capacidades como ferramentas por meio do padrão MCP.
  • Fluxos de trabalho que você cria no designer de fluxo do Copilot Studio. Isso permite definir processos em múltiplas etapas que seu agente pode executar sob demanda.

Dicas para descrições eficazes de ferramentas

Dica

O nome e a descrição da ferramenta são fundamentais para uma invocação precisa da ferramenta. O runtime de orquestração aprimorada usa esses elementos para decidir quando invocar uma ferramenta, então:

  • Use nomes claros e específicos que descrevam a ferramenta (por exemplo, "Criar chamado 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