Adicionar um nó de agente a um fluxo de agente ou fluxo de trabalho

1. Em Copilot Studio, vá para Flows e abra um fluxo de trabalho existente ou crie um novo.

   • Novo fluxo de trabalho: você acessa o designer para configurar um gatilho.
   • Fluxo de trabalho existente: abra o fluxo de trabalho e vá para a guia Compilar .

2. Selecione o ícone do Agente no painel Adicionar. O painel de configuração é aberto para o nó do agente.

1. No Copilot Studio, vá para Flows e abra um fluxo de agente existente ou crie um novo.

   • Novo fluxo: você chega à página Designer para configurar um gatilho.
   • Fluxo existente: você chega à página Visão geral e precisa ir para a página Designer..

2. Selecione o ícone Inserir uma nova ação no ponto no fluxo em que você deseja chamar um agente.

3. Em Adicionar uma ação, em recursos de IA, selecione Executar um agente. Um nó Executar um agente é exibido no fluxo.

No editor de nós do agente, em Agent, selecione uma das duas opções:

• Um agente existente: selecione um agente publicado em uma lista. O agente é executado com as instruções, ferramentas e conhecimento com os quais já foi configurado.

• Novo agente para este fluxo de trabalho: crie um agente embutido com escopo para esse fluxo de trabalho. As instruções, as ferramentas, o conhecimento e a forma de saída do agente são configuradas no próprio nó e viajam com o fluxo de trabalho. Use essa opção quando o trabalho do agente for específico para essa automação e você não precisar compartilhá-la em outro lugar.

A próxima seção deste artigo se concentra na configuração de um novo agente embutido. Se você selecionar um agente existente, pule para Enviar uma mensagem ao agente.

No editor de execução e agente, em Agent, você pode selecionar uma das duas opções:

• Selecione um agente existente: selecione um agente publicado em uma lista. O agente é executado com todas as instruções, ferramentas e conhecimentos com os quais já foi configurado.

• Criar um novo agente: selecione Novo para criar um novo agente. Será aberta uma nova guia do navegador com a experiência do construtor de agentes. Crie e publique seu agente lá e retorne ao editor de fluxo para selecioná-lo na lista de agentes existentes.

A próxima seção deste artigo se concentra na configuração de um novo agente. Se você selecionar um agente existente, pule para Enviar uma mensagem ao agente.

Quando você escolhe Novo agente para esse fluxo de trabalho, o painel de configuração se expande para que você possa moldar o agente no local.

Instruções

Para um agente embutido, o campo Instruções é a descrição do trabalho do agente e o prompt de execução. Não há nenhum campo de mensagem separado. Escreva o que o agente deve fazer, em linguagem simples, e inclua conteúdo dinâmico de etapas anteriores para alimentá-lo com os dados dessa execução.

Seja específico sobre a tarefa, as entradas que o agente pode esperar e o formato da resposta desejada de volta. Instruções mais claras significam execuções mais confiáveis.

Por exemplo, se o gatilho de fluxo de trabalho for Quando um novo email chegar, suas instruções poderão ser lidas: Read the email below and decide whether it's a sales lead, a support request, or something else. Reply with a single word. seguida pelos tokens Assunto e Corpo do gatilho.

Para escolher o modelo que executa o agente, use a lista suspensa de modelos localizada no canto superior direito da caixa de instruções. Selecione um modelo mais capaz quando a tarefa envolve raciocínio de várias etapas ou interpretação cuidadosa. Selecione um modelo mais rápido quando a tarefa for simples e for executada em alto volume.

QI de trabalho

Ative Work IQ para permitir que o agente use a atividade de trabalho recente do usuário em execução, incluindo email, Teams, calendário, OneDrive e contexto SharePoint, para fundamentar suas respostas. Isso é útil quando o fluxo de trabalho está agindo em nome de uma pessoa e o contexto pessoal (threads recentes, reuniões futuras, documentos editados recentemente) melhora a resposta.

Tools

As ferramentas dão ao agente a capacidade de executar ações como enviar uma mensagem, consultar um registro, executar uma pesquisa ou chamar uma API. Sem ferramentas, o agente só pode ler e raciocinar. Com ferramentas, ele também pode agir.

Para anexar uma ferramenta:

1. Na seção Ferramentas , selecione o sinal de adição (+).

2. Em Adicionar ferramenta, procure ou pesquise a ferramenta desejada.

3. Selecione a ferramenta para adicioná-la. Você pode adicionar várias ferramentas a um único agente.

Você pode anexar dois tipos de ferramentas:

• Servidores MCP (Protocolo de Contexto de Modelo): servidores predefinidos que revelam um conjunto selecionado de capacidades.
• Conectores: qualquer ação de um conector do Power Platform.

O agente decide no tempo de execução qual de suas ferramentas anexadas chamar, em que ordem e com quais argumentos. Vocês não conectam ferramentas juntas. Isso é o que torna o nó do agente diferente de encadear ações de fluxo de trabalho individuais.

Conhecimento

O conhecimento fornece ao agente algo para ler. Quando você faz uma pergunta ao agente, ele pode fundamentar sua resposta nas fontes anexadas em vez de depender apenas do que o modelo já sabe.

Para anexar uma fonte de conhecimento:

1. Na seção Conhecimento , selecione o sinal de adição (+).

2. Em Adicionar conhecimento, escolha o tipo de origem:

   • Sites públicos: indexe uma ou mais URLs públicas para que o agente possa citar conteúdo desses sites.
   • SharePoint: conecte-se a um site SharePoint, biblioteca ou documento específico para que o agente possa responder de conteúdo interno (políticas, guias estratégicos, documentação do produto, contratos).

3. Forneça a URL e salve.

Anexe conhecimento sempre que a resposta certa depender do conteúdo no qual o modelo não foi treinado, como políticas internas, especificações de produto, contratos de clientes, a página de preços mais recente em seu site.

Saída

Use a lista suspensa Saída para controlar o formato retornado pelo agente. A forma determina como as etapas de fluxo de trabalho downstream consomem o resultado.

Quando você escolhe uma saída estruturada, cada campo se torna seu próprio token de conteúdo dinâmico que as ações downstream podem referenciar diretamente.

Ao selecionar Novo, você cria o agente na experiência do construtor de agentes que é aberta em uma nova guia do navegador. No construtor de agentes, você configura as instruções, o conhecimento e os recursos do agente.

Quando terminar de criar o agente, publique-o, retorne ao designer de fluxo e selecione-o na lista de agentes existentes.

Ative Solicitar assistência humana em caso de dúvida para permitir que o agente escalone a situação quando não estiver confiante o suficiente para agir por conta própria. O agente envia e-mails ao proprietário da conexão para entrada e aguarda uma resposta antes de continuar.

Ative isso para decisões de alto risco em que estar errado é mais caro do que ser lento, como manuseio de exceções em transações financeiras, aprovações de casos extremos ou decisões de julgamento em escalonamentos de clientes.

Ative a solicitação de assistência humana quando não tiver certeza se você deseja que o agente escalone para um humano quando ele não puder continuar por conta própria. Quando ocorre um escalonamento, o agente envia uma solicitação de entrada por email para o proprietário da conexão.

Essa opção é útil quando a tarefa do agente pode exigir uma interpretação que vá além de suas instruções ou conhecimento disponível. Por exemplo, se um agente estiver revisando relatórios de despesas e encontrar uma cobrança incomum que não corresponda a nenhuma política, ele poderá sinalizar o relatório para que uma pessoa decida em vez de fazer uma aprovação incorreta.

1. Selecione a próxima ação em que você deseja usar o resultado (por exemplo, Enviar um email ou atualizar uma linha).

2. Abra o seletor de conteúdo dinâmico no campo que você deseja preencher.

3. Selecione a saída da etapa do Agente

   • Saída da Resposta de texto: um único token de resposta do agente.
   • Saída estruturada ou estruturada personalizada → um token por cada campo que você definiu.

Padrões comuns:

• Insira uma resposta de texto em um corpo de email, mensagem do Teams ou documento.
• Ramificar o fluxo de trabalho em um campo estruturado (por exemplo, priority == "high").
• Escreva campos estruturados no Dataverse, Excel ou em um SharePoint list.

1. Selecione a ação em que você deseja usar a resposta (por exemplo, enviar um email ou atualizar uma ação de linha ).

2. No campo em que você deseja inserir a resposta, abra o seletor de conteúdo dinâmico.

3. Procure a saída da etapa Executar um agente e selecione a resposta do agente.

Maneiras comuns de usar a resposta do agente:

• Insira a resposta no corpo de um email ou de uma mensagem.
• Defina uma condição para ramificar seu fluxo de trabalho com base no que o agente retornou.
• Salve a resposta em uma variável ou fonte de dados para referência posterior.