Adicionar um nó agente a um fluxo de trabalho

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

O nó agente permite que um fluxo passe um passo a um agente de IA que pode raciocinar, chamar ferramentas e extrair de fontes de conhecimento antes de devolver um resultado. Use-o sempre que um passo precisar de julgamento, orquestração em vários passos ou informação de fora do próprio fluxo.

Ao usar o nó de agente, pode:

• Liga para um agente existente.
• Dê ao agente uma instrução em linguagem natural, incluindo conteúdos dinâmicos dos passos anteriores.
• Equipa o agente com ferramentas (servidores e conectores Model Context Protocol (MCP)) para que possa agir.
• Baseie o agente em conhecimento (sites SharePoint, sites públicos) para que possa responder a partir do seu conteúdo.
• Use a resposta do agente nas etapas seguintes do fluxo.

Adicionar um nó agente

1. No Copilot Studio, vai a Workflows e abre um workflow existente, ou cria um novo.

   • Novo fluxo de trabalho: É direcionado para o designer para configurar um gatilho.
   • Fluxo de trabalho existente: Abra o fluxo de trabalho e vá ao separador Build .

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

Escolha um agente existente para o nó do agente

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

• Um agente existente: Selecione um agente publicado a partir de uma lista. O agente executa com as instruções, ferramentas e os conhecimentos com os quais já foi configurado.
• Novo agente para este fluxo de trabalho: Constrói um agente inline construído especificamente para este fluxo. As instruções, ferramentas, conhecimento e forma de saída do agente são configurados no próprio nó e acompanham o fluxo de trabalho. Use esta opção quando o trabalho do agente for específico para esta automação e não precisar de a partilhar noutro lado.

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

Configure um novo agente para o nó agente

Quando escolhes Novo agente para este fluxo de trabalho, o painel de configuração expande-se para que possas moldar o agente no local.

Instruções

Para um agente inline, o campo Instruções serve tanto como descrição do cargo do agente como como o prompt por execução. Não existe um campo Mensagem separado. Escreva o que o agente deve fazer em linguagem simples e inclua conteúdo dinâmico de etapas anteriores para fornecer os dados para esta execução.

Seja específico quanto à tarefa, aos inputs que o agente pode esperar e ao formato da resposta que quer receber. Instruções mais claras significam corridas mais fiáveis.

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

Para escolher o modelo que alimenta o agente, use o menu suspenso do modelo na caixa de instruções. Selecione um modelo mais capaz quando a tarefa envolver raciocínio em vários passos ou interpretação cuidadosa. Selecione um modelo mais rápido quando a tarefa for simples e estiver a correr em grande volume.

QI de trabalho

Ative o Work IQ para permitir que o agente utilize a atividade de trabalho recente do utilizador em execução, incluindo e-mail, Teams, calendário, OneDrive e contexto SharePoint, para fundamentar as suas respostas. Este contexto é útil quando o fluxo de trabalho atua em nome de uma pessoa e o contexto pessoal torna a resposta melhor.

Tools

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

Para anexar uma ferramenta:

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

2. Em Adicionar ferramenta, navegue ou pesquise a ferramenta que deseja.

3. Selecione a ferramenta que deseja adicionar. Podes adicionar várias ferramentas a um único agente.

Pode acoplar dois tipos de ferramentas:

• Servidores Model Context Protocol (MCP): Servidores pré-configurados que expõem um conjunto selecionado de funcionalidades.
• Conectores: Qualquer ação de conector Power Platform.

O agente decide durante a execução qual das suas ferramentas associadas chamar, em que ordem e com que argumentos. Não precisas de ligar ferramentas entre si.

Conhecimento

O conhecimento dá ao agente algo para ler. Quando faz uma pergunta ao agente, ele pode fundamentar a resposta nas fontes que anexa, 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 mais (+).

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

   • Sites públicos: Indexe uma ou mais URLs públicas para que o agente possa citar conteúdos desses sites.
   • SharePoint: Ligue-se a um site, biblioteca ou documento específico do SharePoint para que o agente possa responder a partir de conteúdos internos.

3. Fornece o URL e depois guarda.

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

Output

Utilize o menu pendente Saída para definir o formato do que o agente devolve. A forma determina como os passos posteriores do processo consomem o resultado.

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

Envia uma mensagem ao agente

Quando seleciona um agente existente, o nó mostra um campo Mensagem . Use este campo para dizer ao agente o que fazer nesta corrida. As instruções, ferramentas e conhecimento 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 raciocine sobre dados reais em tempo de execução. Por exemplo, num fluxo de trabalho que é ativado quando um evento no calendário é criado, a mensagem pode ser Prepare a brief for seguida pela variável Participantes Obrigatórios .

Solicite assistência humana quando tiver a certeza

Ativar Pedido de assistência humana quando não estiver seguro para permitir que o agente escale o problema quando não tiver confiança suficiente para agir autonomamente. O agente envia um email ao dono da ligação a pedir informações e espera por uma resposta antes de continuar.

Ative esta configuração para decisões de alto risco em que estar errado é mais caro do que ser lento, como o tratamento de exceções em transações financeiras, aprovações de casos extremos ou decisões judiciais sobre escalonamentos de clientes.

Use a resposta do agente no seu fluxo de trabalho

Quando o nó agente é executado, o fluxo de trabalho espera que o agente complete a sua tarefa. A resposta do agente torna-se então disponível como conteúdo dinâmico que pode usar em qualquer etapa subsequente.

Para usar a resposta do agente numa ação subsequente:

1. Seleciona a próxima ação onde queres usar o resultado.

2. Abre o seletor dinâmico de conteúdo no campo que queres preencher.

3. Escolhe a saída do passo do Agente:

   • Saída de resposta de texto : Uma variável de resposta de um único agente .
   • Saída estruturada ou personalizada: Uma variável por campo que definiste.

Padrões comuns:

• Insira uma resposta de texto no corpo de um email, mensagem do Teams ou documento.
• Ramifice o fluxo de trabalho num campo estruturado como priority == "high".
• Escreva campos estruturados no Dataverse, Excel ou numa lista do SharePoint.

Testar e avaliar um nó agente

Depois de configurar um nó agente, teste-o para verificar se se comporta como esperado antes de publicar o seu fluxo de trabalho. Os testes permitem-lhe validar as instruções, ferramentas, fontes de conhecimento, entradas e saídas do agente isoladamente, sem ter de executar todo o fluxo de trabalho.

As avaliações baseiam-se nos resultados de um teste e ajudam a avaliar a qualidade da resposta gerada. Em conjunto, testes e avaliações suportam um fluxo de trabalho iterativo de desenvolvimento: Configure → Test → Evaluate → Improve.

Testar um nó agente

Use o painel de Teste no painel lateral do agente para executar o nó agente e inspecionar a sua saída.

1. Selecione o nó agente para abrir o seu painel lateral de propriedades.

2. Selecione a guia Teste .

3. Introduzir entradas manualmente ou usar entradas de uma execução de fluxo de trabalho anterior.

4. Selecione Executar teste.

A execução de teste executa o agente usando a sua configuração atual e apresenta a saída gerada. Os testes ajudam a verificar se o agente corre com sucesso e produzem o tipo de resposta que espera. Depois de gerar um resultado de teste, utilize avaliações para avaliar a qualidade dessa resposta e determinar quão bem corresponde às suas expectativas e requisitos.

Avaliar um nó agente

Após um teste bem-sucedido, avalie a resposta utilizando métodos de teste.

Um método de teste permite-te descrever, em linguagem natural, como deve ser uma boa resposta (e afins). Durante a avaliação, a produção do agente é avaliada com base nestes critérios para ajudar a determinar se atingiu o resultado pretendido. Os métodos de teste permitem-lhe avaliar critérios como:

• Se a resposta responde ao pedido do utilizador.
• Se as ferramentas corretas foram usadas.
• Se a saída segue um formato ou esquema esperado.
• Se a resposta está alinhada com o comportamento pretendido do agente.

Antes de poder realizar uma avaliação, deve realizar um teste e criar pelo menos um método de teste. Pode criar métodos de teste manualmente ou gerá-los automaticamente selecionando Gerar Automaticamente. Os métodos de teste gerados por IA baseiam-se nas instruções do agente e nas ferramentas configuradas e podem ajudá-lo a começar a avaliação mais rapidamente.

Se tiver vários métodos de teste, use as caixas de seleção ao lado de cada método de teste para controlar quais são incluídos na execução de avaliação. Despacha uma caixa de seleção para excluir temporariamente um método de teste sem o apagar.

Para eliminar um método de teste, abra a experiência de avaliação modal selecionando o ícone ao lado do botão Executar avaliação no canto superior direito do painel Avaliar . A partir daí, selecione o método de teste que quer remover e apague-o.

Para avaliar um resultado de teste:

1. Faz um teste para o nó agente.

2. Selecione Avaliar.

3. Crie um avaliador ou selecione um avaliador existente.

4. Selecione avaliação de Corrida.

Para cada avaliador, a avaliação apresenta:

• Um resultado de Aprovado ou Reprovado .
• Evidências ou raciocínios que expliquem o resultado.
• No caso de um resultado falhado, pode receber recomendações geradas por IA para ajudar a melhorar o agente quando os critérios de avaliação não forem cumpridos.

Melhorar e voltar a testar

O desenvolvimento de agentes é um processo iterativo. Use os resultados das avaliações para refinar os resultados do agente:

• Instruções
• Tools
• Fontes de conhecimento
• Formato de saída

Depois de fazer alterações, faça outro teste e avaliação para validar as melhorias. Repetir este processo ajuda a melhorar a qualidade e a confiança do agente antes de publicar ou usar o agente num fluxo de trabalho de produção.

Limitações conhecidas

A experiência de avaliação apresenta atualmente as seguintes limitações:

• As avaliações só estão disponíveis para novos agentes criados em fluxos de trabalho.
• Não podes escolher um modelo personalizado para avaliações.
• Para realizar uma avaliação, deve realizar pelo menos um teste e configurar pelo menos um método de teste.
• As avaliações baseiam-se no resultado mais recente do teste. Se atualizar as instruções, ferramentas, conhecimento ou configuração do agente, execute um novo teste antes de reavaliar.
• Pode gerar até cinco métodos de teste gerados por IA por nó agente.
• Podes fazer até 20 avaliações por nó agente por dia.

Cenários de automação

Um nó agente está no seu melhor como uma etapa num fluxo de trabalho mais longo. Os passos anteriores recolhem e normalizam as entradas, o agente faz o raciocínio, e os passos seguintes agem sobre o resultado através de vários sistemas.

Faça a triagem dos tickets de suporte recebidos

Um fluxo de trabalho é ativado quando um novo ticket é criado no Dataverse. Passos anteriores retiram o corpo do bilhete, os anexos e o histórico recente de casos do cliente. O nó agente então lê tudo, baseia-se na base de conhecimento do produto e retorna uma saída estruturada com category, priority, suggested_owner, e draft_reply. Passos posteriores ramificam-se priority para chamar o engenheiro de prevenção para interrupções ou atribuir o ticket e colocar a resposta preliminar para revisão.

Analise os relatórios de despesas em relação à apólice

Um fluxo de trabalho é ativado quando um relatório de despesas é submetido. Passos anteriores carregam os itens de linha e convertem montantes não em USD para que o agente raciocine com base única. O nó agente aterra-se no site SharePoint da política e devolve uma bandeira por compliant linha mais reason. Os passos seguintes ou aprovam automaticamente e publicam a entrada do registo no sistema de AP ou iniciam uma ação de aprovação com o raciocínio do agente em anexo e aguardam por um revisor financeiro.

Prepara uma reunião informativa

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 retira o contexto da conta do Dynamics 365. O nó agente usa então o Work IQ para analisar emails recentes e threads do Teams com os participantes e devolve pontos de discussão, riscos em aberto e perguntas recomendadas. Passos posteriores formatam esse resultado num briefing em HTML enviado por email 30 minutos antes da reunião e publicam-no num cartão adaptativo no Teams.

Extrair dados de Documentos

Um fluxo de trabalho pode usar dados de documentos de várias formas. Dois cenários comuns são anexos de email do Outlook e ficheiros SharePoint.

Para o email, o gatilho Office 365 Outlook Quando chega um novo email inicia o fluxo de trabalho quando o email é recebido. O nó agente pode então usar a saída do trigger para extrair dados dos anexos do email.

No SharePoint, pode recuperar ficheiros usando um nó "Obter conteúdo do ficheiro" do SharePoint e passar os ficheiros para o nó agente, que pode extrair dados de documentos armazenados no site SharePoint. Etapas posteriores podem usar a informação extraída para atualizar registos, preencher sistemas ou gerar insights.

Perguntas frequentes

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

Use um agente inline quando o trabalho do agente for específico para um fluxo de trabalho e quiser que tudo, incluindo instruções, ferramentas, conhecimento e resultados, 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 os utilizam.

Usa um agente existente quando o mesmo agente é partilhado por vários fluxos de trabalho ou superfícies, ou quando o agente pertence a uma equipa diferente e só queres chamar a situação.

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

N.º Um agente inline está limitado ao seu fluxo de trabalho. Se te encontrares a construir o mesmo agente inline em vários fluxos de trabalho, promove-o para um agente publicado e chama esse agente a partir de cada fluxo de trabalho.

Conteúdo relacionado

• Edite e gere o seu fluxo de trabalho no designer
• Visão geral dos fluxos de trabalho