Modèle de données
Comprenez les relations entre le tenant principal, la configuration, la Knowledge et la Conversation.
Propriété du tenant
Une Organization est le tenant principal. Les membres rejoignent une Organization avec un seul Role.
Les enregistrements appartenant à l'organisation comprennent les Assistants, les Teammates, les Memories, les Help Desks, les connexions aux fournisseurs, les clés API, les Skills, les Improvements, les Goals, les Alerts et les enregistrements d'utilisation.
Les enregistrements des Teammates comprennent les Projects, les documents de mémoire, les Routines et les fils de discussion de groupe. Un fil de discussion de groupe conserve ses propres messages, et non les Conversations.
Configuration de l'assistant
Une Publication stocke un instantané immuable de la configuration d'un Assistant. Les enregistrements de brouillons restent modifiables après la Publication.
Un Flow stocke un déclencheur, une configuration de condition et des actions ordonnées. La validation à l'exécution impose des paires déclencheur-action valides.
Propriété des connaissances
Les connaissances appartiennent à l'Organisation. Une Collection est un conteneur, pas un propriétaire, et elle ne décide pas quel Assistant répond à partir d'une Source.
C'est le lien Assistant-to-Source qui le fait. Le module de récupération lit l'ensemble des liens ; par conséquent, une Source non liée ne répond à aucun Assistant. Le lien confère également un accès direct par Assistant.
La suppression d'un Assistant supprime ses liens et laisse toutes les Sources en place.
Données de conversation
Une Conversation appartient à un Assistant ou à un Teammate, jamais aux deux. Une Conversation d'Assistant suit une session de Visiteur.
Une Conversation de coéquipier est une discussion interne d'un Member. Elle n'apparaît ni dans Inbox ni dans Insights. Les messages stockent les parties saisies pour le texte, les citations, les boutons, les traces et autres réponses.
L'état de la session enregistre également la remise proactive des Notifications. Une Notification ne crée pas de message Visitor.
Les Long-term Memories appartiennent à une seule Organization et à un sujet SSO vérifié. Ils stockent un fait durable, un embedding, des horodatages et la provenance de la Conversation source.
L'environnement d'exécution limite chaque sujet à 200 mémoires. La suppression retire un fait des futures injections de prompt et des recherches dans la mémoire.
Identifiants d'authentification programmatiques
Un enregistrement de clé API appartient à une Organisation et stocke un hachage secret, un Role, le créateur et l'état de révocation. Le secret en texte brut n'est pas stocké.
Isolation
L'accès authentifié à la console utilise la sécurité au niveau des lignes lorsque cela est applicable. Les chemins des rôles de service doivent ajouter une limite d'organisation explicite.
L'API v1 utilise l'organisation déterminée à partir de la clé API. Elle n'accepte pas une Organisation sélectionnée par l'appelant comme autorité.