Adicionar um nó agente a um fluxo de trabalho

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

O nó agente permite que um fluxo passe um passo para um agente de IA que pode raciocinar, chamar ferramentas e extrair de 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:

• Ligue para um corretor 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.

Adicionar um nó de agente

1. No Copilot Studio, vá em Fluxos de Trabalho 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.

Escolha um agente existente para o nó do agente

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.

Configurar um novo agente para o nó de 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 inline, o campo Instruções serve tanto como descrição do cargo do agente quanto como o prompt por 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 fornecer os dados para essa 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 do fluxo de trabalho for Quando um novo e-mail chega, suas instruções podem ser: Read the email below and decide whether it's a sales lead, a support request, or something else. Reply with a single word. seguido pelas 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 múltiplas 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. Esse contexto é útil quando o fluxo de trabalho age em nome da pessoa e o contexto pessoal 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 as 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 em tempo de execução qual de suas ferramentas anexadas chamar, em que ordem e com quais argumentos. Você não precisa ligar ferramentas juntas.

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, biblioteca ou documento específico do SharePoint para que o agente possa responder a partir de conteúdo interno.

3. Forneça a URL e depois salve.

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

Saída

Use o menu suspenso Saída para controlar a forma do que é 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.

Enviar uma mensagem para o agente

Quando você seleciona um agente existente, o nó mostra um campo Message . 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. Por exemplo, em um fluxo de trabalho que é acionado quando um evento do calendário é criado, a mensagem pode ser Prepare a brief for seguida pela variável Participantes Obrigatórios .

Solicitar assistência humana quando não tiver certeza

Ative Solicitar assistência humana quando houver dúvida para permitir que o agente escale 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 essa configuração para decisões de alto risco onde 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.

Usar a resposta do agente em seu fluxo de trabalho

Quando o nó do agente entra em execução, o fluxo de trabalho aguarda que o agente conclua 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 próxima ação onde deseja usar o resultado.

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 de resposta de texto : Uma variável de resposta de um único agente .
   • Saída estruturada ou personalizada: Uma variável por campo que você definiu.

Padrões comuns:

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

Teste e avalie um nó agente

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

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

Teste um nó agente

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

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

2. Selecione a guia Testar.

3. Insira as entradas manualmente ou use entradas de uma execução anterior do fluxo de trabalho.

4. Selecione Executar teste.

A execução de teste executa o agente usando sua configuração atual e exibe a saída gerada. Os testes ajudam a verificar se o agente funciona com sucesso e produz o tipo de resposta que você espera. Após gerar o resultado do teste, utilize avaliações para avaliar a qualidade dessa resposta e determinar o quão bem ela atende às suas expectativas e requisitos.

Avalie um nó agente

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

Um método de teste permite que você descreva, em linguagem natural, como deve ser uma boa resposta (e tudo mais). Durante a avaliação, a produção do agente é avaliada com base nesses critérios para ajudar a determinar se alcançou o resultado pretendido. Métodos de teste permitem avaliar critérios como:

• Se a resposta responde ao pedido do usuário.
• 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 realizar uma avaliação, você deve realizar um teste e criar pelo menos um método de teste. Você pode criar métodos de teste manualmente ou gerá-los automaticamente selecionando Geração Automática. Os métodos de teste gerados por IA são baseados nas instruções e ferramentas configuradas do agente e podem ajudar você a começar a avaliação mais rapidamente.

Se você tiver múltiplos métodos de teste, use as caixas de seleção ao lado de cada método para controlar quais são incluídos na execução de avaliação. Marque uma caixa para excluir temporariamente um método de teste sem deletá-lo.

Para excluir 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 de Avaliar . A partir daí, selecione o método de teste que deseja remover e delete-o.

Para avaliar o resultado de um teste:

1. Faça 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 retorna:

• Um resultado de aprovação ou reprovação .
• Evidências ou raciocínios que expliquem o resultado.
• Em caso de falha, você pode receber recomendações geradas por IA para ajudar a melhorar o agente quando os critérios de avaliação não forem atendidos.

Melhore e teste novamente

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 da saída

Após fazer as mudanças, execute outro teste e avaliação para validar as melhorias. Repetir esse processo ajuda a melhorar a qualidade e a confiança do agente antes de publicar ou usar o agente em um fluxo de trabalho de produção.

Limitações conhecidas

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

• Avaliações só estão disponíveis para novos agentes criados em fluxos de trabalho.
• Você não pode selecionar um modelo personalizado para avaliações.
• Para executar uma avaliação, você deve realizar pelo menos um teste e configurar pelo menos um método de teste.
• As avaliações são realizadas em relação ao resultado do teste mais recente. Se você atualizar as instruções, ferramentas, conhecimento ou configuração do agente, execute um novo teste antes de reavaliar.
• Você pode gerar até cinco métodos de teste gerados por IA por nó agente.
• Você pode fazer até 20 avaliações por nó de agente por dia.

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 retiram o corpo do ticket, os anexos e o histórico recente de casos do cliente. O nó agente então lê tudo, se fundamenta na base de conhecimento do produto e retorna uma saída estruturada com category, priority, suggested_owner, e draft_reply. Etapas posteriores se ramificam priority para chamar o engenheiro de plantão para interrupções ou atribuir o chamado e enfileirar a resposta preliminar para análise.

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

Um fluxo de trabalho é disparado quando um relatório de despesas é enviado. Etapas anteriores carregam os itens e convertem valores que não sejam USD para que o agente raciocine sobre uma base única. O nó agente se aterra no site SharePoint da política e retorna uma flag por compliant linha mais reason. Etapas posteriores ou aprovam automaticamente e postam a entrada no sistema de contos de pagamento ou iniciam uma ação de aprovação com o raciocínio do agente anexado e aguardam 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ó agente então usa o Work IQ para escanear e-mails recentes e threads do Teams com os participantes, retornando pontos de discussão, riscos abertos 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.

Extrair dados de Documentos

Um fluxo de trabalho pode usar dados de documentos de várias maneiras. Dois cenários comuns são anexos de e-mail do Outlook e arquivos do SharePoint.

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

Para o SharePoint, você pode recuperar arquivos usando um nó "Obter conteúdo do arquivo" do SharePoint e passar os arquivos para o nó agente, que pode extrair dados de documentos armazenados no site do SharePoint. Etapas posteriores podem usar as informações extraídas para atualizar registros, preencher sistemas ou gerar insights.

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 em vários fluxos de trabalho ou superfícies, ou quando o agente for de uma equipe diferente e você só quiser encerrar.

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.

Conteúdo relacionado

• Editar e gerenciar seu fluxo de trabalho no designer
• Visão geral dos fluxos de trabalho