Bouw de Messages Payload
Elke aanroep van een chatmodel is gewoon een HTTP-verzoek met een JSON-body, en die body goed krijgen is het eerste wat echte code doet. In deze module bouw je de precieze dicts en lijsten die de Anthropic API verwerkt en teruggeeft, met de hand, met gewone Python -> zodat het geheel offline draait en beoordeeld kan worden. Elke les laat je ook de ene echte regel zien die je met een API-sleutel op je eigen machine zou draaien. De vormen die je hier bouwt ZIJN de vormen die over de lijn gaan.
Met de SDK geïnstalleerd ziet een bericht versturen er zo uit (alleen ter illustratie -> we roepen hier het netwerk niet aan):
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"}],
)Let op de vorm: system is een eigen veld op het hoogste niveau (het is GEEN bericht), en messages is een lijst van beurten, elk een dict met een role en content. De enige geldige rollen in messages zijn "user" en "assistant", afwisselend zoals in een gesprek. Een veelvoorkomende bug is de instructies in een beurt {"role": "system", ...} aan het begin van messages zetten, zoals sommige andere API's doen. De Anthropic API weigert een systeembeurt als eerste bericht: de systeemprompt heeft een eigen plek op het hoogste niveau. (Recente Claude-modellen accepteren wel een systeembericht later in een gesprek, voor een instructie die halverwege binnenkomt, maar dat is een geavanceerde functie; deze cursus gebruikt altijd de plek op het hoogste niveau, dus je build_request weigert elke systeembeurt.)
Je bouwt build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Hij geeft het verzoek-dict terug:
{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}- Neem
modelenmax_tokensdirect over, en zetsystemin een eigen sleutel. - Controleer voor elke beurt in
messagesdat de rol precies"user"of"assistant"is. Al het andere (een beurt"system", een tikfout zoals"User", een ontbrekende rol) moet eenValueErrorgeven -> faal luid voordat je ooit de API raakt en een retour verspilt. - Geef de beurten in
messagesongewijzigd terug (zelfde volgorde, zelfde inhoud).
Dit is de echte aanroep die je met het net gebouwde dict zou doen; de ** pakt het dict uit tot trefwoordargumenten:
resp = client.messages.create(**build_request("Be brief.", history))Bouw het zo dat twee verschillende paren (system, messages) twee verschillende verzoek-dicts opleveren, en dat een beurt met een andere rol dan user of assistant een fout geeft.
Schrijf build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) dat het Anthropic-shape request dict {"model", "max_tokens", "system", "messages"} teruggeeft. messages is een lijst van {"role", "content"} turns. Controleer of elke role exact "user" of "assistant" is en gooi een ValueError voor alles anders (inclusief een gesmokkelde "system" turn). Geef de turns onveranderd terug.
Een probleem ontdekt in deze les? Meld het · Vraag naar deze les
Deze oefening opent binnenkort
Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.
Deze browser blokkeert cookies voor learn.floati.life, dus lessen die je hier hebt afgerond kunnen niet in de juiste volgorde worden geopend. Sta cookies toe voor deze site en laad de pagina opnieuw.