Développeurs · Édition du 14 novembre 2026
Créer ses propres outils
Deux voies existent : un logiciel externe qui utilise l’API/MCP, ou une modification des sources de l’application. Il n’existe pas de magasin de plugins ni de chargement sécurisé d’un script arbitraire depuis l’interface. Une modification des sources impose revue, tests et reconstruction des programmes.
Intégration externe recommandée
Créer une clé Studio limitée, lire via REST et utiliser les outils MCP d’écriture présents. Garder la clé côté serveur de son intégration. Les actions restent dans l’organisation de la clé. Pour recevoir des changements, utiliser les webhooks en tenant compte de leur absence de livraison durable.
Étendre le serveur depuis les sources
server.py porte le routeur et les contrôles génériques ; db.py gère SQLite/PostgreSQL ; les modules déclarent généralement ROUTES. static/js/main.js porte la navigation et static/js/pages les écrans. Ajouter un écran ne crée aucun droit.
Pour un nouvel endpoint, vérifier la session, le rôle, le module requis et company_id côté serveur. Pour une ressource précise, vérifier aussi son appartenance et les droits du demandeur. Ne jamais prendre company_id fourni par le client comme autorité. Éviter SQL interpolé, retour de clés et journalisation de données sensibles.
Étendre les outils d’agents
Dans agents.py, TOOLS décrit les outils, leur schéma, leur fonction et leur nature read, action ou approval. ROLES limite les noms accessibles selon le rôle. tools_for et call_tool appliquent ce choix, les pauses et budgets. Les outils approval ont un exécuteur séparé après décision humaine ; ne pas transformer une opération sensible en simple action pour éviter cette étape.
Exemple de conception à adapter, non API installable : un outil « compter mes tâches ouvertes » peut lire uniquement les tâches de ctx['cid'], renvoyer un compte et être ajouté aux seuls rôles concernés. Ne jamais exposer une fonction SQL libre au modèle. L’enregistrement d’un outil nécessite un changement dans les sources, pas un simple prompt.
Piloter un agent avec un modèle externe
Le contrat existant est GET /api/agents/contract/dirigeant pour le rôle dirigeant ; les autres contrats utilisent le template réellement présent. L’appel POST /api/agents/<id>/tool reçoit name, input et éventuellement run_id et model. Il exécute par call_tool, avec les droits du rôle et les validations prévues.
Ces routes internes utilisent une session applicative administrateur, pas une clé Studio oia_. Elles ne constituent pas une API publique d’administration déléguée. Les schémas de contrat, droits et budgets doivent être inspectés avant chaque intégration. Ne pas envoyer de cookie ou jeton de session à un fournisseur de modèle : seul le service contrôlé qui pilote l’agent appelle l’application.
Vérifier son extension
- Utiliser une base fictive distincte, sans SMTP ni paiement réel.
- Tester un compte autorisé, un membre refusé et une autre organisation.
- Tester les entrées invalides, la pause, le budget et la double soumission si l’outil écrit.
- Vérifier migrations SQLite et PostgreSQL lorsque l’extension doit supporter les deux.
- Actualiser le guide français et anglais, puis vérifier l’aide intégrée sur une question représentative.
- Reconstruire les paquets et essayer la mise à jour avec sauvegarde complète avant diffusion.
Les workflows de collecte et connexions préparés restent désactivés et masqués. Une extension ne doit pas lever ce verrou sans acceptation distincte. La documentation d’une possibilité technique ne constitue pas une activation.
Réaliser un premier outil de bout en bout
Suivre Créer un outil externe de lecture autorisé pour les prérequis, le fichier Python, les résultats attendus, les refus, l’isolation entre organisations et la révocation. Aucun accès aux sources privées ou licence de redistribution n’est fourni par cet exemple.