Skip to content
PKResources
Plan de la formation

Ingénierie agentique : la formation pratique · Module 5: Passer à l’échelle

Donner aux agents des outils et des intégrations sur mesure

Un agent vaut les outils qu’il peut appeler. Commencez par un script dans le dépôt, passez à une vraie intégration quand il le faut, et concevez chaque outil pour un lecteur qui n’est pas vous.

Leçon 20 / 24 · ⏱ 7 min

D’emblée, un agent de code peut lire des fichiers, les modifier et lancer des commandes shell. Ça couvre beaucoup. Mais il ne voit ni votre outil de suivi d’erreurs, ni vos feature flags, ni les journaux de staging, à moins que vous lui donniez un accès.

Les outils sur mesure, c’est cet accès. La compétence, ce n’est pas de les bâtir : c’est de savoir quel type bâtir, et de les concevoir pour que l’agent s’en serve bien.

L’échelle d’intégration

Je commence toujours par le barreau du bas et je ne monte que quand celui d’en dessous ne suffit plus. Chaque barreau coûte plus cher à bâtir et à entretenir.

1 · Une note« lance X pour les logs »2 · Un scriptdonnées de test, fixtures3 · Une CLIpartagée, documentée,avec un –help4 · Intégrationintrants typés, auth,marche avec tous les agentsplus de puissance, plus d’entretien
Montez seulement aussi haut que nécessaire. La plupart des équipes vont loin avec les barreaux 1 et 2.

Un script dans le dépôt, c’est déjà un outil : l’agent peut le lire, le lancer et voir la sortie. Le barreau 4, c’est une vraie intégration, souvent par un protocole ouvert comme le Model Context Protocol (MCP), pour que tout agent compatible puisse la découvrir et l’appeler avec des intrants typés.

Concevez pour un lecteur qui n’est pas vous

L’agent décide s’il appelle votre outil, et comment, à partir de son nom, de sa description et de ses messages d’erreur. C’est toute l’interface. Écrivez-la comme la documentation pour une nouvelle recrue brillante qui n’a aucun contexte.

✕ Un outil que l’agent utilise mal

  • –Nom : « query »
  • –Description : « Lance une requête »
  • –Retourne 5 000 lignes de JSON brut
  • –Erreur : « failed »
  • –Peut écrire dans n’importe quelle table

✓ Un outil que l’agent utilise bien

  • +Nom : « search_recent_errors »
  • +Dit quand l’utiliser et quand ne pas l’utiliser
  • +Retourne les 20 premiers, résumés, avec pagination
  • +L’erreur explique le problème et comment corriger l’appel
  • +Lecture seule, limité à un service
search_recent_errors
Trouve les erreurs récentes dans l’outil de suivi d’erreurs pour UN service.
À utiliser pour enquêter sur un rapport de bogue ou un déploiement en échec.
Ne pas utiliser pour des questions de métriques ou de performance.

Intrants :
- service (requis) : le nom tel qu’il apparaît dans la liste des services
- since (optionnel) : p. ex. "2h" ou "3d". Par défaut "24h".

Retourne jusqu’à 20 erreurs groupées : message, nombre, première et
dernière occurrence, une trace de pile. Page suivante avec le curseur.

À vous de jouer : quel barreau?

🎮 Comment donneriez-vous cette capacité à l’agent?

1 / 8 · Pointage: 0

Avant de continuer

✅ À retenir

0 / 4 complété