Module 05 · Construire avec les LLM

Les agents

Se demander d'abord s'il faut un agent, puis en écrire un de zéro – conception d'outils, planification et auto-vérification, mémoire, agents multiples, MCP et sécurité –, pour enfin apprendre à RepoBot à fouiller lui-même le code source.

Leçons

  1. 01
    Agents et workflows : se demander d'abord s'il faut un agent

    Un agent laisse le modèle décider lui-même de l'étape suivante. Sur les trois mêmes questions, un déroulé fixe répond juste en 1 appel, l'agent en 3 à 4. La différence entre les deux, le coût d'un agent, et une liste de contrôle pour décider s'il en faut un.

    30 minutes · Intermédiaire
  2. 02
    Écrire une boucle d'agent à la main

    Sans aucun framework, écrire un agent en un peu plus de cent lignes – enregistrement des outils, boucle d'appel, conditions d'arrêt, gestion des erreurs. Le tester d'abord hors ligne avec un faux modèle qui suit un scénario, puis passer à un vrai modèle et le regarder décider lui-même quoi chercher.

    50 minutes · Intermédiaire
  3. 03
    Comment concevoir des outils

    Les trois mêmes outils, avec des noms et des descriptions vagues – le modèle ne choisit juste que 14 fois sur 30 ; décrits clairement, 30 sur 30. Comment écrire le nom, la description, les paramètres, la valeur de retour et les messages d'erreur d'un outil.

    35 minutes · Intermédiaire
  4. 04
    Planification et auto-vérification

    Une même tâche en plusieurs étapes, trois méthodes comparées – faire directement, établir un plan puis faire, vérifier soi-même après coup. Le plan a doublé le coût pour un résultat semblable ; l'auto-vérification a vraiment trouvé deux erreurs de source, mais a coûté quatre fois plus.

    40 minutes · Intermédiaire
  5. 05
    La mémoire

    La mémoire à court terme d'un agent est sa liste de messages ; la mémoire à long terme, il faut la stocker soi-même et la récupérer au besoin. On donne à l'agent deux outils, « retenir » et « se rappeler », pour montrer qu'il utilise dans une conversation toute neuve un fait retenu la fois précédente.

    35 minutes · Intermédiaire
  6. 06
    Plusieurs agents travaillent ensemble

    Un agent superviseur découpe la tâche, la confie à trois agents ouvriers aux contextes indépendants qui travaillent en parallèle, puis rassemble les résultats. Par rapport à un agent seul, un tiers de tokens en moins, et un contexte de superviseur de 472 tokens seulement. La vraie valeur des agents multiples, et leur coût.

    40 minutes · Intermédiaire
  7. 07
    MCP : la prise standard pour brancher des outils sur un agent

    Écrire avec le SDK Python officiel un serveur MCP minimal contenant deux outils de consultation de la documentation de httpx ; puis écrire un client qui s'y connecte, et faire appeler ces outils par DeepSeek via MCP pour répondre à des questions.

    45 minutes · Intermédiaire
  8. 08
    La sécurité des agents

    Une expérience réelle et reproductible d'injection de prompt indirecte – une page web cache des « instructions » destinées à l'IA. Un modèle ne tombe jamais dans le piège, l'autre s'y laisse prendre 4 fois alors que le prompt l'interdit explicitement ; seul un mécanisme de confirmation au niveau du programme a tout arrêté.

    45 minutes · Intermédiaire
  9. 09
    Projet : un assistant qui fouille le code source

    Transformer RepoBot en agent – consulter d'abord la documentation, et si la réponse n'y est pas, fouiller le code source de httpx. Valeurs par défaut et logique des exceptions, sur lesquelles la v2 séchait, la v3 y répond juste, en indiquant fichier et numéro de ligne du code source.

    60 minutes · Intermédiaire

Un agent n'est qu'une boucle : le modèle décide quoi faire ensuite, le programme l'exécute, le résultat revient au modèle, et ainsi de suite jusqu'à ce qu'il estime pouvoir répondre. Ce module n'utilise aucun framework : il part de cette boucle et y ajoute peu à peu ce qu'exige un vrai système.

Chaque leçon comporte une expérience comparative, et le résultat n'est pas toujours « la méthode la plus avancée est la meilleure » : sur les mêmes questions, un déroulé fixe répond juste en 1 appel quand l'agent coûte 4 fois plus cher ; établir un plan d'abord double le coût sans changer la conclusion ; et des descriptions d'outils bien écrites font passer la proportion d'outils bien choisis de 47 % à 100 %.

Pourquoi cet ordre

La leçon 1 répond d'abord à la question la plus importante : faut-il un agent ? La leçon 2 écrit la boucle à la main ; chaque leçon suivante y ajoute quelque chose. Les leçons 3 à 5 traitent les trois choses qui influencent le plus un agent : les outils, la manière de travailler (planification et vérification), la mémoire et le contexte. La leçon 6 passe d'un agent à plusieurs. La leçon 7 présente MCP, pour que vos outils servent à toutes sortes d'agents. La leçon 8 traite de la sécurité : un agent qui peut agir doit être sûr. La leçon 9 intègre tout cela dans RepoBot.

Vous avez terminé quand

  • face à un besoin, vous savez juger s'il faut un appel unique, un workflow ou un agent, et le justifier.
  • vous savez écrire sans framework une boucle d'agent avec enregistrement d'outils, gestion des erreurs et limite de pas, et la tester hors ligne avec un modèle scénarisé.
  • vous savez écrire des descriptions claires pour un ensemble d'outils, et vérifier par l'expérience la proportion d'outils bien choisis par le modèle.
  • vous savez écrire un serveur MCP minimal et brancher ses outils dans votre propre agent.
  • vous savez expliquer comment se produit une injection de prompt indirecte, et pourquoi « recommander au modèle dans le prompt » ne suffit pas et qu'il faut des limites au niveau du programme.
  • RepoBot v3 sait répondre à des questions dont la réponse n'existe que dans le code source, en indiquant le fichier et le numéro de ligne.

Le code de ce module

Le code et les sorties des programmes sont reproduits tels qu’ils ont tourné : commentaires et sorties sont donc en chinois.