Programma Lezione 248 di 250 · Lavorare con le risposte del modello
Lavorare con le risposte del modello

Controllare una chiamata a uno strumento prima di eseguirla

Perché è importante Una chiamata a uno strumento è il modello che chiede al tuo codice di agire: prenotare, pagare, cancellare. Il modello riempie gli argomenti partendo da una conversazione, e può sbagliarli. Fare una prenotazione per "Friday" o per venti persone in un ristorante da dodici posti è un vero bug con un costo vero.

Lo strumento dato al modello:

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

Sei risposte, ognuna uno schema che producono i modelli veri: una chiamata corretta; una chiamata con "Friday" dove serviva una data; party_size come stringa "2"; una chiamata che ha dimenticato time; un gruppo di 20 (la descrizione dice da 1 a 12, e una descrizione è una richiesta, non una garanzia); e nessuna chiamata, perché il modello ha prima fatto una domanda all'utente, che spesso è la mossa giusta.

Il tuo lavoro è il cancello: decidere se eseguire lo strumento, rimandare i problemi al modello così può correggerli, o passare la domanda all'utente. (Con strict: true nella definizione dello strumento l'API garantisce i tipi e i campi obbligatori, ma non che i valori abbiano senso; l'intervallo e la data reale li controlli sempre tu.)

Su queste risposte: sono simulate. Ognuna è stata scritta per questo corso esattamente nella forma che restituisce l'API Messages di Claude (blocchi di contenuto, stop_reason, usage), e ognuna copia qualcosa che fanno i modelli veri. Non sono registrazioni di un modello dal vivo, quindi le parole esatte sono nostre; le forme e i problemi sono quelli veri che il tuo codice incontrerà.

Tocca a te

Scrivi gate_booking(reply). Se la risposta non ha nessun blocco tool_use, restituisci {"action": "ask_user", "text": ...} con il testo unito. Altrimenti prendi la prima chiamata a book_table e controlla il suo input: ogni chiave obbligatoria presente; date una data reale scritta YYYY-MM-DD; time scritto HH:MM con ore da 00 a 23 e minuti da 00 a 59; party_size un vero int (non una stringa, non True) da 1 a 12. Restituisci {"action": "run", "input": ...} quando tutto passa, altrimenti {"action": "fix", "errors": [...]} con un messaggio per problema, ogni messaggio che nomina il campo a cui si riferisce. Lascia REPLIES del codice di partenza così com'è: la verifica lo legge.

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.