Agents as Code
Avec Touba, la responsabilité d’un agent fait partie du programme. Ses capacités, ses appelants autorisés et ses limites se lisent dans des fichiers que l’équipe peut versionner, tester et relire avant l’exécution.
Déclarer une responsabilité
Ce fragment confie la préparation d’un dossier à un agent. Le skill
PrepareCase est déclaré ailleurs dans le programme.
agent CaseReviewer
responsibility "Prepare a reimbursement case for human review."
uses PrepareCase
callable_by strategy ReviewReimbursements
| Déclaration | Rôle |
|---|---|
responsibility | Expliquer la mission de l’agent |
uses | Définir les capacités qu’il peut sélectionner |
callable_by | Désigner les déclarations autorisées à l’appeler |
La mission guide le modèle. Les contrats d’appel et les permissions sont vérifiés par Touba à l’exécution.
Préparer, relire, exécuter
Dans un projet initialisé, la préparation produit les artefacts nécessaires à partir des sources et de la configuration du projet :
touba prepare
touba prepare --mode check
La revue porte sur quatre questions :
- Mission : quel résultat chaque agent doit-il produire ?
- Accès : quels tools, agents, mémoires et secrets sont accessibles ?
- Contrôle : quelles approbations et limites s’appliquent ?
- Preuve : quelles traces permettront de comprendre le déroulement ?
Le guide du projet Touba détaille cette préparation ; le guide d’audit explique la lecture des exécutions et des refus.
Organiser les artefacts
| Élément | Usage dans l’équipe |
|---|---|
Sources .tb, configuration et manifests | Versionner les contrats et relire les changements |
| Packages et lock d’intégrité | Identifier les dépendances exactes |
| AIR et plan d’exécution | Inspecter le programme compilé |
| Traces et rapports d’audit | Relier une action à son exécution et à son contrat |
Les secrets et les données d’exécution sensibles restent dans le stockage prévu pour eux. Avant de partager une trace, appliquez la politique de masquage et d’export du projet.
Pour continuer
- Composants Touba : du source au handler.
- Créer et partager un package : réutiliser des composants.
- Revue en équipe : propriétaires et approbation des changements.