Routines and headless

Concepts Clés : Automatisation avec Cloud Code

🤖 Routines (Automatisation Gérée)

• Définition : Un ensemble préconfiguré (prompt + dépôt + connecteurs) qui s'exécute sur l'infrastructure gérée par Anthropix.
• Avantage : Aucune machine locale à maintenir ; pas de fichier de workflow à gérer.
• Déclencheurs (Triggers) :
• Horaire (ex: schedule daily dependency audit at 9am).
• API (via POST HTTP).
• Événements GitHub (ex: nouvelle Pull Request).
• Limites :
• Prévisualisation de recherche (comportement et limites évolutifs).
• Fréquence maximale : une fois par heure.
• Sécurité : Les exécutions commencent toujours par un clone frais de la branche par défaut et ne peuvent pousser que vers des branches préfixées (sauf modification par dépôt).

⚙️ Modes d'Exécution Avancés

• Mode Headless (Contrôle Local) : Utilisé lorsque le travail nécessite votre environnement ou votre logique de pipeline.
• Flag -P (Pipe) : Exécute Cloud Code comme une commande unique (one-shot) sans interaction. Il lit l'entrée standard (stdin) et écrit la sortie standard (stdout), permettant le piping comme un outil shell classique.
• Flag --bear : Désactive la découverte automatique des hooks, compétences, plugins, serveurs MCP et fichiers MD Cloud. Permet d'exécuter uniquement les outils explicitement autorisés, accélérant le démarrage.

🛠️ Agent SDK (Intégration dans Applications)

• Fonction : Fournit une bibliothèque pour intégrer Cloud Code directement dans vos applications (TypeScript ou Python).
• Fonctionnalités : Expose une fonction de requête et les mêmes primitives que Cloud Code.
• Utilisation : Permet d'utiliser l'objet de correspondance de schéma pour interagir avec des bases de données SQL.

🧱 Gestion des Données et Automatisation Multi-Étapes

• Contrôle de Sortie : Associer un schéma JSON à un format de sortie JSON permet à Cloud de contraindre la structure de la sortie.
• Sortie Structurée : En combinant le format de sortie JSON et le schéma JSON, l'objet de correspondance est placé dans le champ structured output de la réponse JSON.
• Automatisation Séquentielle : Pour des tâches multi-étapes, capturez l'ID de session dans la sortie JSON pour reprendre le travail ultérieurement avec le contexte complet.

🎯 Résumé des Cas d'Usage

• Routines : Travail répétitif, exécution sur infrastructure gérée.
• Headless : Le travail nécessite votre pipeline local.
• -P : Piping de données à travers un script.
• --bear : Exécution CI nécessitant des résultats constants.
• Agent SDK : Le travail doit être intégré à votre propre produit.

Takeaways

• Les Routines sont des automatisations gérées (prompt + connecteurs) déclenchées par des événements (API, horaire, GitHub) sans maintenance locale.
• Le mode Headless et les flags (-P, --bear) offrent un contrôle local précis, permettant le piping (stdin/stdout) ou une exécution accélérée sans découverte automatique.
• L'Agent SDK fournit une bibliothèque pour intégrer les fonctionnalités de Cloud Code directement dans des applications (TypeScript ou Python).
• La gestion des données via schémas JSON permet de contraindre la sortie et d'assurer des automatisations séquentielles en capturant l'ID de session.