Conectar o agente ao fluxo do bot

O node Agente operacional conecta um Agente Avançado ao fluxo de bot. O bot chega ao node, o agente conduz a conversa e a execução retorna a um conector quando houver um resultado, pedido de humano ou erro.

O nome exibido no catálogo do bot é Agente operacional. Ele seleciona os agentes criados no construtor de Agentes Avançados; é diferente do node convencional Agente de Inteligência Artificial.

Antes de começar

• Salve e ative um agente com público Clientes pelo chatbot ou Equipe e clientes.
• Defina os resultados que devem devolver o atendimento ao bot.
• Tenha um fluxo de teste antes de associá-lo ao canal de atendimento.

Adicione o node no bot

Acesse Criar um fluxo do bot ou edite um fluxo existente.

1. Abra o editor visual.
2. No grupo IA, adicione Agente operacional.
3. Em Agente ativo, selecione o agente.
4. Conecte a entrada ao ponto em que a conversa deve passar à IA.
5. Confira Atendimento humano, Erro e as demais saídas do agente.

Ampliar

Desenhe os resultados no agente

Para ter uma saída agendado no bot:

1. No construtor do agente, adicione Retornar ao bot.
2. Dê o nome Agendamento concluído e a chave agendado.
3. Conecte-o à sequência que deve ocorrer depois de uma reserva confirmada.
4. Salve o agente.
5. No bot, clique em Atualizar saídas do agente.
6. Ligue o novo conector ao próximo node do bot.

Use Saída por regra quando o retorno depende de uma condição determinística. Use Retornar ao bot quando a IA pode escolher a saída pela situação descrita, ou quando uma sequência já determina o momento do retorno. Nenhum desses blocos possui saída posterior dentro do agente: eles encerram a execução e devolvem o controle ao bot.

Aproveite entradas e entidades da conversa

Em Entradas e resultado, mapeie cada informação necessária do bot para uma entrada do agente. Por exemplo:

Selecione o caminho real pelo picker. Os nomes do exemplo não são variáveis automáticas: precisam existir no seu fluxo e ser mapeados.

Oportunidade, contato ou empresa já vinculados à conversa podem ser identificados no contexto do agente. Isso permite reutilizar o vínculo e evitar pedir novamente a identificação do registro. Quando criar uma entidade no agente, marque Associar entidade à conversa se esse vínculo fizer parte do processo.

Envie um registro da lista, quando necessário

Para mensagens com códigos ou palavras-chave de muitos serviços/campanhas:

1. Cadastre códigos em um campo da lista marcado Usar na busca.
2. Antes do agente, adicione Carregar registro da lista.
3. Conecte a saída Encontrado ao Agente operacional.
4. Em Registro de contexto · opcional, selecione o registro carregado.
5. Se o namespace padrão foi mantido, a referência é catalogRecord.record.

O agente recebe a referência à linha e carrega os dados disponibilizados para seu uso. Esse recurso é opcional; um agente de agenda ou de dúvidas pode funcionar sem lista.

Conecte também Não encontrado, Duplicado e Erro do carregamento. Um código duplicado não deve escolher arbitrariamente um dos registros.

Devolva informações ao bot

Nos blocos de retorno, abra Dados devolvidos ao bot e selecione os valores que as próximas etapas precisam receber. No node do bot, mantenha Guardar resultado em como agentResult ou informe outro nome.

Se o retorno mapear nome, o próximo node poderá acessar agentResult.nome. Nome do namespace e campos devem coincidir com os mapeamentos salvos.

Conecte humano e erro

A saída Atendimento humano precisa levar ao destino real, como um node de transferência. A capacidade de atendimento humano encerra a participação da IA; não define sozinha qual departamento receberá a conversa.

A saída Erro deve levar a uma mensagem e/ou alternativa de atendimento. Não a conecte de volta ao mesmo agente sem uma condição de saída, para evitar repetição de falhas.

Valide antes de ativar no canal

Teste uma conversa completa no canal pretendido, incluindo dados vindos do bot, conclusão normal, desistência, erro e atendimento humano. Confira as opções e os horários na apresentação real do canal.

Referências: Agente operacional, Carregar registro da lista e Testar o agente.