La cartella della tua azienda

La tua azienda vive in una cartella di semplici file di testo: la tua direzione, le tue offerte, la tua voce, le tue regole, gli obiettivi di ogni reparto e le sue competenze. La tua IA la legge per conoscere la tua azienda, e ci scrive mentre lavora.

Cosa c'è nella cartella

direction.md, company.json, brand.json e AGENTS.md: chi sei e come funziona il tuo ufficio.
rules/: la tua voce, le tue offerte, i dati della tua azienda e le tue regole di casa.
departments/: la pagina di ogni reparto, i suoi obiettivi e i suoi ruoli.
skills/: i modi scritti di fare ogni lavoro, con le loro pagine di riferimento. Anche queste pagine di aiuto sono lì, in skills/get-help/references/.

Leggere

read prende uno tra path, list o search. offset e version vanno solo con un path.

Scrivere un file

I percorsi finiscono in .md o .json. Solo templates/ può contenere anche file .html.
Un percorso usa solo lettere, cifre e . _ - /, fino a 200 caratteri, senza .. e senza //.
Il testo di un file va da 1 a 200.000 caratteri.
write ha bisogno di tutti e quattro: path, body, base_version e note.
base_version è la versione che ti ha dato read, oppure 0 per un file nuovo. Se qualcuno ha cambiato il file nel frattempo, una versione vecchia viene rifiutata, e la risposta ti dà quella attuale. Rileggilo e rifai la modifica.

I file centrali vogliono un sì

Alcuni file danno forma a tutta l'azienda, quindi cambiano solo con il sì del titolare: la tua IA propone la modifica (propose con kind file_change) e tu dici sì. I file centrali sono AGENTS.md, company.json, direction.md, brand.json, tutto quello che c'è in rules/, templates/ e connectors/, e ogni departments/<id>/goals.md.

Cosa non va mai nella cartella

I file del sito: i file sotto sites/ cambiano solo con deploy_site.
Gli indirizzi email o i numeri di telefono dei clienti. Le persone vanno nel tuo elenco delle persone, e gli altri dettagli vanno negli elementi.
Chiavi, password o qualsiasi cosa che sembri una di queste.

Elementi

Gli elementi contengono i dati della tua azienda divisi in moduli, come pagamenti, prenotazioni o pagine, così il tuo pannello li può mostrare.

Un elemento contiene fino a 20.000 caratteri di dati.
La prima volta che un modulo riceve un elemento, la tua IA dice a quale reparto appartiene.
Per cambiare un elemento serve la versione che hai letto. Una versione vecchia viene rifiutata.
Un modulo contiene al massimo 5.000 elementi.
La tua IA può cancellare solo gli elementi scritti dagli agenti, mentre tiene un'attività nel reparto di quel modulo. Per tutto il resto, come una prenotazione, un membro o quello che ha scritto una persona, chiede di cancellare con una proposta record_delete, per il tuo sì.