Tutoriels Touba

Choisissez un parcours selon votre besoin. Chaque tutoriel présente le programme, les intégrations nécessaires et le résultat attendu.

Télécharger les exemples exécutables

Les archives contiennent le tutoriel publié, ses fichiers sources et un lanceur de validation. Après extraction, lisez README.txt et lancez node validate.mjs. Prérequis : Touba, Node.js 24 et un shell POSIX. Les exemples Python demandent aussi Python 3.11+ ; l'exercice de panne s'exécute sous macOS/Linux.

Exemple	Téléchargement
Package et consommateur	Archive
Engine JavaScript	Archive
Engine Python	Archive
Approbation avec rôle et reprise	Archive
Réponse HTTP perdue et arrêt brutal	Archive
Contrat du handler de compensation	Archive

Chaque exécution crée un dossier temporaire neuf. validation.json consigne la version/build de Touba utilisée et les assertions terminées ; provenance.json identifie la documentation et ses fichiers. Ces six exemples fonctionnent localement.

Choisir son SDK

Parcours	JavaScript	Python
Appeler Touba	Engine	Engine
Écrire un handler	Handlers	Handlers
Connecter un modèle	Provider	Provider

Les programmes Touba et leurs contrats sont communs aux deux SDK. Installez Touba et le SDK choisi avant de commencer. Les dépendances supplémentaires sont précisées dans chaque parcours.

Bases du langage

• Données typées, contraintes et valeurs par défaut.
• Tutoriel - Fonctions métier pures.
• Valeurs immuables avec define et bind.
• Classer des tickets typés.
• Tutoriel - Strategy, agents et skills.

Agents et modèles

• Tutoriel - Décision agentique gouvernée.
• Orchestration multi-agent et parallélisme borné.
• Traiter une liste en parallèle.
• Tutoriel - Utiliser les appels natifs sous autorité Touba.
• Tutoriel - SDK JavaScript, engine et provider.
• Tutoriel - SDK Python, engine et provider.

SDK et intégrations

• SDK JavaScript : appeler Touba.
• SDK Python : appeler Touba.
• SDK JavaScript : écrire un handler.
• SDK Python : écrire un handler.
• Tutoriel - Tool vers API publique avec le SDK Touba.
• Introduire Touba dans une orchestration Python.
• Tutoriel : contexte de package et tool gouverné.
• Tutoriel : créer un package et l'utiliser dans un autre projet.
• Tutoriel - Organiser un projet avec des imports purs.
• Importer un tool d’un autre module local.

Contexte et mémoire

• Conserver l'historique avec SQLite.
• Borner le contexte et comprendre la compaction.
• Tutoriel - Mémoire scopée avec agent.
• Mémoire avec backend hôte.
• Mémoire PostgreSQL avec agent et scopes.
• Séparer données externes et instructions.

Décisions et contrôle

• Tutoriel - Interaction humaine et validation.
• Approbations avec rôles, délais et escalade.
• Tutoriel - Secrets avec agent dédié.
• Tutoriel - Lire les refus sécurité.
• Validation avant effet externe.
• Trigger réel gouverné : revue matinale.
• Tutoriel - Borner un run avec les budgets d’autonomie.
• Tester un budget financier sans appel payant.
• Annulation, kill switch et timeout de run.

Audit et projets complets

• Explorer les ressources d'un projet.
• Tutoriel - Auditer une trace.
• Vérifier la supply chain d’un handler.
• Responsabilités multi-équipe et review gates.
• Données Québec : recherche réelle avec un agent gouverné.
• Gouvernance intégrée : du source au run planifié audité.
• Projet complet VS Code et JavaScript.