Lehrplan Lektion 140 von 250 · Strukturierte Ausgaben & Funktions-/Tool-Aufrufe
Strukturierte Ausgaben & Funktions-/Tool-Aufrufe

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.empty ist 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.annotation

Verwende 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.

Du bist dran

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.