Adicionar ferramentas a agentes personalizados

As ferramentas são blocos de construção que permitem ao seu agente interagir com sistemas externos. As ferramentas expandem o que o seu agente pode fazer, permitindo-lhe realizar várias ações em resposta a pedidos dos utilizadores ou a gatilhos autónomos. Cada ferramenta representa um recurso específico que seu agente pode executar. Por exemplo, pode equipar o seu agente com ferramentas que realizam tarefas 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 a agentes

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. Também pode chamar ferramentas explicitamente a partir de dentro de um tema.

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: Ligue-se a APIs e serviços proprietários utilizando Conectores do Power Platform para solicitar dados ou realizar ações.
- 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. O conector precisa de permissões de visualização e partilha para a organização para que o agente utilize o conector.
Fluxo de agente: defina um fluxo de agente, incluindo uma ou mais ações a realizar.
Pedido: pedido baseado num modelo de turno único que pode fazer referência ao conhecimento fornecido e gerar código para analisar dados.
API REST: defina uma ligação a uma API REST e selecione um ou mais pontos finais e métodos da API para adicionar como ferramentas.
Protocolo de Contexto de Modelos: ligue-se a um servidor MCP para aceder a ferramentas e recursos.
Utilização do computador: permite que o seu agente interaja com qualquer sistema que tenha uma interface gráfica, para sites e aplicações de computador, selecionando botões, escolhendo menus e introduzindo texto em campos no ecrã.

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:
- Pronta
- Fluxo do agente
- Utilização do computador
- Conector personalizado
- Protocolo de contexto do modelo
- API REST
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
Selecione Guardar ou Publicar, conforme aplicável, para criar a nova ferramenta.
Selecione Adicionar e configurar. A ferramenta é adicionada ao seu agente. A página de configuração da sua ferramenta é apresentada. Pode ver e fazer alterações à configuração da sua ferramenta aqui.

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 de configuração da sua ferramenta é aberta. Os detalhes são apresentados em três secções:

Detalhes
Insumos
Completion

Para servidores MCP ligados como ferramentas de agente, a página de configuração é diferente dos outros tipos de ferramentas. A secção Detalhes é semelhante, mas em vez de Entradas e Conclusão, existem secções Ferramentas e Recursos com informações sobre as ferramentas e os recursos disponíveis para o servidor MCP. Para obter mais informações, consulte Ver ferramentas e recursos num servidor MCP existente.

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 quer utilizar as credenciais do utilizador (Utilizador final) ou do criador (fornecidas pelo criador) para a ferramenta. Por padrão, a autenticação do usuário se aplica.
- Descrição: opcionalmente, pode adicionar uma descrição da ferramenta que o agente mostra ao utilizador quando pretende executar a ferramenta. 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.

Completion

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. Esta informação permite ao agente identificar quando deve utilizar a ferramenta. A descrição da ferramenta também ajuda o orquestrador a utilizar IA generativa para gerar perguntas, conforme necessário, para recolher entradas. O agente pode utilizar perguntas para recolher informações que preencham as entradas necessárias para utilizar 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. O orquestrador de agentes trata da recolha de entradas por si em runtime.

O agente considera 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

Ao usar o modo generativo, por defeito, as ferramentas devolvem a sua informação ao agente. Com a resposta da ferramenta, o agente pode gerar uma resposta contextual à consulta do utilizador. Como alternativa, você pode instruir sua ferramenta a sempre responder imediatamente, gerando uma mensagem ou criando uma mensagem explícita.

Sugestão

Quando utilizar perguntas geradas por uma ferramenta, informe os utilizadores de que a IA gerou parte da conversação.

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 teu caso de uso, podes usar a tua ferramenta como parte de um tópico mais amplo, que utiliza múltiplos nós. Ou, como no exemplo que se segue, adicionar um nó de uma única ação (ferramenta) a um tópico pode ser tudo o que precisas.

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 dê-lhe um nome, por exemplo, Obter tempo.
Adicione Expressões acionadoras adequadas. Para continuar com o mesmo exemplo meteorológico do passo anterior, as expressões acionadoras podem incluir:
- 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
- Connector
- Tool
O seu nó de Ação foi agora adicionado ao seu tópico.
Selecione Guardar.

Informações do conector MCP

Para o conector MCP, você pode exibir os nomes e descrições das ferramentas e recursos MCP disponibilizados pelo conector MCP. As informações para as ferramentas e recursos são exibidas em uma tabela, uma linha para cada ferramenta.

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:

Credenciais do utilizador final: o agente utiliza as credenciais do utilizador para se autenticar no serviço. Esse método garante que os usuários acessem apenas os dados que estão autorizados a ver.
Credenciais fornecidas pelo criador: o agente utiliza as credenciais do seu autor para se autenticar no 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.

Ativar ou desativar uma ferramenta no agente

Pode ativar ou desativar uma ferramenta para o seu agente a partir da página de configuração da ferramenta. Desativar uma ferramenta bloqueia o agente de a utilizar, mas a ferramenta ainda está ligada ao agente e pode ser ativada novamente mais tarde. Quando adicionas uma ferramenta a um agente, a ferramenta é ativada por defeito.

Para desativar uma ferramenta num agente:

Aceda ao seu agente e selecione a página Ferramentas do seu agente.
Selecione a ferramenta para aceder à página de configuração da ferramenta.
No topo da página de configuração, desative a ferramenta utilizando o seletor Ativado.
Selecione Salvar para aplicar a alteração.

A ferramenta continua a aparecer na lista de ferramentas do agente, mas já não está ativada.

Eliminar uma ferramenta do seu agente

Desativar uma ferramenta bloqueia a sua utilização, mas também lhe dá a flexibilidade de voltar a ativá-la mais tarde. Também pode remover uma ferramenta de forma mais permanente do seu agente. Para eliminar uma ferramenta do seu agente:

Aceda ao seu agente e selecione a página Ferramentas do seu agente.
Encontre a ferramenta na lista de ferramentas e faça pairar o cursor sobre o nome da ferramenta. Selecione os três pontos (...).
Selecione Eliminar. Será apresentada uma janela de confirmação.
Selecione Eliminar para remover a ferramenta.

A ferramenta desaparece da lista de ferramentas do agente.

Observação

Só pode eliminar ferramentas da página de ferramentas do agente. Não pode eliminar ferramentas da página principal Ferramentas do Copilot Studio.

Limitações das ferramentas nos agentes

Ao usar orquestração generativa, o orquestrador pode gerir um máximo de 128 ferramentas por agente. Para melhor desempenho e resultados, no entanto, recomendamos limitar o número de ferramentas do seu agente a não mais do que 25-30.
Ao utilizar orquestração multi-agente com agentes filhos, os agentes filhos têm a sua própria orquestração e podem gerir o seu próprio conjunto de até 128 ferramentas.

Feedback

Esta página foi útil?

Last updated on 2026-01-29