A public-facing AI agent (WhatsApp/Chatwoot bot) managed from the
admin — README_AI_AGENTS.md §2.1. The agent acts "as a user": `user` is
a dedicated non-human account (is_staff=False, is_admin=False) whose
Django permissions decide which tools the agent's LLM even sees
(bots/capabilities.py), and whose identity signs every LogEntry and
invoice the agent creates. `agent_type` points at the code-side scaffold
(non-negotiable prompt rules + capability catalog + post-processing) in
bots/agent_types.py; `system_prompt` only carries the editable
personality/business rules on top of that scaffold.
| Campo |
Descrição |
| Chave |
Define a rota da URL do webhook do Chatwoot (bots///). Deve corresponder a uma entrada em ai_chat_s.bots.routing.AGENT_TENANTS. |
| Nome |
|
| Tipo de agente |
Estrutura no código: regras de prompt, catálogo de ferramentas e pós-processamento. |
|
Usuário do agente
|
Conta não humana com a qual este agente atua: suas permissões do Django determinam quais ferramentas o agente pode usar, e a auditoria/as notas fiscais são assinadas com ela. NUNCA deve ser um usuário administrador. |
| Ativado |
Interruptor de emergência: um agente desativado ignora todos os eventos de webhook. |
| Modo sombra |
O agente redige sua resposta como uma nota PRIVADA na conversa em vez de responder ao contato — um humano decide se a envia. Etapa obrigatória entre o benchmark offline e as respostas automáticas reais. |
| Token de API do tenant |
Obrigatório para assistentes de tenant: cole o token de API desta conta para comprovar a titularidade. |
Prompt
| Campo |
Descrição |
| Prompt do sistema |
Personalidade e regras de negócio editáveis. São acrescentadas à estrutura inegociável do tipo de agente — não podem substituir as regras de segurança da estrutura. |
| Modelo de LLM |
Chave do modelo de ai_chat_s.llm_providers.PROVIDER_REGISTRY. |
Canais
| Campo |
Descrição |
|
Canal do Chatwoot
|
A conexão do Chatwoot em que este agente escuta/responde. Vários agentes podem compartilhar uma. |
Horário comercial
| Campo |
Descrição |
| Impor horário comercial |
ATIVADO: fora do horário configurado, o agente envia apenas a mensagem de encerramento. DESATIVADO: o agente atende 24/7 e o horário configurado é injetado em seu prompt como informação (ex.: para agendar entregas) — um único lugar para mantê-lo. |
| Dias úteis |
Números dos dias da semana separados por vírgula, segunda=0 ... domingo=6 (ex.: "2,3,4,5,6"). Vazio significa todos os dias. |
| Abre às |
Vazio significa sempre aberto. |
| Fecha às |
|
| Mensagem de encerramento |
Resposta enviada fora do horário comercial. Vazio usa o padrão genérico. |
Humanização
| Campo |
Descrição |
| Atraso mínimo de resposta (segundos) |
Humanização: o agente espera um tempo aleatório entre o mínimo e o máximo antes de enviar sua resposta nos canais reais (Chatwoot). 0/0 responde imediatamente. O canal de teste iframe nunca sofre atraso. |
| Atraso máximo de resposta (segundos) |
|
| Janela de agrupamento de mensagens (segundos) |
As pessoas costumam dividir uma pergunta em várias mensagens rápidas. O agente espera esta quantidade de segundos após o ÚLTIMO fragmento (limite máximo: 25 segundos desde o primeiro) e responde a toda a sequência em um único turno. 0 desativa o agrupamento. Somente Chatwoot. |
Escalonamento
| Campo |
Descrição |
| ID do responsável pelo escalonamento |
ID do agente do Chatwoot para o qual as conversas são atribuídas quando o agente escala. |
| Mensagem de contingência |
Resposta enviada quando o agente encontra um erro inesperado. Vazio usa o padrão genérico. |
Parâmetros de capacidade
| Campo |
Descrição |
| Parâmetros de capacidade |
Per-type parameters, e.g. {"menu_category_id": 1723, "delivery_element_id": 123185}. For menu agents: "menu_include_images": false stops sending each product photo from the ERP, and "menu_card_image_url" sets the single menu-card image to share when the customer asks to see the menu. Attachments (all types): "attachments_enabled": false stops reading incoming photos/files, and "voice_transcription": false stops transcribing incoming voice notes — both cost money per message, and both default to true; when off, the agent still answers, asking the customer to write instead. |
Agentes de IA
Tiene los siguientes módulos relacionados y puede ser de su interés:
