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

O nó de agente permite que um fluxo de agente ou fluxo de trabalho de agente transfira um passo para um agente de IA capaz de raciocinar, chamar ferramentas e consultar fontes de conhecimento antes de devolver um resultado. Utilize-o sempre que um passo exigir discernimento, coordenação de vários passos ou informações provenientes de fora do próprio fluxo ou fluxo de trabalho.

Pode escolher um agente publicado existente ou criar um agente novo diretamente no nó, sem sair do estruturador de fluxos ou de fluxos de trabalho. Os agentes inline são a forma mais rápida de adicionar IA a um fluxo de agente ou a um fluxo de trabalho. Dê uma instrução ao nó, opcionalmente anexe ferramentas e conhecimento, e está feito.

Ao usar o nó de agente, pode:

  • Chame um agente existente ou crie um novo agente que faça parte do fluxo de agente ou fluxo de trabalho de agente.
  • Forneça ao agente uma instrução em linguagem natural, incluindo conteúdo dinâmico a partir dos passos anteriores.
  • Equipe o agente com ferramentas (Model Context Protocol (MCP) servidores e conectores) para que possa agir.
  • Fundamente o agente em conhecimento (sites do SharePoint, sites públicos) para que ele possa responder com base no seu conteúdo.
  • Escolha a forma como o agente devolve o resultado: texto livre ou dados estruturados que o seu fluxo de agente ou fluxo de trabalho de agente pode ramificar.

Adicionar um nó de agente

  1. No Copilot Studio, aceda a Fluxos e abra um fluxo de trabalho existente ou crie um novo.

    • Novo fluxo de trabalho: é direcionado para o estruturador para configurar um acionador.
    • Fluxo de trabalho existente: abra o fluxo de trabalho e aceda ao separador Criar.
  2. Selecione o ícone Agente no painel Adicionar. O painel de configuração é aberto para o nó do agente.

Escolher um agente existente para o nó de agente

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

  • Um agente existente: selecione um agente publicado de uma lista. O agente funciona com as instruções, ferramentas e conhecimentos com que já foi configurado.

  • Novo agente para este fluxo de trabalho: crie um agente inline associado a este fluxo de trabalho. As instruções, as ferramentas, o conhecimento e o formato de saída do agente são configurados no próprio nó e acompanham o fluxo de trabalho. Utilize esta opção quando a função do agente for específica para esta automatização e não precisar de ser partilhada fora deste fluxo.

A secção seguinte deste artigo centra-se na configuração de um novo agente inline. Se selecionar um agente existente, avance para Enviar uma mensagem ao agente.

Configurar um novo agente para o nó de agente

Quando escolhe Novo agente para este fluxo de trabalho, o painel de configuração expande-se para que possa definir o agente no local.

Instruções

Para um agente inline, o campo Instruções serve tanto como a descrição da tarefa do agente como o pedido para cada execução. Não existe um campo Mensagem separado. Escreva o que o agente deve fazer, em linguagem clara, e inclua conteúdo dinâmico dos passos anteriores para fornecer os dados necessários para esta execução.

Seja específico quanto à tarefa, às entradas que o agente pode esperar e ao formato da resposta desejada. Instruções mais claras garantem execuções mais fiáveis.

Por exemplo, se o acionador do fluxo de trabalho for Quando chega um novo email, as suas instruções podem ser as seguintes: Read the email below and decide whether it's a sales lead, a support request, or something else. Reply with a single word. seguido dos tokens Assunto e Corpo do acionador.

Para escolher o modelo que suporta o agente, utilize a lista pendente do modelo no canto superior direito da caixa de Instruções. Selecione um modelo mais capaz quando a tarefa envolver uma racionalização em vários passos ou uma interpretação cuidadosa. Selecione um modelo mais rápido quando a tarefa for simples e for executada em grande volume.

Work IQ

Ative o Work IQ para permitir que o agente utilize a atividade de trabalho recente do utilizador, incluindo o contexto de e-mail, Teams, calendário, OneDrive e SharePoint, para fundamentar as suas respostas. Isto é útil quando o fluxo de trabalho atua em nome de uma pessoa e o contexto pessoal (tópicos recentes, reuniões futuras, documentos recentemente editados) torna a resposta mais precisa.

Ferramentas

As ferramentas permitem que o agente execute ações tais como enviar uma mensagem, consultar um registo, executar uma pesquisa ou invocar uma API. Sem ferramentas, o agente só pode ler e racionalizar. Com as ferramentas, também pode agir.

Para anexar uma ferramenta:

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

  2. Em Adicionar ferramenta, explore ou pesquise a ferramenta que pretende.

  3. Selecione a ferramenta para a adicionar. Pode adicionar várias ferramentas a um único agente.

Pode anexar dois tipos de ferramentas:

  • Servidores Model Context Protocol (MCP): servidores pré-criados que expõem um conjunto selecionado de capacidades.
  • Conectores: qualquer ação do conector do Power Platform.

O agente decide em runtime que ferramentas anexas deve chamar, por que ordem e com que argumentos. Não se ligam ferramentas entre si. É isto que torna o nó do agente diferente do encadeamento de ações individuais do fluxo de trabalho.

Conhecimentos

O conhecimento dá ao agente algo para ler. Quando faz uma pergunta ao agente, ele pode basear a resposta nas fontes anexadas, em vez de depender apenas do que o modelo já sabe.

Para anexar uma fonte de conhecimento:

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

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

    • Sites públicos: indexe um ou mais URLs públicos para que o agente possa citar conteúdos desses sites.
    • SharePoint: ligue-se a um site do SharePoint, biblioteca ou documento específico para que o agente possa responder a partir de conteúdos internos (políticas, manuais de procedimentos, documentação de produto, contratos).
  3. Forneça o URL e, em seguida, guarde.

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

Saída

Utilize a lista pendente Saída para controlar o formato do que o agente devolve. A forma determina a forma como os passos de fluxo de trabalho a jusante consomem o resultado.

Tipo de saída O que obtém Quando Utilizar
Resposta de texto Uma única cadeia. O passo a jusante apenas insere a resposta do agente (por exemplo, no corpo de um e-mail ou numa mensagem do Teams).
Saída estruturada Um objeto predefinido com campos nomeados. Pretende campos consistentes sem ter de escrever um esquema. Por exemplo, um resumo, uma etiqueta do sentimento e uma ação seguinte recomendada.
Saída estruturada personalizada Um objeto que corresponde a um esquema JSON que define. O fluxo de trabalho a jusante requer campos rigorosos e legíveis por computador para ramificar, escrever em colunas ou enviar para uma API.

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

Enviar uma mensagem para um agente existente

Quando escolhe um agente existente, o nó mostra um campo Mensagem. É assim que se instrui o agente sobre o que fazer nesta execução. As instruções, as ferramentas e o conhecimento do agente já estão definidos no agente publicado.

No campo Mensagem, escreva o pedido para esta execução. Utilize o seletor de conteúdo dinâmico para inserir tokens de passos anteriores, permitindo que o agente raciocine com base em dados reais de runtime. Por exemplo, num fluxo de trabalho cujo acionador é a criação de um evento de calendário, a mensagem pode ser Prepare a brief for seguida pelo token Participantes necessários.

Nota

Os agentes inline não utilizam um campo Mensagem separado — o campo Instruções funciona também como o pedido por execução. Consulte Instruções.

Peça assistência humana quando tiver a certeza

Ative a opção Pedir assistência humana quando não tiver a certeza para permitir que o agente escale o problema quando não tiver confiança suficiente para agir autonomamente. O agente envia um e-mail ao proprietário da ligação a solicitar uma resposta e espera por uma resposta antes de continuar.

Ative esta opção para decisões de alto risco, em que errar é mais dispendioso do que ser lento, como no tratamento de exceções em transações financeiras, aprovações de casos extremos ou decisões sobre escalamentos de clientes.

Utilizar a resposta do agente no seu fluxo de trabalho

Quando o nó de agente é executado, o fluxo de trabalho espera que o agente conclua a sua tarefa. A resposta do agente passa a estar disponível como conteúdo dinâmico que pode ser utilizado em qualquer passo subsequente.

Para utilizar a resposta do agente numa ação a jusante:

  1. Selecione a ação seguinte na qual pretende utilizar o resultado. (por exemplo, Enviar um e-mail ou Atualizar uma linha).

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

  3. Escolha a saída do passo Agente:

    • Saída de resposta de texto → um único token de resposta do agente.
    • Saída Estruturada ou Estruturada personalizada → um token por campo que definiu.

Padrões comuns:

  • Insira uma resposta de texto no corpo de um e-mail, mensagem do Teams ou documento.
  • Ramifique o fluxo de trabalho com base num campo estruturado (por exemplo, priority == "high").
  • Escreva campos estruturados no Dataverse, no Excel ou numa lista do SharePoint.

Cenários de automatização

Um nó de agente funciona melhor quando é utilizado como um passo num fluxo de trabalho mais extenso. Os passos anteriores recolhem e normalizam as entradas, o agente realiza a racionalização e os passos posteriores atuam sobre o resultado em múltiplos sistemas.

Triar os pedidos de suporte recebidos

Um fluxo de trabalho é acionado quando um novo pedido de suporte é criado no Dataverse. Os passos anteriores extraem o corpo do pedido de suporte, os anexos e o histórico recente de casos do cliente; o nó do agente lê tudo, fundamenta-se na base de dados de conhecimento do produto (SharePoint) e devolve uma saída estruturada com category, priority, suggested_owner e draft_reply. Os passos posteriores ramificam com base em priority para alertar o engenheiro de serviço em caso de indisponibilidade, atribuindo o pedido de suporte e colocando em fila o rascunho de resposta para revisão.

Analisar os relatórios de despesas em comparação com a política

Um fluxo de trabalho é acionado quando um relatório de despesas é submetido. Os passos anteriores carregam os itens de linha e convertem os montantes que não estão em USD, permitindo que o agente raciocine sobre uma base única; o nó de agente fundamenta-se no site de políticas do SharePoint e devolve, para cada linha, um sinalizador compliant e um reason. Os passos seguintes podem aprovar automaticamente e lançar a entrada de diário no sistema AP ou podem iniciar uma ação de Aprovações com o raciocínio do agente anexado e esperar por um revisor financeiro.

Preparar um briefing de reunião

Um fluxo de trabalho é executado todas as manhãs, lista as reuniões do dia no Outlook e repete cada uma delas. Para cada reunião, um passo anterior extrai o contexto da conta do Dynamics 365; o nó do agente utiliza então o Work IQ para analisar os e-mails mais recentes e as conversas do Teams com os participantes e devolve pontos de conversa, riscos em aberto e perguntas recomendadas. Os passos seguintes formatam essa saída num briefing HTML enviado por e-mail 30 minutos antes da reunião e publicam-no como um cartão adaptativo no Teams.

Perguntas mais frequentes

Quando devo utilizar um agente inline e quando devo utilizar um agente existente?

Utilize um agente inline quando a tarefa do agente for específica para um fluxo de trabalho e quiser que tudo, incluindo instruções, ferramentas, conhecimento e saída, acompanhe o fluxo de trabalho. Os agentes inline são mais rápidos de configurar e mais fáceis de compreender, porque a configuração está mesmo ao lado dos passos que a utilizam.

Utilize um agente existente quando o mesmo agente é partilhado por vários fluxos de trabalho ou superfícies (por exemplo, também utilizado em conversação no Teams), ou quando o agente pertence a outra equipa e apenas pretender chamá-lo.

O agente inline pode ser reutilizado fora deste fluxo de trabalho?

Não. Um agente inline está limitado ao seu fluxo de trabalho. Se der por si a criar o mesmo agente inline em vários fluxos de trabalho, em vez disso promova-o para um agente publicado e chame esse agente a partir de cada fluxo de trabalho.