# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-10-30T16:46:38.022Z

## Página

- Título: Agente operacional
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-operacional
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Executa um Agente Avançado no chatbot, envia contexto e continua pelas saídas configuradas.

## Seções

- Onde configurar
- Campos de configuração
- Entradas e saídas
- Envie informações já conhecidas
- Use uma linha de lista como contexto
- Receba dados na continuação
- Exemplo
- Como testar

## Conteúdo da página

# 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 :ScreenEntry{href="https://my.agilize.app/messenger/bot/flow/create" label="Criar um fluxo do bot" path="Configurações > Mensageria > Bots / Fluxos Automáticos"} 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.

![Node Agente operacional com seleção de agente, registro de contexto e resultado](/docs/screenshots/agentes-avancados/bot-agente-operacional.png)

## 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

---
title: "Bot, contexto opcional e agente"
caption: "Trate também falhas e referências ambíguas antes de entrar na IA."
definition: |
  flowchart LR
    I[Início do bot] --> L[Carregar registro da lista: opcional]
    L -->|Encontrado| A[Agente operacional]
    L -->|Não encontrado ou duplicado| P[Pedir referência ou oferecer ajuda]
    L -->|Erro| E[Alternativa de atendimento]
    A -->|Agendado| C[Mensagem ou próxima etapa]
    A -->|Atendimento humano| H[Transferir para equipe]
    A -->|Erro| E
---

## 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](/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-fluxo-bot), [Carregar registro da lista](/docs/configuracao/referencias/nodes-fluxos-do-bot/carregar-registro-da-lista) e [diferenças entre agentes](/docs/configuracao/inteligencia-artificial/qual-agente-de-ia-usar).