Funktion -> Tool Schema (Introspektion)
Tool calling (auch bekannt als function calling) erlaubt es einem Modell, dein Programm aufzufordern, eine Funktion auszuführen: du bewirbst eine Menge von Tools, das Modell antwortet mit einem Toolnamen und Argumenten, und du führst es aus. Aber das Modell kann deinen Python Code nicht sehen -> es sieht nur ein schema: eine JSON Beschreibung des Namens und der Parameter jedes Tools. Diese Schemas von Hand für jede Funktion zu schreiben ist mühsam und gerät sofort aus dem Gleichgewicht, sobald du eine Signatur änderst. Die Lösung ist introspection: generiere das Schema direkt aus der Funktion.
Das inspect Modul von Python liest die Signatur einer Funktion zur Laufzeit. Das Schema, das die Tool-Calling APIs erwarten, sieht so aus:
{
"name": "get_weather",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}, "days": {"type": "integer"}},
"required": ["city"]
}
}Du baust tool_schema(func), das genau das erzeugt. Zwei Ideen erledigen die ganze Arbeit:
- Mappe Python-Typen auf JSON-Schema-Typen.Lies jede Annotation eines Parameters und übersetze:
int->"integer",float->"number",str->"string",bool->"boolean". Setze alles andere standardmäßig auf"string". - Abgeleitet von Standardwerten. Ein Parameter mit keinem Standardwert ist erforderlich; ein Parameter mit einem Standardwert ist optional.
inspect.Parameter.emptyist der Wächter für "kein Standardwert".
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.annotationVerwende func.__name__ für den Toolnamen. Baue es so auf, dass zwei unterschiedlich annotierte Funktionen zwei deutlich verschiedene Schemas erzeugen, ein int Param als "integer" erscheint und ein str als "string", ein Parameter mit Standardwert wird aus required weggelassen und einer ohne Standardwert ist darin enthalten. Das ist der Vertrag, auf den jede Tool-Calling Integration sich verlässt.
Schreibe tool_schema(func), das eine Funktion mit inspect.signature inspiziert und {"name": func.__name__, "parameters": {"type": "object", "properties": {param: {"type": json_type}}, "required": [...]}} zurückgibt. Mappe int->"integer", float->"number", str->"string", bool->"boolean" (Standard "string") und setze einen Parameter in required nur dann, wenn er keinen Standardwert hat.
Ein Problem in dieser Lektion entdeckt? Melde es · Frage zu dieser Lektion
Diese Übung öffnet bald
Beende die vorherige Lektion, damit diese freigeschaltet wird. Der ganze Kurs ist kostenlos, kein Konto erforderlich, und du kannst diese Lektion jetzt direkt lesen.
Dieser Browser blockiert Cookies für learn.floati.life, daher können hier beendigte Lektionen nicht in der richtigen Reihenfolge geöffnet werden. Erlaube Cookies für diese Seite und lade sie neu.