Resumen
Un AI Agent es un asistente configurable impulsado por LLM con su propio propósito, personalidad y guardrails. Cada agent apunta a un modelo preconfigurado, define cómo debe comportarse mediante prompts, y se puede probar en un playground de admin o ser alcanzado por clientes a través de un endpoint de chat. Para ver cómo encajan los Agents en la plataforma, consulta Conceptos básicos.Dónde encontrarlo
Los AI Agents están en Orchestration → AI Agents.Properties
| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | Sí | Nombre visible. |
slug | string | Auto | Identificador — generado desde el título si no se provee. |
purpose | string | No | Una descripción corta (hasta 100 caracteres). |
description | string | No | Una descripción extendida. |
provider | reference | Sí | El modelo sobre el que corre el agent (modelo + parámetros). |
context_window | integer | No | Cuántos pares de mensajes pasados se envían en cada llamada. Por defecto 20, rango 1–50. |
enabled | boolean | No | Un agent deshabilitado rechaza las peticiones de playground y de chat. Por defecto activado. |
Prompt y comportamiento
El comportamiento de un agent se ensambla desde varias partes, en orden:- System prompt — las instrucciones principales de rol y comportamiento del agent.
- Guardrails — condiciones bajo las cuales el agent debe detenerse o escalar.
- Brand guidance — tono, estilo y voz.
- Additional instructions — contexto extra en tiempo de ejecución.
- Datos del contact — cuando la conversación está ligada a un contact, su nombre, email, teléfono y attributes se agregan automáticamente, para personalizar las respuestas.
Los guardrails y el brand guidance se pueden escribir inline o tomar de un
Content Instance — útil para reutilizar la misma
política o voz de marca entre agents. Cuando se referencia un instance, este tiene
prioridad sobre el texto inline.
Modelos
Un agent referencia un modelo preconfigurado en lugar de API keys crudas — un bundle con nombre de un modelo LLM y sus parámetros (temperatura, longitud, timeout). Los modelos disponibles son:| Provider | Modelo | Variantes |
|---|---|---|
| Anthropic | Claude Sonnet 4.6 | Standard · Creative · Strict |
| OpenAI | GPT-4o | Standard · Creative · Strict |
| Gemini 2.0 Flash | Standard · Creative · Strict |
- Standard — salida balanceada.
- Creative — respuestas más variadas y largas.
- Strict — respuestas más enfocadas y deterministas, más cortas.
Modos de interacción
| Modo | Para | Comportamiento |
|---|---|---|
| Playground | Pruebas de admin | Un panel de chat en la página del agent. Stateless — cada petición lleva la conversación hasta ese punto; no se guarda nada. |
| Endpoint de chat | Clientes / integraciones | Un endpoint público protegido por API key. La conversación continúa entre turnos mediante una session. |
Sessions
El endpoint de chat mantiene una conversación viva con un session id:- En el primer mensaje, omítelo — el servidor genera uno y lo devuelve.
- Reenvíalo en cada mensaje siguiente para continuar la misma conversación.
- Las sessions son efímeras y expiran tras un periodo de inactividad; una vez expiradas, el siguiente mensaje inicia una conversación nueva.
- El historial se recorta al
context_windowdel agent para mantenerlo acotado.
Comportamiento y reglas
- Los agents deshabilitados rechazan peticiones — tanto el playground como el endpoint de chat devuelven un error si el agent (o su modelo) está deshabilitado.
- El context window acota la memoria — solo los últimos
context_windowpares de mensajes se envían al modelo en cada turno.
El uso de tools (que un agent llame funciones o realice acciones) está planeado
pero aún no disponible en esta versión.
Seeds
Los AI Agents aún no se soportan en Seeds.Gobernanza y permisos
Solo un super admin o un Master puede crear, editar, habilitar/deshabilitar y eliminar AI Agents.Acceso por API
Los agents se gestionan por la User API: CRUD completo, restore, una llamada de prueba en el playground, y un listado de los modelos disponibles. El endpoint de chat de cara al cliente se alcanza con una API key por la Contact API. Consulta la API reference.Relacionado
Conversations
Donde los agents sostienen conversaciones continuas.
Content Instances
Toma guardrails y brand guidance desde contenido.
Events & Automation
Orquesta cuándo y cómo se usan los agents.