Usar ferramentas compartilhadas na página Ferramentas

A página Ferramentas fornece um local centralizado para os criadores criarem e gerenciarem funcionalidades que podem ser usadas entre agentes em um ambiente. Você pode criar, gerenciar e usar ferramentas em vários agentes em um ambiente, tornando as ferramentas em componentes versáteis e reutilizáveis.

Note

A página Ferramentas substitui a página biblioteca anterior.

Você pode acessar a página Tools no Microsoft Copilot Studio selecionando Tools na navegação à esquerda.

Quando você vai à página de Ferramentas , vê uma lista de ferramentas que já foram adicionadas. Se nenhuma ferramenta for adicionada ainda, você poderá adicionar uma nova ferramenta selecionando Nova ferramenta. Cada entrada na lista de ferramentas contém informações básicas sobre a ferramenta, incluindo nome, tipo, criador, status e agentes onde a ferramenta foi adicionada.

Página de detalhes da ferramenta

Selecione a entrada de nome de uma das ferramentas na lista para ver uma página de detalhes da ferramenta específica. Na página de detalhes, você pode:

  • Editar a ferramenta
  • Adicionar a ferramenta a um ou mais agentes
  • Exportar a ferramenta em uma solução

Você pode escolher um dos seletores acima da lista para filtrar por tipo de item (agente, conector, conector personalizado, prompt). Você também pode pesquisar itens por nome.

Criar uma nova ferramenta

Para criar uma nova ferramenta e adicioná-la à página Ferramentas :

  1. Selecione Nova ferramenta. São apresentadas várias opções:

    • Prompt: Crie uma nova ferramenta de prompt usando o editor de prompts do construtor de prompts embutido.
    • Fluxos do agente: simplifique seus processos de negócios e automatize tarefas repetitivas. Preconfigurado para começar com um gatilho do agente e terminar com uma resposta de volta ao seu agente.
    • Conectores personalizados: conectores externos de ponte que não têm conectores predefinidos. Integre APIs REST ou SOAP a plataformas como Aplicativos Lógicos, Power Automate, Power Apps ou Copilot Studio.
    • APIs REST: oferecer uma experiência guiada para carregar arquivos Swagger para criar ferramentas de API REST. Essas ferramentas são utilizadas para conectar agentes com fontes de dados externas ou serviços não cobertos por conectores pré-construídos.
    • Uso do computador: habilite os agentes para automatizar tarefas em aplicativos e sites clicando, digitando e navegando na interface. O uso de computador é ideal para cenários como entrada de dados, atualização de registros em um portal da Web ou recuperação de informações de sistemas sem APIs.
    • Protocolo de Contexto de Modelo: conecte agentes com servidores de conhecimento e fontes de dados existentes para melhorar o uso de dados estruturados e não estruturados no Copilot Studio.
  2. Selecione uma das opções. Você prossiga para o fluxo de criação da ferramenta. Para algumas ferramentas, a criação ocorre dentro do contexto da página de Ferramentas , enquanto para outras, você é redirecionado para outro ponto de entrada para a criação.

Uma vez criada uma ferramenta, ela aparece na página de Ferramentas . Todas as ferramentas dentro do ambiente selecionado estão listadas aqui, caso você seja o fabricante da ferramenta ou o fabricante tenha compartilhado a ferramenta com você.

Adicionar uma ferramenta a um agente

Você pode adicionar uma ferramenta a um agente na página Ferramentas .

Note

Quando você adiciona uma ferramenta a vários agentes, o componente de ferramenta subjacente (prompt, API REST, conector personalizado, fluxo de agente e assim por diante) permanece o mesmo. Copilot Studio usa um wrapper em torno da ferramenta. O wrapper permite especificar entradas/saídas específicas e configurações específicas para a implementação dessa ferramenta com o agente.

Selecionar ferramenta

  1. Selecione os três pontos (...) ao lado do nome da ferramenta que você quer adicionar.

  2. Selecione Adicionar ao agente.

As próximas etapas dependem do tipo de ferramenta.

Adicionar comando como uma ferramenta a um agente

Para os prompts, você é levado à página de detalhes da ferramenta, onde pode adicionar o prompt a um agente a partir da mesma página.

  1. Selecione Adicionar.

  2. Selecione um agente na lista de agentes.

  3. Selecione Adicionar.

Adicionar outros tipos de ferramenta a um agente

  1. Selecione o agente ao qual você deseja adicionar a ferramenta e selecione Adicionar.

    Você é redirecionado para o painel de Adicionar ferramenta para o agente selecionado adicionar a ferramenta.

  2. Selecione a ferramenta específica.

    Dependendo da ferramenta, pode ser solicitado que você selecione ou crie uma conexão para a ferramenta.

  3. Selecione Adicionar ao agente.

Comparação ferramentas versus biblioteca

A página de Ferramentas não cobre exatamente a mesma funcionalidade da página anterior da Biblioteca .

A lista a seguir indica onde encontrar informações anteriormente disponíveis na página da Biblioteca .

  • Copilot agentes: para criar agentes Copilot (também conhecidos como agentes declarativos) para Microsoft 365 Copilot, acesse a página Agents e selecione Microsoft 365 Copilot>Agents. Lá, você pode ver todos os seus agentes de Copilot existentes e também criar novos. Você também pode criar agentes diretamente no Microsoft 365 Copilot.
  • Conectores predefinidos do Power Platform: a página Ferramentas é um lugar onde você pode criar novas ferramentas do zero. Conectores predefinidos não se enquadram nessa categoria. Você pode exibir e adicionar conectores predefinidos de dentro do contexto de um agente.
  • Coleções de componentes: você pode exibir e criar coleções de dentro da página Configurações de um agente. Você também pode gerenciar coleções existentes na página Soluções .
  • Conectores personalizados: você pode criar conectores personalizados na página Ferramentas . Para conectores predefinidos, é possível visualizar e adicionar no contexto de um agente.
  • Fluxo: disponível na página Ferramentas .
  • Prompt: Disponível na página Ferramentas.
  • API REST: disponível na página Ferramentas .

Limitações conhecidas

Há alguns problemas conhecidos a serem considerados na página Ferramentas . Alguns desses problemas têm mitigações que você pode usar.

Problema Redução
Não é possível excluir uma ferramenta da página Ferramentas Se uma ferramenta for criada e adicionada a um agente, essa ferramenta poderá ser removida do agente ao acessar o agente.
Ferramentas de uso de computador não estão listadas na página inicial das Ferramentas Se uma ferramenta de uso de computador for criada e adicionada a um agente, ela está listada na aba Ferramentas desse agente.
Os prompts criados em Power Apps, Power Automate ou em um tópico não são visíveis no Copilot Studio. Crie um novo prompt em Ferramentas. Esse problema ocorre porque o artefato do prompt é encapsulado em um plugin antes de ser adicionado a um agente. Os prompts criados em Power Apps, Power Automate e dentro do contexto de um tópico não são encapsulados em plug-ins. Como resultado, esses prompts não aparecem como uma ferramenta disponível para adicionar na página *Ferramentas .
Quando você edita o título de uma ferramenta de prompt, o novo nome não aparece em Ferramentas. Edite o nome da ferramenta na aba Ferramentas do agente onde foi adicionada.
Quando você cria uma ferramenta de API REST, ela também cria um conector personalizado. Esse comportamento é por design.