Bou die Messages Payload
Elke oproep na 'n chat model is net 'n HTTP versoek wat 'n JSON body dra, en om daardie body reg te kry is die eerste ding wat regte kode doen. Deur hierdie module gaan jy die presiese dicts en lyste wat die Anthropic API verbruik en teruggee, met die hand, met eenvoudige Python bou -> sodat die hele ding buite aanlyn kan loop en gegrade kan word. Elke les wys jou ook die een regte reël wat jy met 'n API sleutel op jou eie masjien sou hardloop. Die vorms wat jy hier bou IS die vorms wat oor die kabel gaan.
Met die SDK geïnstalleer, lyk dit so om 'n boodskap te stuur (slegs illustratief -> ons roep nie die netwerk hier nie):
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 die vorm: system is sy eie topvlakveld (dit is NIE 'n boodskap nie), en messages is 'n lys van beurte, elk 'n dict met 'n role en content. Die enigste geldige rolle binne messages is "user" en "assistant", wat afwissel soos 'n gesprek. 'n Algemene fout is om die instruksies in 'n {"role": "system", ...} beurt aan die begin van messages te sit, soos wat sommige ander API's doen. Die Anthropic API weier 'n stelselbeurt as die eerste boodskap: die stelselprompt het sy eie topvlakslot. (Recente Claude modelle aanvaar wel 'n stelselboodskap later in 'n gesprek, vir 'n instruksie wat halfpad aankom, maar dit is 'n gevorderde funksie; hierdie kursus gebruik altyd die topvlakslot, so jou build_request verwerp enige stelselbeurt.)
Jy bou build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Dit gee die request dict terug:
{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}- Kopieer
modelenmax_tokensreguit deur, en sitsystemin sy eie sleutel. - Vir elke beurt in
messages, valideer dat die rol presies"user"of"assistant"is. Enigiets anders ('n"system"beurt, 'n spelfout soos"User", of 'n ontbrekende rol) moet 'nValueErrorveroorsaak -> faal hard voordat jy die API raak en 'n rondgang mors. - Gee die beurte in
messagesonveranderd terug (deurmekaar, dieselfde inhoud).
Hier is die werklike aanroep wat jy met die dict wat jy nou gebou het sou maak; die ** pak die dict uit na keyword arguments:
resp = client.messages.create(**build_request("Be brief.", history))Bou dit sodat twee verskillende (system, messages) pare twee verskillende request dicts produseer, en 'n turn met 'n role anders as user of assistant gooi 'n error.
Skryf build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) wat die Anthropic-shape request dict {"model", "max_tokens", "system", "messages"} teruggee. messages is 'n lys van {"role", "content"} turns. Valideer dat elke role presies "user" of "assistant" is en gooi 'n ValueError vir enigiets anders (insluitend 'n gesmokkelde "system" turn). Gee die turns onveranderd terug.
Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les
Hierdie oefening open binnekort
Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.
Hierdie blutser blokkeer koekies vir learn.floati.life, so lesse wat jy hier voltooi het kan nie in volgorde oopgaan nie. Laat koekies vir hierdie webwerf toe en laai nuut.