Gli strumenti che l'Agente riceve¶

Quando un Agente si collega a un Workspace riceve un elenco di strumenti, e quell'elenco è ciò che può fare lì dentro. È costruito sulla persona il cui token ha aperto la connessione: il suo ruolo, se occupa un posto, e com'è fatto il Workspace. Un Viewer riceve quattro strumenti, un Editor sei, un Owner nove.

L'elenco viaggia una volta sola, all'apertura della connessione: un cambio di ruolo o una Collection nuova si vedono nella sessione successiva, non in quella già avviata.

Strumenti di lettura, per tutti i ruoli¶

Questi quattro arrivano con qualunque ruolo, e per leggere non serve un posto.

get_workspace_informations è la porta d'ingresso. Dà il nome e la descrizione del Workspace e, in uno Strutturato, l'elenco delle sue Collections con i loro identificativi, i loro stati e le loro istruzioni. L'Agente prende da qui gli identificativi delle Collections, quindi di solito lo chiama per primo.
list_documents elenca i Documents di una Collection con il titolo e il riassunto, mai il contenuto. Può filtrare per stato, includere gli archiviati, e dice quando ha tagliato un elenco lungo.
search_documents cerca fra titoli, riassunti e identificativi, mai nel contenuto. La Collection è facoltativa: senza, cerca in tutto il Workspace.
get_document legge un Document per intero, contenuto compreso. Un Document archiviato torna comunque.

Due di questi dicono di cosa tratta un Document senza aprirlo, ed è il motivo per cui il riassunto che scrivi conta: è quello che un Agente legge prima di decidere cosa aprire.

Strumenti di scrittura, per Owner ed Editor con un posto¶

create_document crea un Document dentro una Collection.
update_document modifica un Document, lo archivia e lo riporta indietro. Richiede la data della versione che l'Agente ha letto, così due Agenti che lavorano insieme non si sovrascrivono in silenzio.

Chi potrebbe scrivere ma non occupa un posto tiene i quattro strumenti di lettura e perde questi due, e il rifiuto lo dice: parla del posto, non del ruolo.

Strumenti di livello Collection, per l'Owner¶

get_available_collection_types elenca i generi di Collection che si possono aprire, e dice quali il Workspace ha già.
create_collection ne apre una nuova, con il suo nome e i suoi stati.
update_collection_instructions scrive le istruzioni di una Collection, quelle che ogni Agente riceve collegandosi.

In un Workspace Semplice la Collection è una sola e l'Agente non vede quel livello: quei tre sono sostituiti da update_workspace_instructions, che scrive le stesse istruzioni senza nominare un contenitore che lì non ha ragione di esistere.

Azioni non disponibili a un Agente¶

Cancellare un Document. L'archiviazione è l'unico modo che un Agente ha di togliere qualcosa di mezzo, e un archivio non è un cestino.
Spostare un Document in un'altra Collection. Si fa dall'applicazione web.
Rinominare, disattivare o eliminare una Collection. Un Agente può aprirne una e scriverne le istruzioni, il resto resta a chi possiede il Workspace.
Dare un posto a qualcuno. I posti li assegna chi amministra l'Organizzazione che li paga.

Chi può fare cosa, ruolo per ruolo, sta nella pagina Ruoli. Come si collega un client sta in Collegare un Agente.