Modelo de datos
Comprende las relaciones entre el inquilino principal, la configuración, Knowledge y Conversation.
Titularidad del inquilino
Una Organization es el inquilino principal. Los miembros se unen a una Organization con un único Role.
Los registros propiedad de la organización incluyen Assistants, Teammates, Memories, Help Desks, conexiones con proveedores, API keys, Skills, Improvements, Goals, Alerts y registros de uso.
Los registros de Teammate incluyen Projects, documentos de memoria, Routines y hilos de grupo. Un hilo de grupo conserva sus propios mensajes, no Conversations.
Configuración del asistente
Una Publication almacena una instantánea inmutable de la configuración de un Assistant. Los registros de borradores siguen siendo editables después de la Publication.
Un Flow almacena un desencadenante, la configuración de las condiciones y las acciones ordenadas. La validación en tiempo de ejecución garantiza que los pares de desencadenantes y acciones sean válidos.
Propiedad del conocimiento
El conocimiento pertenece a la Organización. Una Collection es un contenedor, no un propietario, y no decide qué Assistant responde a partir de una Source.
Eso lo hace el enlace de Asistente a Fuente. El proceso de recuperación lee el conjunto de enlaces, por lo que una Source sin enlazar no responde a nadie. El enlace también proporciona acceso directo por asistente.
Al eliminar un asistente, se suprimen sus enlaces y todas las fuentes permanecen donde están.
Datos de la conversación
Una Conversation pertenece a un Assistant o a un Teammate, nunca a ambos. Una Conversation de Assistant hace seguimiento de una única sesión de Visitor.
Una Teammate Conversation es un chat interno de un Member. No aparece en Inbox ni en Insights. Los mensajes almacenan partes escritas para texto, citas, botones, trazas y otras respuestas.
El estado de la sesión también registra la entrega proactiva de notificaciones. Una Notification no crea un mensaje de Visitor.
Los recuerdos a largo plazo pertenecen a una Organization y a un sujeto de SSO verificado. Almacenan un hecho duradero, un «embedding», marcas de tiempo y la procedencia de la conversación de origen.
El tiempo de ejecución limita cada sujeto a 200 recuerdos. La eliminación hace que un hecho deje de estar disponible para futuras inyecciones de prompts y búsquedas en la memoria.
Credenciales programáticas
Un registro de clave API pertenece a una Organización y almacena un hash secreto, un Rol, el creador y el estado de revocación. El secreto en texto plano no se almacena.
Aislamiento
El acceso autenticado a la consola utiliza seguridad a nivel de fila cuando procede. Las rutas de los roles de servicio deben añadir un límite explícito de Organization.
La API v1 utiliza la Organization determinada a partir de la clave de API. No acepta como autoridad una Organization seleccionada por el llamante.