Construire la charge utile des Messages
Chaque appel à un modèle de chat est juste une requête HTTP transportant un corps JSON, et obtenir ce corps correctement est la première chose que fait le vrai code. À travers ce module, tu construiras les dicts et listes exacts que l'API Anthropic consomme et retourne, à la main, avec du Python simple -> ainsi, le tout tourne hors ligne et peut être noté. Chaque leçon te montre aussi la seule ligne réelle que tu exécuterais avec une clé API sur ta propre machine. Les formes que tu construis ici SONT les formes qui passent sur le réseau.
Avec le SDK installé, envoyer un message ressemble à ceci (illustratif seulement -> nous n'appelons pas le réseau ici) :
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
system="You are a terse assistant.",
messages=[{"role": "user", "content": "Hello"}],
)Remarque la forme : system est son propre champ de premier niveau (ce n'est PAS un message), et messages est une liste de tours, chaque tour étant un dictionnaire avec un role et un content. Les seuls rôles valides à l'intérieur de messages sont "user" et "assistant", alternant comme une conversation. Un bug courant est de mettre les instructions dans un tour {"role": "system", ...} au début de messages, comme font certaines autres API. L'API Anthropic refuse un tour système comme premier message : le system prompt a son propre emplacement de premier niveau. (Les modèles Claude récents acceptent un message système plus tard dans une conversation, pour une instruction qui arrive au milieu, mais c'est une fonctionnalité avancée ; ce cours utilise toujours l'emplacement de premier niveau, donc ton build_request rejette tout tour système.)
Tu construis build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Elle retourne le dictionnaire de la requête :
{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}- Copie
-
modeletmax_tokensdirectement, et metssystemdans sa propre clé. - Pour chaque tour dans
messages, valide que le rôle est exactement"user"ou"assistant". Tout autre chose (un tour"system", une faute de frappe comme"User", un rôle manquant) doit lever unValueError-> échoue bruyamment avant que tu ne contactes l'API et que tu ne gaspilles un aller-retour. - Retourne les tours dans
messagesinchangés (même ordre, même contenu).
Voici l'appel réel que tu ferais avec le dictionnaire que tu viens de construire ; le ** déballe le dictionnaire en arguments par mot-clé :
resp = client.messages.create(**build_request("Be brief.", history))Construis-le de sorte que deux paires (system, messages) différentes produisent deux dictionnaires de requête différents, et qu'un tour avec un rôle autre que user ou assistant lève une erreur.
Écris build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) qui retourne le dictionnaire de requête de forme Anthropic {"model", "max_tokens", "system", "messages"}. messages est une liste de tours {"role", "content"}. Valide que chaque rôle est exactement "user" ou "assistant" et lève une ValueError pour tout le reste (y compris un tour "system" caché). Retourne les tours inchangés.
Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon
Cet exercice s'ouvre bientôt
Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.
Ce navigateur bloque les cookies pour learn.floati.life, donc les leçons que tu as terminées ici ne peuvent pas s'ouvrir dans l'ordre. Autorise les cookies pour ce site et recharge la page.