Programma Lezione 140 di 250 · Output strutturati e chiamate a funzioni/strumenti
Output strutturati e chiamate a funzioni/strumenti

Da funzione a schema di strumento (introspezione)

La chiamata agli strumenti (detta anche chiamata di funzioni) permette a un modello di chiedere al tuo programma di eseguire una funzione: pubblicizzi un insieme di strumenti, il modello risponde con il nome di uno strumento e degli argomenti, e tu lo esegui. Ma il modello non può vedere il tuo Python -> vede solo uno schema: una descrizione JSON del nome e dei parametri di ogni strumento. Scrivere a mano quegli schemi per ogni funzione è noioso e va fuori sincrono nel momento in cui cambi una firma. La soluzione è l'introspezione: generare lo schema direttamente dalla funzione.

Il modulo inspect di Python legge la firma di una funzione durante l'esecuzione. Lo schema che si aspettano le API di chiamata degli strumenti ha questo aspetto:

{
  "name": "get_weather",
  "parameters": {
    "type": "object",
    "properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
    "required": ["city"]
  }
}

Stai costruendo tool_schema(func) che produce esattamente quello. Due idee fanno tutto il lavoro:

  • Associa i tipi Python ai tipi di JSON schema. Leggi l'annotazione di ogni parametro e traduci: int -> "integer", float -> "number", str -> "string", bool -> "boolean". Per qualsiasi altra cosa usa "string".
  • Ricava required dai default. Un parametro senza default è obbligatorio; un parametro con un default è facoltativo. inspect.Parameter.empty è la sentinella per "nessun default".
import inspect
sig = inspect.signature(func)
for name, param in sig.parameters.items():
    is_required = param.default is inspect.Parameter.empty
    json_type = ...   # from param.annotation

Usa func.__name__ per il nome dello strumento. Costruiscila in modo che due funzioni annotate in modo diverso producano due schemi chiaramente diversi, che un parametro int compaia come "integer" e uno str come "string", che un parametro con default resti fuori da required, e che uno senza default ci sia. È il contratto su cui si basa ogni integrazione con chiamate agli strumenti.

Tocca a te

Scrivi tool_schema(func) che esamina una funzione con inspect.signature e restituisce {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}}. Associa int->"integer", float->"number", str->"string", bool->"boolean" (di default "string"), e metti un parametro in required solo quando non ha un default.

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.