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 |
Descripción |
| Llave técnica |
Rutea la URL del webhook de Chatwoot (bots///). Debe coincidir con una entrada de ai_chat_s.bots.routing.AGENT_TENANTS. |
| Nombre |
|
| Tipo de agente |
Armazón definido en código: reglas del prompt, catálogo de herramientas y post-procesamiento. |
|
Usuario del agente
|
Cuenta no humana con la que actúa este agente: sus permisos de Django deciden qué herramientas puede usar, y la auditoría/facturas se firman con ella. NUNCA debe ser un usuario administrador. |
| Habilitado |
Apagado de emergencia: un agente deshabilitado ignora todos los eventos del webhook. |
| Modo sombra |
El agente redacta su respuesta como nota PRIVADA en la conversación en vez de responderle al contacto — un humano decide si enviarla. Etapa obligatoria entre el benchmark y las respuestas automáticas reales. |
| Token de API de la cuenta |
Requerido para asistentes del tenant: pega el token de API de esta cuenta para demostrar propiedad. |
Prompt
| Campo |
Descripción |
| Prompt del sistema |
Personalidad y reglas de negocio editables. Se agrega al armazón innegociable del tipo de agente — no puede anular sus reglas de seguridad. |
| Modelo LLM |
Clave del modelo en ai_chat_s.llm_providers.PROVIDER_REGISTRY. |
Canales
| Campo |
Descripción |
|
Canal de Chatwoot
|
La conexión de Chatwoot por la que este agente escucha y responde. Varios agentes pueden compartir una. |
Horario de atención
| Campo |
Descripción |
| Aplicar horario de atención |
Activado: fuera del horario configurado el agente solo envía el mensaje de cerrado. Desactivado: el agente atiende 24/7 y el horario configurado se inyecta a su prompt como información (p. ej. para agendar entregas) — un solo lugar donde mantenerlo. |
| Días de atención |
Números de día separados por coma, lunes=0 ... domingo=6 (ej. "2,3,4,5,6"). Vacío significa todos los días. |
| Abre a las |
Vacío significa siempre abierto. |
| Cierra a las |
|
| Mensaje de cerrado |
Respuesta enviada fuera del horario de atención. Vacío usa el mensaje genérico. |
Humanización
| Campo |
Descripción |
| Retraso mínimo de respuesta (segundos) |
Humanización: el agente espera un tiempo aleatorio entre el mínimo y el máximo antes de enviar su respuesta en canales reales (Chatwoot). 0/0 responde de inmediato. El canal de pruebas iframe nunca se retrasa. |
| Retraso máximo de respuesta (segundos) |
|
Escalamiento
| Campo |
Descripción |
| ID del asignado al escalar |
ID del agente de Chatwoot al que se asignan las conversaciones cuando el agente escala. |
| Mensaje de contingencia |
Respuesta enviada cuando el agente tiene un error inesperado. Vacío usa el mensaje genérico. |
Parámetros de capacidades
| Campo |
Descripción |
| Parámetros de capacidades |
Parámetros por tipo, ej. {"menu_category_id": 1723, "delivery_element_id": 123185}. |
Agentes de IA
Tiene los siguientes módulos relacionados y puede ser de su interés:
Déjanos tus comentarios