# 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:45:08.316Z

## Página

- Título: Conectar o agente ao fluxo do bot
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-fluxo-bot
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Use o node Agente operacional, envie contexto e conecte as saídas do agente à continuação do atendimento.

## Seções

- Antes de começar
- Adicione o node no bot
- Desenhe os resultados no agente
- Aproveite entradas e entidades da conversa
- Envie um registro da lista, quando necessário
- Devolva informações ao bot
- Conecte humano e erro
- Valide antes de ativar no canal

## Conteúdo da página

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

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.

![Configuração do node Agente operacional no fluxo do bot](/docs/screenshots/agentes-avancados/bot-agente-operacional.png)

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

| Variável disponível no bot | Nome da entrada | Uso no agente |
| --- | --- | --- |
| Uma variável que guarda o nome capturado | `nome` | `vars.nome` |
| Código da campanha ou serviço | `codigo` | `vars.codigo` |
| E-mail capturado anteriormente | `email` | `vars.email` |

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](/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-operacional), [Carregar registro da lista](/docs/configuracao/referencias/nodes-fluxos-do-bot/carregar-registro-da-lista) e [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente).