Crie um fluxo de trabalho de agente de chat

Crie uma experiência de chat em tempo real e com IA no Maestro Flow, incluindo recursos como roteamento baseado em saída e entrega ao agente.

O que você criará: um fluxo de conversação demonstrando como os nós de chat principais podem ser usados para orquestrar experiências de chat flexíveis.

Este tutorial cria uma experiência de chat que consiste em um agente de suporte técnico geral que decide quando entregar uma conversa a um agente especialista em contas.

O que você precisa

• Uma conta do UiPath Automation Cloud com acesso ao Fluxo do Maestro.
• Um modelo de LLM disponível para o agente usar.

Nós usados

• Gatilho de conversa: marca o Fluxo como conversacional e o inicia quando um usuário inicia um chat.
• Wait for Message: suspende até que o usuário envie uma mensagem e retorne o contexto da conversa mais recente.
• Agente de conversação: nó de IA de conversação de solicitação única que executa uma interação de respostas e chamadas de ferramenta, dado o contexto da conversa.
• Decisão: roteia na saída estruturada de um agente.
• Enviar mensagem: envie um aviso determinístico (não LLM) para o chat.

Etapas

1. Crie o fluxo e adicione um Gatilho de conversa

1. No Studio Web, escolha Criar novo e selecione Maestro Flow.
2. Selecione o gatilho padrão (rotulado Gatilho manual) e escolha Alterar gatilho.
3. No seletor de gatilhos, selecione Gatilho de conversa.

2. Aguarde a primeira mensagem do usuário

Wait for Message deve ser o primeiro nó após o gatilho da conversa:

1. Arraste um nó Wait for Message da paleta de Ferramentas de conversa para a tela e conecte-o ao Gatilho de conversa.
2. No painel de propriedades, defina ID da conversa como $vars.conversationTrigger1.output.conversationId.

As saídas do nó conversationContext — o histórico de chat recente, dados de perfil do usuário e outras informações da vez — para os nós de chat downstream consumirem.

3. Adicione um nó de agente de conversa

O primeiro nó de agente de conversação que adicionaremos é um agente de helpdesk geral para lidar com perguntas de TI do dia a dia e decide, por meio de uma saída estruturada, quando entregar a um especialista.

1. Arraste um nó Agente conversacional para a tela e conecte-o ao Wait for Message.

2. Renomeie-o para Agente de suporte técnico e renomeie seu ID no painel Avançado do agente para generalHelpdeskAgent para facilitar o rastreamento.

3. No painel de propriedades do agente, defina o Prompt do sistema:

   You are the internal IT helpdesk assistant.
   Answer everyday questions about our tools, wifi, printers,
   meeting rooms, and where to find internal docs.
   
   When the employee is having an account problem — 
   a forgotten password, a locked account, an MFA issue, 
   or a missing permission — tell the user that they will
   be handed off to an account specialist agent.
   

4. Em Configurações do agente de conversação, associe o Contexto da conversa a $vars.waitForMessage1.output.conversationContext.

5. Em Saídas, adicione uma variável de saída:

   • Nome: needsAccountSpecialist
   • Tipo de dados: Booleano
   • Padrão: false
   • Descrição: Set to true when the employee has an account problem — a forgotten password, a locked account, an MFA issue, or a missing permission. Otherwise false.

A Descrição na variável de saída é necessária — o agente usa a descrição além da solicitação do sistema para gerar as saídas estruturadas após sua vez na conversa.

4. Ramificação da decisão do roteador

Siga o agente com um nó de decisão que roteia na saída estruturada.

1. Arraste um nó de decisão para a tela e conecte-o ao agente de suporte técnico geral.
2. Defina a condição: $vars.generalHelpdeskAgent.output.needsAccountSpecialist.
3. Conecte a ramificação False de volta para o Wait for Message (Etapa 2) original. O agente de suporte técnico geral mantém a conversa — ele pode entregar mais tarde ou nunca.

Deixe a ramificação True aberta por enquanto; você o criará nas próximas etapas.

5. Anunciar a entrega

Informe o funcionário sobre o que está acontecendo e peça as próximas etapas antes que o especialista assume o papel.

1. Na ramificação Verdadeiro da Decisão, adicione um nó Enviar mensagem . Configurar:
   • ID da conversa: $vars.conversationTrigger1.output.conversationId
   • ID do Exchange: $vars.waitForMessage1.output.conversationContext.latestExchangeId
   • Conteúdo: "You've been connected to the account specialist, which can help with password resets, unlocking your account, and permission or group membership questions. Please explain your issue."

6. Adicione um segundo loop Aguardar mensagem com o especialista da conta

1. Após o nó Enviar mensagem, adicione outro nó Aguardar mensagem .

2. Defina ID da conversa como $vars.conversationTrigger1.output.conversationId.

3. Arraste um nó de Agente conversacional e conecte-o a esse segundo Wait for Message.

4. Opcionalmente, renomeie-o para Agente especialista em conta.

5. Defina o Prompt do sistema:

   You are the account specialist. The user has been handed off 
   to you from a general helpdesk assistant.
   
   Help only with account problems — password resets, unlocking
   accounts, MFA re-enrollment, and permission or group membership
   questions.
   

6. Em Configurações do agente de conversação, associe o Contexto da conversa a $vars.waitForMessage2.output.conversationContext.

7. Conecte a saída do especialista em conta de volta a waitForMessage2 para fechar o loop do especialista.

Dica:

Quando você tem vários nós Aguardar mensagem, você pode configurar acidentalmente um nó downstream para fazer referência a um contexto de conversa obsoleta de um nó Aguardar mensagem que foi executado anteriormente.

Para um rastreamento mais fácil, crie uma variável no nível do fluxo (por exemplo, $vars.globalConversationContext) e atualize-a na seção Atualizar variável de cada nó Aguardar mensagem. Os nós subsequentes podem fazer referência a essa única fonte de verdade em vez de precisar escolher a saída do nó Aguardar mensagem executada pela última vez.

7. Depure o fluxo

Selecione Debug na barra de ferramentas superior. Um painel de chat abre ao lado da tela.

• Pergunte "Como posso conectar à minha VPN do escritório?" — o agente de helpdesk geral deve responder diretamente e fazer o loop de volta para outro turno.
• Perguntar " Estou tendo problemas para fazer login." — o agente de helpdesk geral deve definir needsAccountSpecialist: true, a Decisão roteia para a ramificação True, o aviso de entrega aparece e o especialista de conta assume.

Inspecione o trace de execução para ver qual agente foi executado em cada vez e qual saída estruturada o agente de suporte técnico geral produziu.

Resultado

Após publicado e implantado, seu fluxo de conversa aparece para os usuários finais como um Agente de conversa nos canais de implantação do chat. Monitore seu desempenho, métricas e feedback do usuário por meio da observabilidade do agente de chat.

Estender este fluxo

• Forneça o contexto e as ferramentas dos agentes: conecte um recurso de contexto ao identificador de contexto do agente para que ele responda a partir de uma origem de conhecimento indexada em vez de apenas o modelo. Conecte recursos de ferramentas ao identificador de Ferramentas do agente para que ele possa agir durante seus turnos de conversa, não apenas responder.
• Adicionar ramificações de execução paralela: além de rotear de volta para Wait for Message, adicione ramificações paralelas para realizar ações nos bastidores sem bloquear a conversa. Por exemplo, uma ramificação pode iniciar um nó humano para a aprovação de um gerente e, em seguida, prosseguir com outras ações.
• Encerre o chat quando o problema for resolvido: adicione uma saída resolved: true no(s) agente(s) que roteia(m) para uma ramificação que termina a execução. A conversa termina corretamente e os usuários verão que ela terminou.

Por exemplo, estender o fluxo do tutorial com os recursos acima pode resultar em uma experiência de chat completa como esta: