/pattern/function-calling/

04 · ProductionTool IntegrationTool CallingStructured Tool UseFunction Invocation

Function Calling.
Strukturiertes JSON rein, typisierter Funktionsaufruf raus.

Das Modell emittiert einen strukturierten Aufruf — eine benannte Funktion mit typisierten, schema-validierten Argumenten —, den der Harness ausführt und dessen Ergebnis in den Kontext des Modells zurückspeist; das Modell entscheidet, welche Funktion es wann und mit welchen Argumenten aufruft.

In der PraxisEin Kalender-Assistent nutzt Function Calling, um eine `create_event(title, start, end, attendees)`-Funktion mit validierten Argumenten aufzurufen, anstatt einen Freitext-API-Aufruf zu generieren, den der Harness erst parsen muss.

Wann man dazu greift

  • Externe Aktionen oder Datenquellen kontrolliert integriert werden müssen.
  • Argumente strenge Validierung benötigen.
  • Tool-Nutzung beobachtbar und begrenzt sein soll.

Wann es nach hinten losgeht

  • Die Aufgabe ohne externe Aktionen gelöst werden kann.
  • Das Tool-Schema instabil ist.
  • Freitextinteraktion angemessener ist.

Die Abwägung

Strukturierte Kontrolle wird auf Kosten von Schema-Definition und Integrationsaufwand gewonnen.

Die Wirkung

Was es tatsächlich tut.

Das Modell ruft eine typisierte Funktion auf und liest deren Ergebnis.

agentfunctionresult
Fallstricke

Zwei Wege, wie dieses Pattern Probleme verursachen kann.

Schema-Drift bricht den Vertrag lautlos

Die Argumentstruktur eines Tools ändert sich; das Modell sendet weiterhin die alte Form; Aufrufe gelingen beim Parsen, werden aber mit veralteten Parametern ausgeführt.

Lösung · Validiere jede Argument-Nutzlast gegen das aktuelle Schema im Harness, vor dem Dispatch. Lehne ab und melde den Widerspruch – niemals still angleichen.

Argumente, die das Schema bestehen, aber erfunden sind

Das Modell erfindet eine plausible ID, einen Pfad oder Betrag, der zum Typ passt und sauber validiert — dann läuft der Aufruf gegen einen Datensatz, der nie existierte, oder gegen den falschen.

Lösung · Argumente gegen echte Referenten validieren (Existenz- und Eigentümerprüfungen), nicht nur gegen Typen; das Tool soll unbekannte IDs ablehnen, statt auf eine wohlgetypte Vermutung zu handeln.

Framework-Unterstützung

Wo Function Calling nativ ist.

OpenAI Agents SDKnatives Tool-CallingNativ
LangGraphbind_toolsNativ
Microsoft Agent FrameworkFunction ToolsNativ
Google ADKFunction DeclarationsNativ
AutoGen / AG2Tool-Calling-AgentenNativ
CrewAITool-DekoratorenNativ

Suche

Patterns, Frameworks und Seiten durchsuchen.