Programma Les 115 van 250 · Een echt LLM aanroepen
Een echt LLM aanroepen

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 model en max_tokens direct over, en zet system in een eigen sleutel.
  • Controleer voor elke beurt in messages dat de rol precies "user" of "assistant" is. Al het andere (een beurt "system", een tikfout zoals "User", een ontbrekende rol) moet een ValueError geven -> faal luid voordat je ooit de API raakt en een retour verspilt.
  • Geef de beurten in messages ongewijzigd 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.

Jij bent aan de beurt

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.