# 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-05-28T23:46:28.633Z

## Página

- Título: Agente de Inteligência Artificial
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/agente-de-inteligencia-artificial
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Encaminha mensagens para um agente de IA e segue a intenção identificada.

## Seções

- Quando usar
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Boas práticas e riscos comuns
- Como testar
- Guias relacionados

## Conteúdo da página

# Agente de Inteligência Artificial

Encaminha mensagens para um agente de IA e segue a intenção identificada. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções.

## Quando usar

- Use quando a intenção do cliente precisa ser interpretada com IA antes de decidir o próximo caminho.
- Aplique em triagens abertas, captura de variáveis e roteamento por intenção.

## Campos de configuração

- **Agente de IA**: agente previamente cadastrado.
- **Modelo de IA**: selecione o modelo (ex.: gpt-4o-mini).
- **Habilitar Transcrição de Áudio**: ativa transcrição quando aplicável.
- **Manter contexto entre conversas**: persiste a thread para reutilizar em novas conversas.
- **Omitir primeira mensagem do usuário**: ignora o texto que levou ao agente no primeiro turno.
- **Sobrescrever Primeiro Prompt**: define um prompt inicial customizado.

## Entradas e saídas

- Entradas: recebe 1 entrada.
- Saídas: usa saídas dinâmicas ou rotas especiais, conforme a configuração.
- Rota de segurança: usada quando falta configuração, ocorre falha ou a intenção não foi mapeada.
- Rotas por intenção: cada intenção configurada no agente pode abrir uma saída própria.

## Exemplo prático

Use o agente para identificar a intenção “segunda via”, “cancelamento” ou “falar com atendente” e encaminhar para rotas diferentes.

## Boas práticas e riscos comuns

- Evite deixar caminhos sem conexão quando o fluxo precisa continuar.
- Teste o comportamento quando a conversa já estiver com atendimento humano em andamento.
- Use nomes claros nas saídas para facilitar auditoria e manutenção.
- Mapeie intenções claras no agente para rotas objetivas.
- Use nós de mensagem/integração após cada intenção para ações específicas.

## Como testar

- Crie uma conversa de teste e execute o caminho principal.
- Force cada saída possível e confirme se a conversa continua, transfere ou encerra no ponto correto.
- Verifique o histórico da conversa para confirmar mensagens, transferência, encerramento ou retomada.

## Guias relacionados

- [Nodes de fluxos do bot](/docs/configuracao/referencias/nodes-fluxos-do-bot)
- [Guia geral de fluxos do bot](/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot)
- [Fluxos do bot](/docs/configuracao/fluxos-automacoes/fluxos-do-bot)