Modelo de datos
Comprende las relaciones entre el inquilino principal, la configuración, el conocimiento y la conversación.
Propiedad del inquilino
Una Organización es el inquilino principal. Los miembros se unen a una organización con un rol.
Los registros propiedad de la organización incluyen Asistentes, Entidades, Memorias, Servicios de asistencia, conexiones con proveedores, claves de API, Habilidades, Mejoras, Objetivos, Alertas y registros de uso.
Configuración del asistente
Una Publicación almacena una instantánea inmutable de la configuración del Asistente. Los registros en borrador siguen siendo editables después de la publicación.
Un Flow almacena un desencadenante, la configuración de la condición y las acciones ordenadas. La validación en tiempo de ejecución garantiza que los pares de desencadenante y acción sean válidos.
Un Asistente selecciona esquemas de Entidad para su próxima Publicación. La instantánea del esquema controla las herramientas generadas, mientras que cada consulta lee los Registros actuales.
Las Entidades compartidas exponen datos comunes de la Organización. Las Entidades con ámbito de usuario nombran un atributo de identidad para el filtrado vinculado al servidor.
Propiedad del conocimiento
El conocimiento pertenece a la Organización. Una Collection es un contenedor, no un propietario, y no decide qué Assistant responde desde una Source.
El enlace de Asistente a Fuente es el que lo hace. La recuperación lee el conjunto de enlaces, por lo que una fuente no enlazada no responde a nadie. El enlace también incluye acceso directo por asistente.
Al eliminar un Asistente, se eliminan sus enlaces y todas las Fuentes permanecen en su lugar.
Datos de la conversación
Una Conversación pertenece al Asistente que la atiende y realiza un seguimiento de una sesión de Visitante. Los mensajes almacenan partes escritas para texto, citas, botones, seguimientos y otras respuestas.
El estado de la sesión también registra la entrega proactiva de notificaciones. Una notificación no crea un mensaje de visitante.
Las memorias a largo plazo pertenecen a una organización y a un sujeto SSO verificado. Almacenan un hecho duradero, la incrustación, las marcas de tiempo y la procedencia de la conversación de origen.
El tiempo de ejecución limita cada tema a 200 memorias. Al eliminarlo, se elimina un hecho de futuras inyecciones de indicaciones 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, un creador y un 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 corresponde. Las rutas de los roles de servicio deben añadir un límite explícito de organización.
La API v1 utiliza la organización resuelta a partir de la clave de la API. No acepta como autoridad una organización seleccionada por el llamante.