OpenAPI in Tools umwandeln

Aus einer REST-API Werkzeuge für Sprachmodelle machen

Mit diesem Werkzeug können Sie OpenAPI in Tools umwandeln. Eine OpenAPI-Beschreibung (früher Swagger) legt für jede Operation einer REST-API fest, welche Parameter sie erwartet. Für Function Calling braucht ein Sprachmodell dieselbe Information in anderer Form: einen Namen, eine Beschreibung und ein JSON Schema der Argumente. Das Werkzeug macht aus jeder Operation eine Tool-Definition, nimmt dafür die operationId als Namen und fasst Pfad-, Query- und optional Header-Parameter sowie den JSON-Body zu einem Objekt zusammen. Damit wird aus einer Swagger-Datei eine Swagger in Tool-Definition Übersetzung ohne Handarbeit.

Ausgegeben wird je nach Wahl das OpenAI-Format mit parameters, das Anthropic-Format mit input_schema oder eine Tool-Liste für einen MCP-Server mit inputSchema. Lokale Verweise wie #/components/schemas/Kunde werden aufgelöst, Pflichtparameter landen in required. So entsteht OpenAPI zu Function Calling in wenigen Sekunden. Die Tabelle zeigt, welche Methode und welcher Pfad hinter jedem Tool stehen; Ihre Anwendung braucht diese Zuordnung, denn wer Tools aus API erzeugen lässt, muss den Aufruf des Modells anschließend in eine echte HTTP-Anfrage übersetzen.

Prüfen Sie die Beschreibungen: Sie sind das, was das Modell über ein Tool weiß. Kurze Zusammenfassungen wie „Get user“ reichen oft nicht; gute Tool-Beschreibungen sagen, wann das Tool passt und was es zurückgibt. Geben Sie außerdem nur Operationen frei, die der Agent wirklich braucht, vor allem bei schreibenden Methoden wie POST, PUT und DELETE. YAML-Dateien wandeln Sie vorher mit YAML in JSON um; einzelne Tools baut der Function-Calling-Generator.