Primeros pasos
Introducción
Las piezas de la plataforma y cómo encajan entre sí.
Esta plataforma administra agentes de IA: los configuras aquí, se ejecutan en contenedores aislados, y respondes por ellos desde un chat embebido en un sitio web o desde WhatsApp y Telegram.
La consola está en inglés. Esta documentación está en español y cita las
etiquetas de la interfaz tal como aparecen en pantalla — cuando leas
Environments es el botón que dice literalmente eso.
Las piezas
Un agente en producción toca cinco cosas. Vale la pena tener claro qué hace cada una antes de configurar nada, porque casi todos los problemas de configuración salen de confundir dos de ellas.
| Pieza | Qué es | Dónde vive |
|---|---|---|
| Agente | El modelo, el prompt y las herramientas habilitadas | Agents |
| Entorno | El contenedor donde corren esas herramientas | Environments |
| Servidor MCP | Herramientas de terceros que el agente puede llamar | MCP servers |
| Vault | La autenticación de esos servidores | Credential vaults |
| Canal o widget | Por dónde llega un mensaje al agente | Canales / API keys |
Un agente sin entorno responde igual: lo que pierde son las herramientas que necesitan ejecutar algo. Un agente sin canal ni clave funciona, pero solo desde la consola.
El modelo mental que importa
Configurar un agente y darle alcance son dos decisiones distintas, y la consola las separa a propósito.
En Agents → Configure decides qué dice y qué puede hacer: el prompt, el
modelo, las herramientas. En Canales y API keys decides quién puede
hablarle. Cambiar lo primero no toca lo segundo, y al revés — puedes repuntar un
canal a otro agente sin tocar su configuración, o cambiarle el modelo a un agente
sin que ninguna conversación en curso se entere.
Nota
La configuración de una sesión es inmutable: se copia entera cuando la sesión se crea. Si cambias el modelo de un agente, las conversaciones que ya estaban abiertas siguen con el anterior. Eso es deliberado y es lo que impide que una conversación cambie de comportamiento a mitad.
Cómo corre una respuesta
Cuando alguien escribe, pasa esto:
- El mensaje entra por su canal — el widget, el webhook de WhatsApp o el long-polling de Telegram.
- Se resuelve qué agente responde y si ese chat tiene permiso.
- Se busca o se crea una sesión, que es el hilo de la conversación.
- El agente ejecuta un turno: puede llamar herramientas, y cada llamada se registra.
- La respuesta sale por el mismo canal, y todo el turno queda en la sesión.
Ese registro es lo que después lees en Sessions, y lo que alimenta los números
de Usage y Cost.
Dónde seguir
Si vas a montar un agente por primera vez, Tu primer agente hace el recorrido completo.
Si lo que necesitas es poner el chat en el sitio de un cliente, salta directo a Insertar el widget.