Encadrer un agent externe
Définissez les accès, les actions permises et les contrôles d’un agent connecté à votre Brain.
Objectif : donner une mission limitée à un agent externe et vérifier son résultat. Les clients MCP et API peuvent utiliser Orbit aujourd’hui. Des agents Orbit autonomes, avec leur propre orchestration dans le produit, restent une évolution à venir.
Écrivez le contrat de mission
Mission : préparer [livrable précis].
Contexte autorisé : [espaces et sources sélectionnés dans la connexion].
Actions permises : rechercher, citer les preuves et rédiger un brouillon.
Actions nécessitant mon accord : modifier le Brain, générer avec des crédits,
communiquer à l’extérieur ou publier.
En cas de manque : signaler l’information absente, sans l’inventer.
Résultat attendu : [format], sources utilisées et points restant à vérifier.
Les consignes dans un prompt ne remplacent pas les permissions. Retirez aussi les accès techniques inutiles dans la connexion. Un agent qui n’a besoin que de lire ne doit pas recevoir un accès de génération payante.
Avant le premier essai, vérifiez le compte connecté, les espaces autorisés et les capacités accordées. Une adhésion au programme Partenaires ne donne pas accès aux espaces clients d'un autre compte.
Les capacités et leurs limites
| Capacité actuelle | Ce qu’elle permet | Contrôle nécessaire |
|---|---|---|
| Context Pack et recherche | Retrouver des informations autorisées | Vérifier preuves, pertinence et résultat incomplet |
| Vérification d’alignement | Comparer un texte au contexte retrouvé | Une absence de preuve n’est pas une approbation |
| Proposition | Soumettre une modification ou une Skill | Validation humaine dans Brain → Revue |
| Écriture directe | Ajouter une mémoire avec le droit adapté | Ne pas confondre ce chemin avec une proposition |
| Journal d’activité | Enregistrer les actions déclarées par un client | Une trace ne prouve pas à elle seule la réussite externe |
| Studio | Lancer les générations autorisées | Prix, budget et qualité du résultat |
Testez avant de déléguer davantage
Commencez par une lecture
Demandez un fait connu et sa source. Vérifiez l’espace utilisé et assurez-vous qu’un espace non autorisé ne devient pas accessible par une autre demande.
Testez le manque d’information
Posez une question dont le Brain ne contient pas la réponse. Le bon comportement consiste à signaler le manque, pas à produire une certitude non sourcée.
Ajoutez une seule action
Si le besoin est réel, accordez un accès supplémentaire et testez-le sur un cas contrôlé. Pour une modification durable, préférez un workflow de proposition que vous relisez dans Orbit.
Vérifiez le résultat et les traces
Ouvrez le livrable ou la création réelle. Une déclaration de réussite ou une entrée de journal ne remplace pas cette vérification. Révoquez la connexion lorsqu’elle n’est plus utile, puis vérifiez qu'une nouvelle demande par cette connexion est refusée.
Lire l’activité sans polluer la mémoire
Brain → Activité des agents présente un journal en ajout seul, conservé 180 jours. Les accès de lecture et d’écriture du journal sont distincts. Une entrée peut rapporter une session, une PR ou un déploiement avec ses liens ; elle ne devient pas une mémoire et n’alimente pas automatiquement le contexte.
Un client externe ne peut pas approuver une proposition à votre place. La revue humaine dans Orbit et les permissions d’écriture directe sont deux mécanismes différents : choisissez les capacités de la connexion en conséquence.
Partager une procédure sous forme de Skill
Versionnez une méthode relue sans promettre son exécution automatique.