Agente operacional
O node Agente operacional liga o fluxo de bot a um agente criado em Agentes Avançados. Enquanto o agente conduz a conversa, o bot aguarda um resultado que permita continuar.
Ele é diferente de Agente de Inteligência Artificial, usado para o agente convencional com conta OpenAI e intenções.
Onde configurar
Acesse Criar um fluxo do bot ou edite um fluxo existente. No editor, procure Agente operacional no grupo IA.
O recurso depende da liberação de Agentes Avançados para a conta. Antes de selecioná-lo, salve e ative um agente que aceite atendimento externo.
Campos de configuração
| Campo | Como usar |
|---|---|
| Agente ativo | Selecione um Agente Avançado ativo com público externo compatível. |
| Editar agente ↗ | Abre o cadastro selecionado para revisão. |
| Registro de contexto · opcional | Define qual referência de linha da lista será usada nesta execução. Pode vir de Carregar registro da lista ou de outra variável. |
| Atualizar saídas do agente | Sincroniza os resultados configurados no agente com os conectores do bot. |
| Entradas e resultado | Mapeia informações já capturadas no fluxo para entradas do agente. |
| Guardar resultado em | Namespace dos dados devolvidos ao bot; padrão agentResult. |
Entradas e saídas
Recebe uma entrada. Possui as saídas Atendimento humano e Erro, além das saídas criadas por Saída por regra e Retornar ao bot no agente.
| Resultado | Continuação |
|---|---|
| Conversa ainda em andamento | Permanece neste node aguardando as próximas mensagens. |
| Pedido de atendimento humano | Saída Atendimento humano. Conecte a uma transferência ou jornada válida. |
| Falha na execução | Saída Erro. Configure uma alternativa compreensível. |
| Retorno com chave própria | Conector correspondente, como agendado ou sem_interesse. |
As saídas de Apresentação e coleta são internas ao construtor do agente. Para elas aparecerem no bot, conecte o caminho a um bloco de retorno com chave própria.
Envie informações já conhecidas
No mapeamento de entradas, associe o nome nome a uma variável válida do bot. No agente, o valor estará em vars.nome. Faça o mesmo para e-mail, código ou outros dados necessários, usando o seletor de variáveis.
O agente também pode identificar a oportunidade, contato ou empresa já vinculados à sala. O vínculo não significa carregar indiscriminadamente todos os dados do CRM; cada capacidade obtém o que precisa no escopo autorizado.
Use uma linha de lista como contexto
Se Carregar registro da lista guardou o resultado em catalogRecord, escolha catalogRecord.record em Registro para este atendimento. A referência identifica a linha; os dados disponíveis ao agente vêm da configuração da lista.
Uma lista é opcional. Não configure um registro artificial para um agente que só precisa responder dúvidas ou trabalhar com uma agenda fixa.
Receba dados na continuação
No bloco de retorno do agente, mapeie os dados a devolver. Se ele devolver nome e o namespace for agentResult, use agentResult.nome nos próximos nodes do bot.
Depois de incluir, remover ou renomear uma saída no agente, salve-o e clique em Atualizar saídas do agente. As conexões são associadas pela chave; revise qualquer aviso de remoção de conectores.
Exemplo
Como testar
Confira agente ativo, entradas preenchidas e ausentes, conclusão com chave própria, pedido de humano, erro e dados devolvidos. Para agenda por link, confirme também a retomada após uma reserva real. Teste no canal em que o fluxo será usado.
Veja Conectar o agente ao fluxo do bot, Carregar registro da lista e diferenças entre agentes.