Le dossier de votre entreprise
Votre entreprise vit dans un seul dossier de fichiers en texte simple : votre cap, vos offres, votre voix, vos règles, les objectifs de chaque service et ses savoir-faire. Votre IA le lit pour connaître votre entreprise, et y écrit pendant qu'elle travaille.
Ce que contient le dossier
direction.md,company.json,brand.jsonetAGENTS.md: qui vous êtes et comment votre bureau fonctionne.rules/: votre voix, vos offres, les informations de votre entreprise et vos règles maison.departments/: la page de chaque service, ses objectifs et ses rôles.skills/: les méthodes écrites pour faire chaque travail, avec leurs pages de référence. Ces pages d'aide y sont aussi, dansskills/get-help/references/.
Lire
read prend un seul des trois : path, list ou search. offset et version vont seulement avec un path.
Écrire un fichier
- Les chemins finissent par .md ou .json. Seul
templates/peut aussi contenir des fichiers .html. - Un chemin utilise seulement des lettres, des chiffres et . _ - /, jusqu'à 200 caractères, sans
..et sans//. - Le texte d'un fichier fait de 1 à 200 000 caractères.
writea besoin des quatre : path, body, base_version et note.- base_version est la version que
readvous a donnée, ou 0 pour un nouveau fichier. Si quelqu'un a changé le fichier entre-temps, une version périmée est refusée, et la réponse vous donne la version actuelle. Relisez le fichier et refaites le changement.
Les fichiers essentiels demandent un oui
Certains fichiers façonnent toute l'entreprise, alors ils ne changent qu'avec le oui du propriétaire : votre IA propose le changement (propose avec le kind file_change) et vous dites oui. Les fichiers essentiels sont AGENTS.md, company.json, direction.md, brand.json, tout ce qui est dans rules/, templates/ et connectors/, et chaque departments/<id>/goals.md.
Ce qui ne va jamais dans le dossier
- Les fichiers du site : les fichiers sous
sites/ne changent qu'avec deploy_site. - Les adresses e-mail ou numéros de téléphone des clients. Les personnes vont dans votre liste de personnes, et les autres informations vont dans les fiches.
- Les clés, les mots de passe ou tout ce qui y ressemble.
Les fiches
Les fiches gardent les données de votre entreprise par modules, comme les paiements, les réservations ou les pages, pour que votre tableau de bord puisse les montrer.
- Une fiche contient jusqu'à 20 000 caractères de données.
- La première fois qu'un module reçoit une fiche, votre IA nomme le service auquel elle appartient.
- Changer une fiche demande la version que vous avez lue. Une version périmée est refusée.
- Un module contient au plus 5 000 fiches.
- Votre IA ne peut supprimer que les fiches écrites par des agents, pendant qu'elle garde une tâche du service de ce module. Pour tout le reste, comme une réservation, un membre ou ce qu'une personne a écrit, elle demande la suppression avec une proposition record_delete, pour votre oui.