Agente Autônomo V3

Visão Geral

O Componente de Agente Autônomo V3 (identificado internamente no sistema como habllaAgentV3) é um nó de inteligência e roteamento dinâmico avançado. Sua função principal é delegar o atendimento a um agente virtual de IA predefinido, permitindo que ele conduza conversas fluidas com o usuário de forma autônoma.

O diferencial deste componente é a sua arquitetura de Saídas Baseadas em Condições de Sucesso: o agente opera em loops interativos com o cliente e o contato só avança no canvas da automação quando uma das metas ou condições mapeadas nas ferramentas do robô de IA é totalmente satisfeita, acionando a porta de roteamento correspondente.

Parâmetros de Configuração

A parametrização do nó gerencia a escolha do robô, o controle de estímulo de inicialização e a injeção de metadados transacionais:

• Agente (* Campo Obrigatório): Menu suspenso utilizado para selecionar qual Agente de IA (previamente treinado e configurado na plataforma) assumirá o controle da conversa nesse estágio do fluxo.

• Habilidade do agente: Dropdown condicional que define o escopo operacional específico ou o conjunto de ferramentas e instruções de especialidade (skills) que o robô priorizará durante o atendimento.

• Habilitar prompt (Chave de Alternância - Toggle Switch): Controla o modo de inicialização da conversa:

  • Desmarcado (Desativado): O agente permanece passivo, aguardando e usando a última mensagem de texto enviada pelo cliente no chat para engajar na conversa.

  • Marcado (Ativado): Obriga o administrador a fornecer uma diretriz manual de partida para que o robô inicie o contato de forma ativa.

• Prompt * (* Obrigatório se chave ativa): Caixa de texto contextual onde se digita a instrução de saudação ou comando operacional inicial. Esse texto funciona estritamente como o gatilho da primeira interação do agente com o cliente; as mensagens subsequentes seguirão o fluxo conversacional natural.

• Variáveis * (* Campo Obrigatório): Bloco de mapeamento em formato de lista (Chave e Valor) para injetar dados do perfil do usuário diretamente na memória de contexto da IA (ex: nome e celular), permitindo interações hiperpersonalizadas.

Construtor Visual

A interface gráfica é adaptativa e modifica a morfologia física do nó no canvas de automação de acordo com os recursos herdados:

• Mapeamento de Portas de Saída Mutáveis: No editor de design de fluxos, este componente não possui saídas genéricas estáticas. Assim que o administrador escolhe um Agente, o bloco renderiza dinamicamente portas físicas laterais correspondentes a cada intenção ou gatilho de sucesso configurado na raiz da IA (como saídas para finalidades específicas de departamentos, chamados ou transições).

• Sinalizadores de Estado e Timeout: O nó exibe em sua base pequenos badges visuais de controle de erro (sinal de alerta) e monitoramento cronológico (sinal de relógio), permitindo conectar fluxos alternativos de contingência caso o servidor de IA falhe ou a sessão do cliente expire.

Operadores Especiais

As propriedades lógicas deste componente gerenciam a sustentação de sessão conversacional e a injeção de payloads:

• Retenção de Estado Conversacional (Session Standby Loop): Ao entrar neste nó, a esteira tradicional de automação linear é pausada. O motor cria uma sessão persistente entre a API de IA e o chat do cliente. Cada nova mensagem enviada pelo usuário é processada pelo modelo de linguagem e respondida autonomamente pelo robô, sem sair do bloco, até que o critério de transição de uma das portas de saída seja atingido.

• Interpolação de Metadados de Contexto: Os campos do repetidor Variáveis e da caixa Prompt suportam nativamente o uso de chaves duplas {{...}}. Isso garante resgatar chaves do CRM de nós anteriores e entregá-las formatadas para o processamento neural do agente.

Exemplos Práticos

A tabela abaixo demonstra cenários tradicionais de como configurar o comportamento de inicialização e saídas do Agente Autônomo V3:

Agente Selecionado	Chave "Habilitar prompt"	Configuração do Prompt Inicial	Saídas Disponíveis no Nó	Caso de Uso Prático
Receptivo IA	Desativada	Nenhum (Inicia com o input do usuário)	suporte financeiro corretor	O cliente envia uma mensagem vaga na DM. O Agente de IA assume, conversa livremente com ele e, assim que identifica que o desejo do cliente é comprar um imóvel, despacha o contato pela saída física corretor.
Agente Vendas	Ativada	"Olá {{nome}}! Notei que você abandonou o carrinho do plano. Gostaria de tirar alguma dúvida?"	fechou_compra recusou humano	O componente é usado em um fluxo ativo baseado em tempo. A IA inicia a conversa ativamente com a frase do prompt. Se ela convencer o cliente, sai por fechou_compra; se o cliente pedir para falar com uma pessoa, sai por humano.
Triagem Geral	Desativada	Nenhum	send_images agendado fallback	O bot conversa com o cliente para coletar documentos para um cadastro. Assim que o usuário envia os arquivos solicitados, a IA valida o recebimento e roteia o contato pela saída de sucesso send_images para seguir no fluxo.