Se connecterCommencer gratuitement
ApplicationsPlateformePlace de marchéDocumentationTarifsSe connecter
Documentation

Agents

obop traite les agents IA comme des utilisateurs à part entière, volontairement limités. Cette page explique le modèle ; les suivantes montrent comment en configurer un.

Le modèle d'agent ​

Un agent est tout ce qui agit sur obop avec un jeton d'agent : un client MCP tel que Claude Desktop ou Cursor, un script qui appelle l'API REST, ou la ligne de commande. Les agents travaillent sur les mêmes enregistrements et avec les mêmes commandes que les personnes. Quatre règles rendent cela sûr.

  1. Périmètre limité. Un jeton d'agent porte une liste de groupes de permissions (ses scopes). Il ne peut que restreindre ce que son propriétaire est autorisé à faire, jamais l'élargir. Demander un groupe que le propriétaire ne détient pas est refusé.
  2. Masqué. Les données personnelles reviennent sous forme de jetons de substitution stables, comme EMAIL_1. Les champs financiers, RH et de catégorie particulière ne sont pas communiqués. Un agent peut tout de même raisonner sur les enregistrements et renvoyer des jetons, mais il ne voit jamais les valeurs réelles. Voir Jetons de masquage.
  3. Proposer, ne pas valider. Un agent peut exécuter les actions ordinaires dans ses scopes, mais pour tout ce qui est irréversible (valider une facture, payer, rembourser, envoyer, publier, supprimer), il ne peut que proposer. Le serveur renvoie un identifiant de plan et ne modifie rien. Une personne approuve. Voir La boucle d'approbation.
  4. Une seule porte. REST, MCP et la CLI passent par un même répartiteur : un agent a donc exactement les mêmes permissions, le même masquage et les mêmes approbations, quel que soit son mode de connexion.

Trois façons de se connecter ​

InterfaceÀ utiliser quandPage
MCP via stdioUn client MCP (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf et d'autres) doit appeler obop comme des outils.Se connecter via MCP
RESTUn script ou un service appelle des points de terminaison HTTP.Utiliser l'API REST
CLIUn shell ou une tâche cron appelle obop call.Utiliser la CLI

Mise en place en cinq étapes ​

  1. Décidez de ce que l'agent doit faire, et des groupes que cela exige. Moins, c'est mieux.
  2. Créez un jeton d'agent avec ces seuls scopes.
  3. Connectez l'agent via MCP, REST ou la CLI.
  4. Essayez une lecture sans risque, puis une modification qui requiert une approbation, et approuvez-la en tant que personne.
  5. Lisez Bonnes pratiques de sécurité avant de confier le jeton à quoi que ce soit qui fonctionne sans surveillance.

Ce qui existe aujourd'hui, et ce qui n'existe pas ​

  • Réalisé : jetons à périmètre limité, masquage et restauration, plans d'approbation, MCP via stdio, REST et la CLI.
  • Pas encore réalisé : un transport MCP HTTP (distant) avec OAuth, de sorte que les instances hébergées ne sont pas encore accessibles via MCP ; un écran pour créer ou révoquer des jetons d'agent ; une liste des approbations en attente dans l'interface. Les jetons d'agent n'expirent pas et il n'existe pas encore de commande de révocation. Ces points sont rappelés là où ils comptent.

Consultez Exemples de flux de travail pour des requêtes et des enchaînements de départ, et Dépannage quand quelque chose ne fonctionne pas.