Tool Schema

Das Tool Schema legt fest, welche Eingaben ein Werkzeug annimmt: welche Felder es gibt, welchen Typ sie haben, welche Pflicht sind und welche Werte erlaubt sind. Geschrieben wird es in JSON Schema, einer Sprache, mit der sich Aufbau und Einschränkungen von JSON-Daten beschreiben lassen. JSON Schema In den Schnittstellen steht es als input_schema oder inputSchema neben Name und Beschreibung des Werkzeugs.

Das Schema ist Beschreibung und Prüfregel zugleich

Es erfüllt zwei Aufgaben auf einmal. Vor dem Aufruf sagt es dem Modell, wie ein gültiger Aufruf aussieht, denn das Schema wird mit in den Prompt gegeben. Nach dem Aufruf dient es deiner Anwendung als Prüfregel für die gelieferten Argumente.

Das Model Context Protocol kennt zusätzlich ein Schema für die Ausgabe. Wo es gesetzt ist, muss das Ergebnis dazu passen, und die aufrufende Seite soll das prüfen. Model Context Protocol: Tools

So kannst du dir das vorstellen

Das Schema ist das Formular mit seinen Feldern: Pflichtfelder, Auswahllisten, Datumsformate. Wer es ausfüllt, sieht am Formular, was erwartet wird, und die Poststelle erkennt am selben Formular, ob etwas fehlt. Das Bild erklärt die Doppelrolle, es sagt nichts darüber, ob der Inhalt sachlich richtig ist.

Was es in der Praxis bedeutet

Je enger das Schema, desto weniger kann schiefgehen. Eine Auswahlliste statt eines freien Textfelds verhindert erfundene Werte, Pflichtfelder erzwingen Nachfragen statt Raten. Manche Schnittstellen bieten zusätzlich einen strengen Modus, der Aufrufe außerhalb des Schemas ausschließt.

Gegenrechnen musst du die Kosten: Das Schema steht in jeder Anfrage und belegt Tokens. Verschachtelte Strukturen mit vielen optionalen Feldern kosten also dauerhaft und erhöhen zugleich die Fehlerquote. Kurze, flache Schemata sind meist die bessere Wahl.

Wo es verwechselt wird

Das Schema beschreibt die Eingaben, die Beschreibung des Werkzeugs sagt, wozu es gut ist. Beides zusammen ergibt die Werkzeugdefinition. Structured Output benutzt zwar dieselbe Technik, betrifft aber die Antwort an dich, nicht den Werkzeugaufruf.

Verwandte Begriffe

Tool, Tool Calling, Tool Result, Structured Output, Tool Catalog.