Section 03 - Prompt engineering : techniques avancees
Tu sais ecrire un bon prompt simple. Ici tu apprends a faire raisonner le modele, a enchainer plusieurs etapes, a lui donner des outils, et a payer moins cher.
Temps de lecture : 8 min (ce sommaire) | Niveau : Intermediaire
Ce que tu sauras faire apres
- Choisir la bonne technique avancee selon ton probleme, au lieu de tout empiler.
- Decouper un gros chantier data en une chaine de prompts fiable et rejouable.
- Brancher le modele sur tes propres outils (base de donnees, API interne).
- Reduire la facture d'un usage quotidien avec le cache et le batch.
Prerequis
Avant d'attaquer cette section, tu dois avoir lu la section 02 - Prompt engineering : fondamentaux.
Concretement, on considere que tu sais deja :
- Ecrire une instruction claire et directe, avec un format de sortie precis.
- Donner du contexte et expliquer pourquoi tu demandes quelque chose.
- Utiliser des exemples (few-shot).
- Structurer un prompt avec des balises XML du style
<instructions>,<contexte>,<donnees>.
Si l'un de ces quatre points n'est pas acquis, retourne a la section 02. Les techniques avancees ne rattrapent jamais un prompt mal ecrit. Elles amplifient ce que tu as deja.
Un mot important avant de commencer
La documentation d'Anthropic a beaucoup bouge entre 2025 et 2026. Deux changements te concernent directement :
- Les anciennes pages
docs.claude.com/.../prompt-engineering/chain-of-thought,chain-prompts,long-context-tipsetprefill-claudes-responsen'existent plus separement. Verifie le 26 septembre 2026 : ces adresses renvoient un code 302 versplatform.claude.com, et le contenu affiche est celui d'une page unique appelee Prompting best practices. Si tu trouves un tutoriel qui pointe encore vers les anciennes URL, c'est qu'il n'a pas ete mis a jour. - Le mode "reflexion" a change de mecanique. Le reglage manuel
thinking: {"type": "enabled", "budget_tokens": N}est deprecie sur les modeles 4.6, et il renvoie une erreur 400 a partir de Claude 4.7. On pilote maintenant la profondeur de reflexion avec le parametreeffort. Nuance importante : sur Claude 4.5 et les modeles anterieurs,budget_tokensreste le seul mode disponible. C'est explique en detail dans le fichier 02 de cette section.
Chaque fois qu'un point est incertain ou en cours de changement, c'est ecrit noir sur blanc dans le fichier concerne.
Ordre de lecture
Lis dans l'ordre. Chaque fichier suppose le precedent.
| # | Fichier | Sujet | Temps | Niveau |
|---|---|---|---|---|
| 1 | 01-chain-of-thought.md | Faire raisonner le modele etape par etape | 12 min | Intermediaire |
| 2 | 02-extended-thinking.md | Le mode reflexion prolongee et le parametre effort | 14 min | Intermediaire |
| 3 | 03-prompt-chaining.md | Decouper une grosse tache en sous-taches chainees | 13 min | Intermediaire |
| 4 | 04-outils-et-function-calling.md | Donner des outils au modele (tool use) | 15 min | Avance |
| 5 | 05-long-contexte-et-documents.md | Travailler sur de gros documents | 12 min | Intermediaire |
| 6 | 06-prefill-et-controle.md | Forcer un format de sortie, sans prefill | 11 min | Avance |
| 7 | 07-patterns-agentiques.md | Les six patterns d'agents d'Anthropic | 16 min | Avance |
| 8 | 08-cout-cache-et-performance.md | Cache, batch, choix du modele, estimation du cout | 14 min | Avance |
Temps total de lecture : environ 1 h 45.
Compte plutot une demi-journee si tu testes les exemples au fur et a mesure. Et c'est ce que tu dois faire.
Comment travailler cette section
Tu m'as dit que tu avais du mal a formuler tes idees a l'ecrit. Cette section est construite pour ca.
Chaque technique se termine par un template pret a copier-coller. Les zones a remplir sont en majuscules entre crochets, comme [TA_TABLE] ou [LE_RESULTAT_ATTENDU]. Tu n'as jamais a inventer une tournure de phrase. Tu remplaces les crochets, tu envoies.
Methode conseillee, 30 minutes par jour :
- Lis un fichier en entier, sans t'arreter.
- Copie le template de la technique dans un fichier a toi, par exemple
mes-prompts.md. - Applique-le le lendemain sur une vraie tache de ton travail : une requete SQL a debugger, un DAG Airflow a documenter, un modele dbt a relire.
- Note ce qui a marche et ce qui n'a pas marche, en une ligne.
Au bout de deux semaines tu auras ta propre bibliotheque. C'est elle qui compte, pas la doc.
Carte mentale de la section
Une facon simple de retenir a quoi sert chaque fichier :
Le modele se trompe sur un raisonnement -> 01 chain of thought
Le probleme est vraiment dur -> 02 extended thinking / effort
La tache est trop grosse pour un seul prompt -> 03 prompt chaining
Le modele a besoin de donnees reelles -> 04 outils / function calling
Le document d'entree est enorme -> 05 long contexte
La sortie n'a jamais le bon format -> 06 controle du format
Il faut orchestrer plusieurs appels -> 07 patterns agentiques
Ca coute trop cher ou c'est trop lent -> 08 cout, cache, performanceGarde ces huit lignes sous les yeux. Neuf fois sur dix, le bon reflexe est dans cette liste.
A retenir
- Cette section suppose la section 02 acquise : instruction claire, contexte, exemples, balises XML.
- Les techniques avancees se choisissent une par une, en fonction du symptome. On n'empile pas.
- La doc Anthropic a migre vers
platform.claude.comet plusieurs pages de 2025 ont fusionne. Verifie toujours la date de ce que tu lis. - Le reglage manuel de la reflexion (
budget_tokens) est deprecie sur les modeles 4.6 et refuse a partir de Claude 4.7. Il est remplace pareffort. Sur Claude 4.5 et avant, il reste le seul mode possible. - Chaque fichier te donne un template pret a remplir. Copie-les dans ton propre fichier de prompts.
Depots GitHub a explorer
Ces depots contiennent le code exact des huit fichiers de cette section : raisonnement, reflexion prolongee, chainage, outils, cache. Tu clones, tu ouvres un notebook, tu mets ta cle API et ca tourne.
| Depot | Ce qu'on y trouve | Par ou commencer |
|---|---|---|
| anthropics/claude-cookbooks | Les notebooks officiels d'Anthropic, un dossier par sujet de cette section : tool_use/, extended_thinking/, patterns/agents/, cost_optimization/, misc/. C'est l'ancien anthropic-cookbook, renomme. | tool_use/calculator_tool.ipynb : le plus petit outil qui marche, 10 minutes |
| anthropics/claude-quickstarts | Des applications completes qui demarrent. Le dossier agents/ est une boucle d'agent minimale, environ 300 lignes, avec outils locaux et serveurs MCP. | agents/agent.py : lis-le en entier, c'est la boucle du fichier 07 en vrai code |
| anthropics/courses | Le cours officiel sur le tool use, six notebooks progressifs. Archive depuis le 15 septembre 2026 : le code tourne toujours, mais il vise Claude 3 Haiku, remplace le nom du modele. | tool_use/01_tool_use_overview.ipynb (branche master, pas main) |
| openai/openai-cookbook | Le meme sujet vu par OpenAI. Utile pour separer ce qui est un principe general de ce qui est une specificite Anthropic. | examples/How_to_call_functions_with_chat_models.ipynb |
| ysymyth/ReAct | Le code du papier ReAct (ICLR 2023), l'origine de la boucle raisonner / agir / observer. Reference historique : ecrit pour GPT-3, plus maintenu. A lire, pas a reutiliser. | prompts/ : les fichiers de prompts sont plus parlants que le code |
| kojima-takeshi188/zero_shot_cot | Le code du papier qui a rendu celebre la phrase « Let's think step by step » (NeurIPS 2022). Reference historique, garde pour comprendre d'ou vient le fichier 01. | main.py : la liste des declencheurs de raisonnement testes |
Clone d'abord anthropics/claude-cookbooks. C'est le seul depot qui couvre les huit fichiers de la section, et chaque notebook est autonome : tu peux ouvrir patterns/agents/basic_workflows.ipynb sans avoir lu les autres.
Une fois que tu as fait tourner deux ou trois notebooks, passe a anthropics/claude-quickstarts : c'est la que tu vois comment tout ca se range dans un vrai programme.
Sources
- Prompting best practices - Anthropic
- Prompt engineering overview - Anthropic
- Building effective agents - Anthropic Engineering
- Models overview - Anthropic
- Claude Code - Overview
Pour croiser avec d'autres fournisseurs (les principes de base sont les memes partout) :
- Overview of prompting strategies - Google Cloud / Vertex AI
- Prompt engineering techniques - Microsoft Foundry - attention : cette page precise elle-meme que ses techniques ne visent pas les modeles de raisonnement recents.
- Prompting - OpenAI API - page courte, centree sur la gestion des prompts comme du code (versionnage, roles des messages, cache).