Programma Lezione 115 di 250 · Chiamare un vero LLM
Chiamare un vero LLM

Costruire il payload dei messaggi

Ogni chiamata a un modello di chat è solo una richiesta HTTP che porta un corpo JSON, e farlo giusto è la prima cosa che fa il codice vero. In questo modulo costruirai a mano, con semplice Python, esattamente i dict e le liste che l'API di Anthropic riceve e restituisce -> così tutto gira offline e si può correggere. Ogni lezione ti mostra anche l'unica riga vera che eseguiresti con una chiave API sulla tua macchina. Le forme che costruisci qui SONO le forme che viaggiano sulla rete.

Con l'SDK installato, mandare un messaggio ha questo aspetto (solo illustrativo -> qui non chiamiamo la rete):

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"}],
)

Nota la forma: system è un campo a sé al livello più alto (NON è un messaggio), e messages è una lista di turni, ciascuno un dict con un role e un content. Gli unici ruoli validi dentro messages sono "user" e "assistant", che si alternano come in una conversazione. Un bug comune è mettere le istruzioni in un turno {"role": "system", ...} all'inizio di messages, come fanno alcune altre API. L'API di Anthropic rifiuta un turno system come primo messaggio: il prompt di sistema ha il suo posto al livello più alto. (I modelli Claude recenti accettano un messaggio system più avanti in una conversazione, per un'istruzione che arriva a metà, ma è una funzione avanzata; questo corso usa sempre il posto al livello più alto, quindi il tuo build_request rifiuta qualsiasi turno system.)

Stai costruendo build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Restituisce il dict della richiesta:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
  • Copia direttamente model e max_tokens, e metti system nella sua chiave.
  • Per ogni turno in messages, verifica che il ruolo sia esattamente "user" o "assistant". Qualsiasi altra cosa (un turno "system", un errore di battitura come "User", un ruolo mancante) deve sollevare un ValueError -> fallisci ad alta voce prima ancora di arrivare all'API e sprecare un giro.
  • Restituisci i turni di messages invariati (stesso ordine, stesso contenuto).

Ecco la vera chiamata che faresti con il dict che hai appena costruito; il ** spacchetta il dict in argomenti per nome:

resp = client.messages.create(**build_request("Be brief.", history))

Costruiscilo in modo che due coppie (system, messages) diverse producano due dict di richiesta diversi, e che un turno con un ruolo diverso da user o assistant sollevi un errore.

Tocca a te

Scrivi build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) che restituisce il dict di richiesta nella forma di Anthropic {"model", "max_tokens", "system", "messages"}. messages è una lista di turni {"role", "content"}. Verifica che ogni ruolo sia esattamente "user" o "assistant" e solleva un ValueError per qualsiasi altra cosa (compreso un turno "system" infilato di nascosto). Restituisci i turni invariati.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.