C4 · Agent qui agit en code

Famille : Agent unique

Au lieu d’appels d’outils en JSON, l’agent écrit un programme qui compose lui-même les outils.

Principe

L’agent écrit du code exécutable, en Python ou en TypeScript par exemple, qui appelle plusieurs outils, gère les boucles et les erreurs, et filtre les données avant d’en rendre compte. Un bloc de code remplace plusieurs allers-retours, et les gros résultats intermédiaires restent hors du contexte.

Le problème qu'il résout

Avec des appels d’outils séparés, chaque résultat intermédiaire repasse par le contexte du modèle, ce qui coûte des tokens et des allers-retours.

Quand l'utiliser

  • L’agent doit composer de nombreux outils ou enchaîner des traitements avec des boucles et des conditions.
  • On analyse des données et les résultats intermédiaires sont volumineux : mieux vaut ne pas les faire transiter par le contexte.

Quand l'éviter

  • On ne peut pas fournir de bac à sable d’exécution (isolation, limites de ressources) : le pattern élargit la surface de sécurité.
  • Quelques outils simples suffisent : en rester aux appels d’outils classiques (A2).

Synonymes par éditeur

  • CodeAct (Wang et al. (ICML 2024))
  • Code agents (Hugging Face smolagents)
  • Code-then-execute (version sécurité) (Beurer-Kellner et al. (2025))
  • Outils MCP exposés comme API de code (Anthropic (2025))
  • Appel programmatique d’outils (Anthropic (2025))

Patterns voisins

Sources

Contenu relu le 2026-10-02

Catalogue des patterns