Adicionar um nó de agente a um fluxo de agente

Note

Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.

O nó de agente permite que um fluxo transfira uma etapa para um agente de IA que pode raciocinar, acionar ferramentas e buscar informações em fontes de conhecimento antes de retornar um resultado. Use-o sempre que um passo precisar de julgamento, orquestração em múltiplos passos ou informações de fora do próprio fluxo.

Usando o nó do agente, você pode:

  • Chame um agente existente.
  • Dê ao agente uma instrução de linguagem natural, incluindo conteúdo dinâmico de etapas anteriores.
  • Equipe o agente com ferramentas (servidores MCP (Model Context Protocol) e conectores) para que ele possa tomar medidas.
  • Prepare o agente com conhecimento (sites SharePoint, sites públicos) para que ele possa responder com base no seu conteúdo.
  • Use a resposta do agente nas etapas posteriores do fluxo.

Nos fluxos de agentes, você pode selecionar um agente publicado existente ou criar um novo agente publicado na interface do construtor de agentes e, em seguida, chamá-lo no fluxo.

Adicionar um nó de 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.

Escolha um agente existente para o nó do 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 as instruções, ferramentas e conhecimento com os quais já foi configurado.

  • Criar um novo agente: selecione Novo para criar um novo agente. Isso abre uma nova guia do navegador com a ferramenta de criação de agentes. Crie e publique seu agente lá e retorne ao editor de fluxo para selecioná-lo na lista de agentes existentes.

Se você selecionar um agente existente, pule para Enviar uma mensagem ao agente.

Crie um novo agente para o nó de agente

Quando você seleciona Novo, você abre a experiência do construtor de agentes em uma nova aba do navegador. No construtor de agentes, você configura as instruções, conhecimentos e capacidades do agente.

Quando terminar de construir o agente, publique-o, volte ao designer de fluxo e selecione-o da lista de agentes existentes.

Enviar uma mensagem para um agente existente

Quando você seleciona um agente existente, o nó mostra um campo Mensagem. Use este campo para dizer ao agente o que fazer nesta execução. As instruções, ferramentas e conhecimentos do agente já estão configurados no agente publicado.

No campo Mensagem , escreva o prompt para esta execução. Use o seletor de conteúdo dinâmico para inserir tokens de etapas anteriores, de modo que o agente tenha motivos sobre dados em tempo de execução reais.

Solicitar assistência humana quando não tiver certeza

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.

Use a resposta do agente no seu fluxo de agente

Quando o nó agente é executado, o fluxo do agente espera que o agente complete sua tarefa. Em seguida, a resposta do agente fica disponível como conteúdo dinâmico que você pode usar em qualquer etapa subsequente.

Para usar a resposta do agente em uma ação downstream:

  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 o fluxo do agente com base no que o agente retornou.
  • Salve a resposta em uma variável ou fonte de dados para referência posterior.

Cenários de automação

Um nó de agente funciona melhor como uma etapa em um fluxo de trabalho mais longo. As etapas anteriores reúnem e normalizam as entradas, o agente faz o raciocínio e as etapas posteriores agem sobre o resultado em vários sistemas.

Fazer a triagem de tíquetes de suporte recebidos.

Um fluxo de trabalho é disparado quando um novo tíquete é criado no Dataverse. Etapas anteriores extraem o conteúdo do ticket, os anexos e o histórico recente de casos do cliente. O nó agente lê tudo, se fundamenta na base de conhecimento do produto (SharePoint) e retorna uma saída estruturada com category, priority, suggested_owner, e draft_reply. Etapas posteriores se dividem em priority para acionar o engenheiro de plantão em caso de interrupções; caso contrário, o tíquete é atribuído e a resposta de rascunho é enfileirada para revisão.

Examinar relatórios de despesas de acordo com as políticas

Um fluxo de trabalho é disparado quando um relatório de despesas é enviado. As etapas anteriores carregam os itens de linha e convertem valores que não estejam em USD para que o agente raciocine com base em um único referencial. O nó do agente se baseia no site do SharePoint da política e retorna um sinalizador por linha compliant, além de reason. Etapas posteriores aprovam automaticamente e lançam o lançamento contábil no sistema de contas a pagar, ou iniciam uma ação de Aprovações com a justificativa do agente anexada e aguardam a análise de um revisor financeiro.

Preparar um resumo de reunião

Um fluxo de trabalho é executado todas as manhãs, lista as reuniões do dia no Outlook e percorre cada uma delas. Para cada reunião, uma etapa anterior extrai o contexto da conta do Dynamics 365. O nó do agente então usa Work IQ para examinar e-mails recentes e conversas no Teams com os participantes e retorna tópicos para discussão, riscos em aberto e perguntas recomendadas. Em etapas posteriores, formatam a saída em um briefing HTML enviado por e-mail 30 minutos antes da reunião e o postam como um cartão adaptativo no Teams.

Perguntas frequentes

Quando devo usar um agente embutido e quando devo usar um agente existente?

Use um agente embutido quando o trabalho do agente for específico para um fluxo de trabalho e você quiser que tudo, incluindo instruções, ferramentas, conhecimento e saída, viaje com o fluxo de trabalho. Os agentes embutidos são mais rápidos de configurar e mais fáceis de entender porque a configuração está diretamente ao lado das etapas que a usam.

Use um agente existente quando o mesmo agente for compartilhado entre vários fluxos de trabalho ou plataformas (por exemplo, também utilizado no Teams) ou quando o agente pertence a uma equipe diferente e você apenas deseja utilizá-lo.

Quando devo usar um nó de agente e quando devo usar um nó de prompt?

Ambos adicionam IA a um fluxo de trabalho, mas são criados para trabalhos diferentes.

Capacidade Nó do agente Nó de prompt
Orquestração de ferramentas Acesso completo a todas as ferramentas do agente Somente interpretador de código
Fontes de conhecimento Todas as fontes de conhecimento com suporte Apenas Dataverse
Revisão por um humano Yes Não
Complexidade da tarefa Tarefas complexas. O orquestrador de agentes pode fazer várias voltas. Tarefas simples que podem ser executadas em um único turno

Use o nó do agente quando a etapa precisar de raciocínio, orquestração de ferramentas ou conhecimento fundamentado. Use o nó de prompt quando você precisar que o modelo apenas transforme ou gere texto.

O agente embutido pode ser reutilizado fora desse fluxo de trabalho?

Não. Um agente inline está associado ao seu fluxo de trabalho. Se você se encontrar criando o mesmo agente embutido em vários fluxos de trabalho, converta-o em um agente publicado e chame esse agente em cada fluxo de trabalho.