Programma Les 140 van 250 · Gestructureerde Outputs & Function/Tool Calling
Gestructureerde Outputs & Function/Tool Calling

Functie -> Tool Schema (Introspectie)

Tool calling (ook wel function calling genoemd) laat een model je programma vragen om een functie uit te voeren: je adverteert een set tools, het model antwoordt met een toolnaam en argumenten, en jij voert het uit. Maar het model kan je Python niet zien -> het ziet alleen een schema: een JSON beschrijving van de naam en parameters van elke tool. Het handmatig schrijven van die schema's voor elke functie is saai en raakt uit sync zodra je een signature aanpast. De oplossing is introspection: genereer het schema direct vanuit de functie.

Het inspect module van Python leest de signatuur van een functie tijdens runtime. Het schema dat de tool-calling API's verwachten ziet er zo uit:

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

Je bouwt tool_schema(func) dat precies dat produceert. Twee ideeën doen al het werk:

  • Map Python types naar JSON-schema types. Lees de annotatie van elke parameter en vertaal: int -> "integer", float -> "number", str -> "string", bool -> "boolean". Zet alles wat anders is op "string".
  • Afgeleid van standaardwaarden. Een parameter met geen standaardwaarde is vereist; een parameter met een standaardwaarde is optioneel. inspect.Parameter.empty is de sentinel voor "geen standaardwaarde".
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

Gebruik func.__name__ voor de toolnaam. Bouw het zo dat twee verschillend geannoteerde functies twee duidelijk verschillende schema's produceren, een int param verschijnt als "integer" en een str als "string", een parameter met een standaardwaarde wordt uit required gelaten, en een zonder standaardwaarde zit erin. Dat is de overeenkomst waar elke tool-calling integratie op vertrouwt.

Jij bent aan de beurt

Schrijf tool_schema(func) dat een functie introspecteert met inspect.signature en {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}} teruggeeft. Map int->"integer", float->"number", str->"string", bool->"boolean" (standaard "string"), en zet een parameter in required alleen als deze geen standaard heeft.

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.