Conceptos básicos
Cinco palabras sostienen todo el producto. Todo lo demás de esta documentación se construye sobre ellas.
Organización
La frontera de facturación y gobernanza. Posee los miembros y sus roles, las credenciales de los proveedores de modelos, los secretos y el registro de auditoría. Todo dato de negocio pertenece exactamente a una organización, y el cliente de base de datos añade esa organización a cada consulta sobre él. Las lecturas entre organizaciones no son un permiso que pueda concederse. Cada rol se tiene en una organización y solo actúa sobre ella.
La edición Community permite una sola organización. Alojar varias organizaciones en una misma instancia es una capacidad de Enterprise.
Proyecto
El espacio de trabajo de un equipo dentro de una organización, con sus propios agentes, colecciones de conocimiento, servidores MCP, habilidades y claves de API. Un proyecto tiene sus propios miembros y su propio propietario, así que se puede dar un espacio a un equipo sin darle la organización.
Agente
Lo que usted configura: instrucciones, un modelo principal, modelos de respaldo opcionales, el conocimiento que puede leer, las herramientas que puede llamar, las habilidades que puede cargar y los guardarraíles que lo enmarcan. Un agente nunca se ejecuta directamente: lo que se ejecuta es siempre una versión.
Versión
Una instantánea congelada de la configuración de un agente, con un autor, una fecha y una nota opcional. Las versiones son inmutables: nunca se editan, y restaurar una antigua crea una versión nueva en lugar de retroceder. Las habilidades se resuelven al crear cada ejecución: la ejecución registra las versiones de habilidad que recibió, así que una repetición hace exactamente lo que hizo. Una nueva versión de una habilidad se aplica a las ejecuciones siguientes, incluso con una versión de agente sin cambios.
Esto es lo que hace auditable a un agente. Meses después, puede encontrar la versión exacta con la que se ejecutó una conversación, y cada ejecución conserva los accesos que se le dieron.
Ejecución
Cada vez que una versión trabaja, por ejemplo para responder a un mensaje, ese trabajo es una ejecución, registrada como una secuencia de eventos solo de adición. Una ejecución lleva sus propios permisos, congelados al crearse: si amplía los accesos de un agente mientras hay una ejecución en curso, esa ejecución conserva los accesos con los que empezó.
Las ejecuciones resisten las caídas. El motor se basa en un registro de eventos, con una clave de idempotencia por paso, así que una ejecución que se reanuda tras una caída no repite un efecto secundario ya producido.
Cómo se anidan
| Nivel | Contiene | Delimitado por |
|---|---|---|
| Organización | Miembros, roles, proveedores, secretos, registro de auditoría | Nada por encima |
| Proyecto | Agentes, colecciones, servidores MCP, habilidades, claves de API | Su organización |
| Agente | Versiones y permisos | Su proyecto |
| Versión | Una configuración congelada | Su agente |
| Ejecución | Eventos, pasos, costes | Su versión |
La configuración cambia, el historial no. Puede modificar un agente cuando quiera: cada guardado crea una versión nueva, y las versiones y ejecuciones ya registradas se quedan como estaban.