> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla-gpt/agente-autonomo-v3.md).

# 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)*                                                         | <p><code>suporte</code></p><p><br></p><p><code>financeiro</code></p><p><br></p><p><code>corretor</code></p>    | 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?" | <p><code>fechou\_compra</code></p><p><br></p><p><code>recusou</code></p><p><br></p><p><code>humano</code></p>  | 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*                                                                                         | <p><code>send\_images</code></p><p><br></p><p><code>agendado</code></p><p><br></p><p><code>fallback</code></p> | 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.       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla-gpt/agente-autonomo-v3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.