Adicionar ferramentas a agentes personalizados

2025-06-17

As ferramentas são os blocos de construção que permitem que seu agente interaja com sistemas externos. As ferramentas expandem a funcionalidade do seu agente, permitindo que ele execute várias ações em resposta a solicitações do usuário ou gatilhos autônomos. Cada ferramenta representa um recurso específico que seu agente pode executar. Por exemplo, você pode equipar seu agente com ferramentas que fazem coisas como:

Enviar emails usando o conector do Office 365 Outlook
Verifique as condições e previsões meteorológicas atuais
Ler e gravar dados do Dataverse
Ler e publicar mensagens no Teams

Mecanismos para adicionar ferramentas

Você pode estender os recursos do seu agente personalizado adicionando uma ou mais ferramentas. Seu agente pode usar ferramentas para responder aos usuários automaticamente, usando orquestração generativa. Você também pode chamar ferramentas explicitamente de dentro de um tópico.

Com a orquestração generativa (ativa por padrão), seu agente pode selecionar automaticamente a ferramenta ou tópico mais apropriado, ou pesquisar conhecimento, para responder a um usuário. Este modo de orquestração cria uma experiência de conversação mais dinâmica e inteligente.

No modo clássico (orquestração generativa desativada), um agente só pode usar tópicos para responder ao usuário. No entanto, ainda pode estruturar o seu agente para chamar ferramentas explicitamente a partir de tópicos.

Existem vários mecanismos disponíveis para adicionar ferramentas ao seu agente:

Conector pré-criado: escolha entre uma seleção de ligações predefinidas para milhares de APIs populares de serviços da Microsoft e não Microsoft.
Conector personalizado: defina uma conexão com um serviço ou sistema personalizado para habilitar opções de ferramentas personalizadas usando conectores de plataforma de energia.
Fluxo do agente: defina um fluxo do agente, incluindo uma ou mais ações a serem executadas.
Pedido: pedido baseado em modelo de turno único que pode fazer referência ao conhecimento fornecido.
Conexão de API REST: defina uma conexão com uma API REST e selecione um ou mais pontos de extremidade e métodos de API para adicionar como ferramentas.
Ferramenta MCP (Model Context Protocol): conecte-se a um servidor MCP para acessar ferramentas.
Agente de uso do computador (visualização): Permite que o agente interaja com qualquer sistema que tenha uma interface gráfica do usuário, para sites e aplicativos de desktop, selecionando botões, escolhendo menus e inserindo texto em campos na tela.

Quando falamos de ferramentas neste artigo e nesta seção da documentação, nos referimos a um dos mecanismos desse grupo. Esses tipos de ferramentas podem ser adicionados ao seu agente e configurados de maneiras semelhantes.

Há dois outros mecanismos que você pode usar para adicionar comportamento semelhante a uma ferramenta ao seu agente:

Competências: Contentor para um conjunto de ferramentas relacionadas.
Ferramenta do cliente: Envie uma atividade de evento para o cliente para que o cliente execute uma ação e retorne uma resposta.

Para obter mais informações sobre habilidades e ferramentas de cliente, consulte os links na seção Conteúdo relacionado .

Criar e adicionar uma nova ferramenta no nível do agente

A criação de novas ferramentas diretamente no Copilot Studio simplifica o processo de desenvolvimento e garante a integração adequada com seu agente. As ferramentas adicionadas a um agente estão disponíveis para orquestração automática ao longo das conversações do seu agente.

Abra seu agente escolhendo Agentes no painel de navegação esquerdo e selecionando seu agente na lista.
Vá para a página Ferramentas do agente.
Selecione Adicionar uma ferramenta.
No painel Adicionar ferramentas , selecione Nova ferramenta.
Selecione o tipo de ferramenta que deseja adicionar na lista exibida:
- Prompt: Crie ferramentas de geração e análise de texto alimentadas por IA
- Fluxo de agentes: crie processos de várias etapas com lógica condicional
- Uso do computador: habilite a automação GUI para sistemas legados
- Conector personalizado: Conecte-se a APIs e serviços proprietários
- API REST: Integração direta com serviços Web
Execute as etapas de configuração específicas para o tipo de ferramenta selecionada. Por exemplo, se você selecionar Prompt, deverá executar as seguintes etapas:
- Definir o modelo de prompt e as instruções
- Especificar parâmetros de entrada
- Configurar origens de conhecimento
- Definir formato de resposta e restrições
Teste a configuração da ferramenta usando o painel de visualização para garantir que ela funcione conforme o esperado.
Selecione Salvar para criar a nova ferramenta.
Selecione Adicionar ao agente para adicionar a ferramenta ao seu agente. Você pode ver a nova ferramenta na página Ferramentas do agente.

Visualize e faça alterações na configuração da ferramenta

Você pode visualizar e editar a configuração da sua ferramenta a qualquer momento: vá para a página Ferramentas do seu agente e selecione a ferramenta na lista de ferramentas.

A página Detalhes da ferramenta é aberta, mostrando a configuração da ferramenta. Os detalhes são apresentados em três secções:

Detalhes
Insumos
Conclusão (Ferramentas para conectores MCP)

Detalhes

A seção Detalhes permite configurar detalhes básicos sobre sua ferramenta.

Aqui, você pode visualizar e atualizar:

Nome: O nome da ferramenta. Esse nome aparece na lista de ferramentas para seu agente. Escolha um nome que indique claramente a função da ferramenta.
Descrição: uma descrição da ferramenta. A orquestração generativa depende dessa descrição para determinar quando seu agente deve usar a ferramenta. Escreva descrições claras e específicas, incluindo o que a ferramenta faz e quando deve ser usada.
Detalhes adicionais:
- Permitir que o agente decida dinamicamente quando usar a ferramenta: Quando essa opção é selecionada, o agente pode usar a orquestração generativa para determinar quando usar a ferramenta. Se essa opção não estiver selecionada, o agente só usará a ferramenta quando ela for explicitamente chamada a partir de um tópico. (Por padrão, essa opção é selecionada quando a orquestração generativa está habilitada.)
- Pergunte ao usuário final antes de executar: na experiência de bate-papo do usuário final, peça confirmação ao agente antes de executar a ferramenta. Esta opção é definida como Não por padrão.
- Autenticação: selecione se deseja usar as credenciais do usuário ou do fabricante para a ferramenta. Por padrão, a autenticação do usuário se aplica.
- Descrição: Opcionalmente, você pode adicionar uma descrição da ferramenta que é mostrada ao usuário quando a ferramenta é executada. Esta descrição informa o utilizador sobre o que está a ser solicitado para autenticar.

Insumos

Aqui, você pode visualizar e configurar as entradas para sua ferramenta. As entradas são usadas para coletar informações do usuário para preencher as entradas necessárias para a ferramenta. As informações são exibidas como uma tabela, uma linha para cada entrada.

Por padrão, o valor da coluna Preencher usando para cada entrada é definido como Preencher dinamicamente com IA. O agente tenta extrair o valor do contexto disponível — por exemplo, da mensagem do usuário. Se nenhum valor apropriado for encontrado, ele gerará uma pergunta para solicitar ao usuário um valor. Selecione Personalizar para acessar personalizações mais refinadas para coleta e preenchimento de entradas:

Nome para exibição e Descrição: Como a entrada aparece para o usuário.
Identificar como: Como a resposta do usuário é interpretada, por exemplo, como cadeia de texto ou mapeada para uma entidade predefinida.
Lógica de repetição: se o agente não identificar uma entidade na instrução do usuário, ele poderá fazer a pergunta novamente.
Validação de entrada: configure um comportamento de validação extra na entrada do usuário além do padrão para o tipo de entidade.

Você também pode optar por substituir uma entrada por um valor explícito em vez de permitir que o agente a extraia. Para definir uma substituição, defina Preencher utilizando como Valor personalizado e introduza um valor, selecione uma variável ou use uma fórmula Power Fx. Se uma entrada for substituída, o agente não solicitará um valor ao usuário.

Conclusão

Aqui, você pode selecionar o que deseja que aconteça quando a ferramenta terminar de ser executada.

Você pode fazer com que o agente gere automaticamente uma resposta contextual para um usuário, com base em sua consulta e no resultado da ferramenta.

Como alternativa, você pode optar por criar uma resposta específica e formatada para que sua ferramenta retorne. Você pode inserir referências a variáveis de saída da ferramenta usando o seletor de variáveis. Você também pode usar fórmulas Power Fx para formatar a resposta.

Em Após a execução, selecione uma das algumas opções diferentes de como a ferramenta deve responder ao usuário após a execução da ferramenta:

Não responder (padrão): o agente incorpora a saída da ferramenta em sua resposta
Escreva a resposta com IA generativa: Deixe a IA criar uma resposta contextual usando as saídas da ferramenta
Enviar resposta específica: Crie um modelo de resposta com inserção variável
Enviar um cartão adaptável: crie respostas ricas e interativas com botões e ações

Você também pode configurar quais variáveis de saída disponibilizar para o agente e outras ferramentas.

Seleção de ferramentas e coleta de entrada

Ao definir uma ferramenta no Copilot Studio, você também fornece informações que descrevem sua finalidade. Essas informações permitem que o agente identifique quando usar a ferramenta e também usar IA generativa para gerar perguntas. Essas perguntas são usadas para reunir informações para preencher as entradas necessárias para executar a ferramenta. Como resultado, não precisa de criar manualmente nós de questões para reunir todas as entradas necessárias, como entradas num fluxo. A recolha de entradas é processada por si em runtime.

O agente usa vários fatores para determinar a seleção da ferramenta:

Nome e descrição da ferramenta
O contexto atual da conversa
Intenção do usuário derivada de sua mensagem
Entradas e saídas disponíveis
Uso anterior da ferramenta na conversa

Por padrão, ao usar o modo generativo, as ferramentas retornam suas informações de volta ao agente, para que o agente possa gerar uma resposta contextual à consulta do usuário. Como alternativa, você pode instruir sua ferramenta a sempre responder imediatamente, gerando uma mensagem ou criando uma mensagem explícita.

Sugestão

Ao usar perguntas geradas por uma ferramenta, informe aos usuários que parte da conversa é gerada pela IA.

Por exemplo, adicione uma mensagem extra no tópico Sistema de início de conversa . Este tópico determina a mensagem mostrada aos usuários quando uma nova conversa é iniciada.

Chamar uma ferramenta existente de dentro de um tópico

Você pode chamar uma ferramenta explicitamente de dentro de um tópico. Dependendo do seu caso de uso, você pode usar sua ferramenta como parte de um tópico mais amplo, que usa mais nós. Ou, como no exemplo da meteorologia, adicionar um nó a um tópico pode ser tudo o que necessita.

Para chamar uma ferramenta de dentro de um tópico:

No Copilot Studio, vá para a página Tópicos do agente que você deseja editar.
Crie um novo tópico e nomeie-o Get weather.
Adicione as seguintes frases de gatilho:
- vai chover
- Previsões de hoje
- Obter Meteorologia
- Qual é o tempo
Selecione Adicionar nó (+) e, em seguida, selecione Adicionar uma ferramenta. Selecione a ferramenta entre as ferramentas disponíveis. Existem três abas que mostram diferentes tipos de ferramentas.
- Ferramentas básicas
- Conector
- Ferramenta
O seu nó de Ação foi agora adicionado ao seu tópico.
Selecione Guardar.

Ferramentas (somente conectores MCP)

Em Ferramentas, você pode exibir os nomes e descrições das ferramentas disponíveis para o conector MCP. As ferramentas são exibidas em uma tabela, uma linha para cada ferramenta. Para cada ferramenta, você pode ver:

Nome e versão da ferramenta
Parâmetros de entrada e saída
Tempo de execução estimado
Estatísticas de utilização

Considerações de autenticação para ferramentas

Algumas ferramentas exigem autenticação para funcionar corretamente, como o Pedido Dinâmico ou outras que chamam uma API do Dataverse. A configuração de autenticação adequada garante a segurança, mantendo uma experiência de usuário suave.

As ferramentas são sempre executadas no tempo de execução do agente no contexto do usuário e não podem ser executadas a menos que a autenticação esteja habilitada. Há suporte para dois tipos de métodos de autenticação:

Autenticação do usuário: o agente usa as credenciais do usuário para autenticar com o serviço. Esse método garante que os usuários acessem apenas os dados que estão autorizados a ver.
Autenticação do autor do Copilot: o agente usa as credenciais do seu autor para efetuar a autenticação com o serviço. Use este modo de autenticação para recursos compartilhados ou quando os usuários não precisarem de acesso individual.

Teste a sua ferramenta

Com a orquestração generativa, o orquestrador seleciona sua ferramenta quando a considera relevante para uma consulta do usuário.

Como alternativa, você pode chamar uma ferramenta existente de dentro de um tópico.

Partilhar via