Modello dati
Comprendi le relazioni tra il tenant principale, la configurazione, la Knowledge e la Conversation.
Proprietà del tenant
Un'Organization è il tenant principale. I membri si uniscono a un'Organization con un unico Role.
I record di proprietà dell'organizzazione includono Assistants, Teammates, Memories, Help Desks, connessioni ai provider, API keys, Skills, Improvements, Goals, Alerts e record di utilizzo.
I record dei Teammate includono Projects, documenti di memoria, Routines e thread di gruppo. Un group thread conserva i propri messaggi, non le Conversations.
Configurazione dell'Assistente
Una Publication memorizza uno snapshot immutabile della configurazione di un Assistant. I record di tipo Draft rimangono modificabili anche dopo la Publication.
Un Flow memorizza un trigger, la configurazione delle condizioni e le azioni ordinate. La convalida in fase di runtime impone coppie valide di trigger e action.
Proprietà della conoscenza
La Knowledge appartiene all'Organization. Una Collection è un contenitore, non un proprietario, e non decide quale Assistant risponde da una Source.
È il collegamento Assistant-to-Source a farlo. Il modulo di recupero legge il set di collegamenti, quindi una Source non collegata non risponde a nessuno. Il link fornisce anche l'accesso diretto per ogni Assistente.
L'eliminazione di un Assistente rimuove i suoi collegamenti e lascia tutte le Source al loro posto.
Dati della conversazione
Una Conversation appartiene a un Assistant o a un Teammate, mai a entrambi. Una Conversation dell'Assistente tiene traccia di una singola sessione del Visitor.
Una Teammate Conversation è una chat interna di un Member. Non viene visualizzata in Inbox né in Insights. I messaggi memorizzano le parti digitate per testo, citazioni, pulsanti, tracce e altre risposte.
Lo stato della sessione registra anche l'invio proattivo delle Notification. Una Notification non crea un messaggio Visitor.
Le Long-term Memories appartengono a una Organization e a un soggetto SSO verificato. Memorizzano un fatto persistente, un embedding, i timestamp e la provenienza della Conversation di origine.
Il runtime limita ciascun soggetto a 200 memorie. L'eliminazione rimuove un fatto dalle future operazioni di prompt injection e dalle ricerche nella memoria.
Credenziali programmatiche
Un record di API-key appartiene a un'Organization e memorizza un hash segreto, un Role, il creator e lo stato di revoca. Il segreto in chiaro non viene memorizzato.
Isolamento
L'accesso autenticato alla console utilizza la sicurezza a livello di riga, ove applicabile. I percorsi dei ruoli di servizio devono aggiungere un limite esplicito dell'Organization.
L'API v1 utilizza l'Organization risolta dalla chiave API. Non accetta come autorità un'Organization selezionata dal chiamante.