> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Configure Agentes de IA para Atendimento Automatizado
> Crie agentes de IA no PanÐá Zap que respondem clientes, atualizam dados do CRM, chamam sistemas externos e transferem o atendimento para humanos de forma inteligente.
Diferente do Fluxo de Conversa — que segue uma árvore de conversa fixa e pré-definida —, um Agente de IA responde de forma livre e contextual com base em uma base de conhecimento fornecida por você.
**Agentes de IA é um recurso em beta.** O comportamento pode mudar entre versões. Os custos de uso da API de IA (tokens, requisições) são cobrados diretamente pelo seu provedor — OpenAI, Anthropic, Groq, Google ou qualquer serviço que você configurar. O PanÐá Zap não cobra pelo uso de IA.
Você define a personalidade, os temas permitidos e o tom, e o agente cuida do resto: responde perguntas, registra dados de contato, movimenta contatos pelo funil, chama sistemas externos e transfere para um agente humano de forma inteligente quando a conversa exigir.
## Criar um Agente de IA
Vá em **Automação → Agentes de IA** e clique em **Novo Agente**. O formulário de criação é organizado em cinco abas.
| Aba | Finalidade |
| ---------------- | --------------------------------------------------------- |
| **Perfil** | Identidade do agente, instruções e comportamento de saída |
| **Provedor** | Modelo de IA, chave de API e configurações de geração |
| **Conhecimento** | Artigos e documentos que o agente pode consultar |
| **Roteamento** | Destinos de transferência inteligente e fila de reserva |
| **Ferramentas** | Ações, captura de dados e chamadas de webhook externas |
### Aba Perfil
| Campo | Descrição |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Nome** | Rótulo interno (por exemplo, "Suporte Pré-vendas") |
| **Ativo** | Desative durante a configuração; ative quando estiver pronto para entrar em produção |
| **Descrição** | Nota breve sobre o que este agente atende |
| **Tom e instruções** | O prompt do sistema — defina a personalidade do agente, os temas permitidos, o estilo de comunicação e quaisquer regras rígidas |
| **Palavra-chave de saída** | Quando um cliente digita essa palavra, o agente para e transfere para uma fila humana |
### Aba Provedor
| Campo | Descrição |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Chave de API** | Chave da OpenAI, Anthropic, Groq, Google Gemini ou qualquer endpoint compatível com OpenAI |
| **URL Base** | Deixe em branco para OpenAI. Preencha para LiteLLM, LocalAI, Ollama ou outros serviços compatíveis |
| **Modelo** | O modelo a ser usado (por exemplo, `gpt-4o-mini`, `gemini-1.5-flash`, `claude-3-haiku`) |
| **Mensagens lembradas** | Número de turnos anteriores da conversa que o agente pode ver (padrão: 20) |
| **Criatividade** | Configuração de temperatura — valores mais baixos geram respostas mais consistentes; valores mais altos, respostas mais variadas |
### Aba Conhecimento
| Campo | Descrição |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Habilitar base de conhecimento** | Ative para permitir que o agente consulte artigos e documentos |
| **Busca inteligente** | Entende sinônimos e intenção, em vez de exigir correspondência exata de palavras-chave |
| **Adicionar artigos** | Crie entradas com um **Título** e **Conteúdo** — escreva como se estivesse explicando para um cliente |
| **Importar fontes** | Envie arquivos **PDF**, **DOCX**, **XLSX**, **CSV** ou **TXT** (máx. 10 MB cada), cole uma **URL** ou importe um **CSV de FAQ** |
Documentos PDF escaneados **não** são indexados. Apenas arquivos baseados em texto são suportados. Se seus PDFs foram criados a partir da digitalização de páginas físicas, converta-os para texto selecionável antes de enviar.
### Aba Roteamento
Ative a **Transferência Inteligente** para permitir que o agente direcione conversas a agentes humanos com base no assunto.
| Campo | Descrição |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rótulo** | Nome interno para este destino |
| **Tipo** | Atualmente: Fila |
| **Fila** | A fila para a qual transferir |
| **Quando transferir** | Descrição em linguagem natural dos cenários que devem disparar essa transferência (por exemplo, "cobrança, faturas, problemas de pagamento") |
| **Mensagem de transferência** | Mensagem opcional enviada ao cliente quando a transferência é disparada |
| **Mensagem de transferência padrão** | Mensagem de reserva usada quando nenhuma mensagem específica do destino está configurada |
| **Resumo automático na transferência** | Registra uma nota com resumo gerado por IA no ticket, para que o agente receptor tenha contexto completo |
| **Fila de emergência** | Fila de reserva usada se o serviço de IA ficar indisponível ou retornar erro |
### Aba Ferramentas
**Ações** — disparam atualizações no CRM automaticamente durante a conversa:
* O que fazer (aplicar uma tag ou mover o contato no funil)
* Destino (a tag ou o estágio do funil)
* Quando disparar (descrição em linguagem natural, por exemplo, "depois que o cliente demonstrar interesse em um plano")
* Mensagem opcional a ser enviada quando a ação disparar
**Dados a registrar** — campos a capturar e salvar diretamente no perfil do contato (por exemplo, `email`, `numero_pedido`, `cpf`). O agente extrai e armazena esses valores durante a conversa.
**Ferramentas (webhooks externos)** — conectam o agente a sistemas externos:
* Nome
* Senha de acesso (opcional — usada para autenticar a chamada do webhook)
* URL do webhook
* Quando usar (descrição em linguagem natural dos cenários que devem disparar essa chamada)
* Campos de informação que o agente envia junto com a requisição
## Ativar e Vincular um Agente
1. Na aba **Perfil**, ative a opção **Ativo** e salve.
2. Vincule o agente a um canal: vá em **Administração → Canais**, edite o canal desejado, encontre a seção **Agente de IA**, selecione este agente e salve.
3. Alternativamente, adicione o agente como uma interação dentro de uma etapa do **Fluxo de Conversa** para usá-lo dentro de um fluxo automatizado maior.
## Monitorando Conversas ao Vivo
Tickets sendo atendidos por um agente de IA aparecem na aba **Pendente** com um **ícone de IA**. Qualquer agente humano pode assumir a conversa a qualquer momento clicando no ticket — o agente de IA para de responder assim que um humano entra na conversa.