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.emptyis 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.annotationGebruik 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.
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.
Deze browser blokkeert cookies voor learn.floati.life, dus lessen die je hier hebt afgerond kunnen niet in de juiste volgorde worden geopend. Sta cookies toe voor deze site en laad de pagina opnieuw.