Outils d’agent

Chaque agent de code apporte ses propres outils : lire des fichiers, lancer des commandes, modifier du code. OAR en ajoute un petit ensemble par-dessus, pour qu’un agent puisse faire ce que seul le relais sait faire : travailler avec d’autres sessions, publier un aperçu web, et vous poser une question à laquelle vous répondez d’un simple appui.

Vous n’appelez jamais ces outils vous-même. Vous demandez avec des mots simples, et l’agent choisit l’outil. Cette section sert à savoir ce qu’un agent peut faire, ce pour quoi il a besoin de votre approbation, et ce qu’il envoie et reçoit exactement.

Les outils #

• relay_toolL’outil d’agent relay_tool — travailler avec les sessions de ce relais et des relais associés. Les 23 actions, leurs paramètres et résultats, les permissions, les limites et les erreurs.
• previewL’outil d’agent preview — publier un serveur de dev local ou un dossier sur un lien public. Actions, paramètres, résultats, mise en place et limites.
• ask_userComment les agents vous posent une question sous forme de carte à boutons — l’outil ask_user d’OAR et les propres outils de question des fournisseurs, avec les paramètres par fournisseur.

Ce que vous pouvez demander #

Quelques demandes et l’outil qu’un agent utiliserait :

Par fournisseur #

Ce que fait un outil est identique pour tous les fournisseurs. Ce qui diffère, c’est si les agents d’un fournisseur reçoivent l’outil, et le nom sous lequel ils le voient.

Les chats Claude API et DeepSeek font tourner Claude Code sur l’hôte du relais ; leurs agents reçoivent donc les outils exactement comme ceux d’un chat Claude. Voir Claude API et DeepSeek.

Les sessions Claude Cloud tournent dans un bac à sable chez Anthropic, pas sur votre machine. Les outils du relais n’y pénètrent pas : une session cloud n’a ni relay_tool ni preview. Les agents d’autres sessions peuvent quand même démarrer, lire, envoyer des prompts à et arrêter une session cloud avec relay_tool.

Grok et le moteur d’extension de Copilot reçoivent les outils d’un petit serveur MCP qu’OAR attache à l’agent. Définir la variable d’environnement OAR_MCP_SERVER=0 pour le relais désactive ce serveur ; ces agents n’ont alors pas de relay_tool, et apprennent comment appeler l’API d’aperçu au lieu d’avoir un outil preview.

Quand un outil est disponible #

Une session apprend si elle reçoit relay_tool au démarrage du processus de son agent. Après que vous avez associé le premier relais ou activé les sessions d’agents, une conversation qui tournait déjà peut ne pas avoir l’outil tant que son agent n’a pas redémarré. Ajouté en 0.9.18 Il en va de même pour le nouveau nom de l’outil : une session qui tournait quand vous êtes passé à 0.9.18 peut encore l’avoir sous le nom remote_relay ; voir Le nom.

Ce dont vous gardez le contrôle #

• Rien de ce qui va au-delà de la conversation n’est activé par défaut. Les sessions d’agents sont désactivées tant que vous ne les activez pas, un relais associé est verrouillé dans chaque conversation tant que vous ne le mentionnez pas, et la preview lane est désactivée tant que vous ne la configurez pas.
• Cartes d’approbation. La première session qu’un agent démarre dans une conversation, la première fois qu’il surveille des sessions sur un relais, et chaque action d’écriture dans les modes du relais ask et plan vous demandent d’abord, sur une carte de question.
• Les outils ne donnent jamais de token à un agent. Les appels vers un autre relais passent par votre propre relais, qui détient le token de ce relais. Ce n’est pas un bac à sable : un agent tourne avec l’utilisateur du relais et pourrait lire le fichier de config et la base de données sur le disque. Voir Ce qu’OAR expose.
• Les liens d’aperçu sont publics. Quiconque a un lien d’aperçu peut l’ouvrir sans se connecter. L’agent a pour consigne de le dire quand il vous en donne un. Un agent ne liste et ne ferme que les aperçus de sa propre conversation Ajouté en 0.9.14 ; Settings → Previews (Réglages → Aperçus) les affiche et les ferme tous.

Les détails se trouvent sur la page de chaque outil : relay_tool → Permissions et approbations et preview → Limites.

Ce qui n’est pas un outil #

Certaines choses que font les agents dans OAR fonctionnent sans outil d’OAR :

• Images, vidéo et audio dans une réponse. Les agents savent qu’ils peuvent intégrer un fichier média par son chemin absolu ; le relais l’affiche directement dans la réponse. C’est une consigne dans le prompt, pas un outil. Les agents du moteur d’extension de Copilot et de Claude Cloud ne la reçoivent pas.
• /preview dans la zone de saisie. Vous pouvez publier, lister et fermer des aperçus vous-même en tapant /preview (zone de saisie). Cela ne coûte aucun turn d’agent et fonctionne avec tous les fournisseurs.
• Le tableau de plan. Quand un agent termine sa planification, OAR affiche un tableau Plan ready (Plan prêt). Sur Claude et DeepSeek, il vient de l’outil de plan propre à Claude Code, qu’OAR récupère.