Organizzazione, Workspace, Collections e Documents¶

Quello che un progetto sa vive in cose annidate: una Organizzazione, i Workspace che possiede, le Collections dentro di loro, e i Documents dentro quelle. La prima è l'unica che potresti non incontrare mai, ed è voluto.

Organizzazione¶

Una Organizzazione possiede i Workspace. È a lei che è intestato il piano, ed è su di lei che si contano i posti con cui gli Utenti scrivono.

Ogni account ne ha una dal giorno in cui nasce, e resta fuori dalla vista finché sei l'unica persona che ci sta dentro. Se lavori da solo non incontri la parola da nessuna parte, e niente ti chiede di occupartene.

Compare quando inizia a fare differenza, cioè quando entra qualcun altro. Apri un tuo Workspace a un'altra persona e quel Workspace si sposta in una tua Organizzazione condivisa, creata a quel primo invito. Se con quella stessa persona condividi già un altro Workspace, si riusa l'Organizzazione che esiste invece di aprirne una seconda.

Da lì in poi Meridiaan la nomina dove un'azione dipende da quale Organizzazione stai usando, e tace dove non aggiunge niente. Non diventa mai un livello di navigazione: continui ad aprire un Workspace, non l'Organizzazione che lo contiene.

Cosa fa il primo invito a un Workspace:

Da questo discendono alcune cose:

• Una Organizzazione condivisa nasce senza piano, e in un Workspace che le appartiene non si può scrivere finché un piano non viene scelto. È una condizione dichiarata, non un guasto: la scioglie chi amministra l'Organizzazione scegliendo un piano.
• Nasce senza nome, e mostra il proprio identificativo finché qualcuno non gliene dà uno. Quel nome lo leggono tutti gli Utenti che ci stanno dentro.
• Una persona può amministrarne più di una, ciascuna con il suo piano e la sua fattura.
• Essere Admin di una Organizzazione ed essere Owner di un Workspace sono due cose diverse, a due livelli diversi. Ogni volta che una delle due parole compare, dice di cosa si è Admin, o di cosa si è Owner.

Chi paga, cosa sia un posto e chi ne occupa uno stanno nella pagina Piani e posti.

Workspace¶

Un Workspace è la knowledge base di un progetto. Contiene le Collections, gli Utenti invitati e la connessione con cui un Agente lo raggiunge: ogni Workspace ha un proprio endpoint MCP, protetto da una chiave sua.

L'accesso si dà per singolo Workspace, non una volta per tutto: inviti una persona al Workspace in cui la vuoi, con il ruolo che le vuoi dare. Gli altri Workspace della stessa Organizzazione le restano invisibili, compresi quelli personali.

Collections¶

Una Collection raccoglie i Documents dello stesso genere dentro un Workspace. Un Workspace che segue un software può tenere le decisioni in una Collection, le domande ancora aperte in un'altra e il riferimento tecnico in una terza.

Due cose fanno di una Collection più di una cartella:

• Un workflow, quando ce l'ha. Una Collection può dichiarare gli stati in cui i suoi Documents si muovono, e un Document può prendere solo quelli. Una Collection senza workflow non ha stati.
• Le istruzioni scritte dall'Owner. Dicono come quella Collection vuole essere scritta, e l'Agente le riceve quando si collega: la regola viaggia con la Collection invece di stare in un prompt che qualcuno deve ricordarsi.

È l'Owner a decidere quali Collections esistono, come si chiamano e se vengono esposte agli Agenti.

Documents¶

Un Document è l'unità di contenuto: un titolo, un riassunto di cosa tratta, e il contenuto vero e proprio. Quando la sua Collection dichiara un workflow, il Document porta anche uno di quegli stati.

Un Document si può archiviare quando smette di essere attuale, così resta leggibile senza stare fra i piedi, e un singolo Document si può tenere fuori da quello che gli Agenti vedono.

Il riassunto conta più di quanto sembri: quando un Agente elenca una Collection legge i titoli e i riassunti, e da quelli decide quali Documents aprire per intero.

Panoramica dei permessi¶

Cambiare la forma di un Workspace, cioè creare, rinominare o cancellare una Collection e scriverne le istruzioni, è riservato al suo Owner. Chi collabora lavora sui Documents dentro le Collections che esistono. La pagina Ruoli descrive i tre ruoli uno per uno.