GPTs mit externen APIs verbinden
Auf dieser Seite
Stand vom 5. November 2026: GPTs befinden sich in ihren letzten Wochen. OpenAI stellt benutzerdefinierte GPTs am 11. Dezember 2026 ein (für bestimmte Enterprise-Workspaces mit Ausnahmegenehmigung am 11. Februar 2027). Persönliche, Free-, Go-, Plus- und Pro-Konten können keine neuen GPTs mehr erstellen oder veröffentlichen. Die Erstellung in Business-, Enterprise- und Edu-Workspaces hängt von den Einstellungen ab und ist in betroffenen Enterprise-Workspaces am 26. Oktober 2026 eingestellt worden. Bestehende GPTs bleiben nutzbar und bearbeitbar, sofern Ihr Plan dies zulässt, bis zur Einstellung; Ihre Gespräche mit ihnen bleiben danach weiterhin zugänglich. Die Migration (Migrate to plugin in Mein GPT) wandelt Anweisungen in eine Fähigkeit um, das Wissensbasis in Referenzdateien und verbundene Apps in Apps; benutzerdefinierte Aktionen werden nicht übertragen. Diese Lektion erklärt, wie GPTs funktionieren, um Ihnen zu helfen, sie zu warten, zu migrieren und ihre Prinzipien an ein Plugin anzupassen (Lektionen 15–17).
Über den Standalone-GPT hinaus
Bisher operiert Ihr GPT in einer Sackgasse: Seine Anweisungen definieren sein Verhalten, und sein Wissen liefert Ihre Dokumente. Das ist leistungsfähig, bleibt aber von der lebendigen Welt abgeschnitten. Es kann Ihren CRM in Echtzeit nicht prüfen, ein Kalenderevent erstellen oder Ihre Datenbank abfragen – es weiß nur, was Sie hochgeladen haben, eingefroren zum Zeitpunkt des Uploads. Aktionen heben diese Grenze auf: Sie ermöglichen es Ihrem GPT, externe APIs aufzurufen, um während eines Gesprächs Daten in Ihren Tools zu lesen und zu schreiben.
Was ist eine Aktion?
Eine Aktion ist eine Verbindung zwischen Ihrem GPT und einem externen Dienst über dessen API. Der Ablauf ist immer derselbe: Der Nutzer stellt eine Frage oder gibt eine Anweisung, das GPT erkennt, dass es externe Daten benötigt, um zu antworten, es ruft die API des Dienstes auf, empfängt die Antwort und integriert sie in seine endgültige Antwort. Betrachten Sie einen Verkaufs-GPT, der mit einem CRM verbunden ist: Wenn ein Nutzer fragt: „Wie ist der Status der Dupont-Datei?”, fragt das GPT die CRM-API ab, ruft die Kundendatei ab und antwortet mit den Daten von heute – nicht mit einer Erinnerung an eine Datei, die vor drei Monaten hochgeladen wurde. All dies geschieht für den Nutzer transparent, der einfach das Gefühl hat, mit einem gut informierten Assistenten zu sprechen.
Das OpenAPI-Schema
Damit das GPT eine API aufrufen kann, müssen Sie diese beschreiben. Das ist die Aufgabe des OpenAPI-Schemas (früher Swagger), einer JSON- oder YAML-Datei, die als Bedienungsanleitung der API dient. Es beschreibt die Endpunkte – die URLs, die Ihr GPT aufrufen kann – die zugehörigen Methoden (GET zum Lesen, POST zum Erstellen, PUT zum Aktualisieren, DELETE zum Löschen), die Parameter, die jeder Endpunkt erwartet, und das Format der zurückgegebenen Antworten. Basierend auf diesem Dokument entscheidet das GPT eigenständig während des Gesprächs, welchen Endpunkt es aufrufen soll und mit welchen Parametern.
Hier ist ein Beispiel für ein minimales Schema einer fiktiven Wetter-API:
openapi: 3.1.0
info:
title: Weather API
version: 1.0.0
servers:
- url: https://example.com
paths:
/forecast:
get:
operationId: getForecast
summary: Get weather forecast for a city
parameters:
- name: city
in: query
required: true
schema:
type: string
responses:
"200":
description: Weather forecast
Gute Nachricht: Sie werden diese Datei fast nie von Grund auf selbst schreiben müssen. Viele Dienste veröffentlichen ihr OpenAPI-Schema direkt in ihrer API-Dokumentation. Wenn nicht, können Tools wie der Swagger Editor – oder sogar ChatGPT selbst, wenn Sie die API beschreiben – es generieren. Und wenn Ihr technisches Team mit Postman arbeitet, exportieren seine Sammlungen ins OpenAPI-Format.
Konfigurieren einer Aktion im GPT-Editor
Die Einrichtung erfolgt in Ihrem GPT-Editor im Web: Gehen Sie zum Abschnitt Aktionen, klicken Sie auf Neue Aktion erstellen, fügen Sie Ihr OpenAPI-Schema in das bereitgestellte Feld ein, konfigurieren Sie die Authentifizierung (dies wird in der nächsten Lektion behandelt) und testen Sie die Aktion dann im Vorschaufenster.
Die Qualität Ihres Schemas bestimmt die Qualität der Aufrufe. Halten Sie sich an drei Gewohnheiten. Erstens: Geben Sie den operationId-Werten explizite Namen: Das GPT stützt sich darauf, um zu entscheiden, welche Aktion es aufrufen soll, und getForecast führt es viel besser als op_42. Zweitens: Schreiben Sie klare Beschreibungen für jeden Endpunkt und jeden Parameter – in natürlicher Sprache, als würden Sie die API einem Kollegen erklären. Drittens: Stellen Sie nur die Endpunkte bereit, die Sie tatsächlich benötigen: Wenn Ihr GPT nur zwei oder drei Routen benötigt, stellen Sie nicht alle vierzig Routen der vollständigen API bereit. Jeder bereitgestellte Endpunkt nimmt Platz im Kontext des GPTs ein und erhöht das Risiko, dass es die falsche auswählt.
Ihre Aufgabe: Eine öffentliche API
Ihre erste Aktion oder deren Plan. Der beste Trainingsplatz ist eine kostenlose, öffentliche API – Wetter, Wechselkurse, Nachrichten –, die keine komplexe Authentifizierung erfordert. Wählen Sie eine aus, holen Sie ihr OpenAPI-Schema ab oder erstellen Sie es, und fügen Sie es als Aktion in Ihrem GPT hinzu. Vergessen Sie nicht, die Aktion mit Ihren Anweisungen zu verknüpfen, indem Sie festlegen, wann sie verwendet werden soll: „Wenn der Nutzer nach dem Wetter fragt, verwenden Sie die getForecast-Aktion.” Testen Sie dann mit verschiedenen Formulierungen, um zu überprüfen, ob das GPT den Aufruf zum richtigen Zeitpunkt auslöst.
Einige Fallstricke lauern bei ersten Versuchen. Ein fehlerhaftes Schema – ein fehlendes Komma im JSON – blockiert alles: Validieren Sie Ihr Schema immer im Swagger Editor, bevor Sie es einfügen. Fehlende Beschreibungen lassen das GPT blind: Ohne sie weiß es nicht, wann eine Aktion relevant ist. Planen Sie auch API-Fehler ein, die früher oder später auftreten werden: Legen Sie das Verhalten in Ihren Anweisungen fest, zum Beispiel: „Wenn die API nicht antwortet, sagen Sie dem Nutzer, er solle es später erneut versuchen” – sonst wird das GPT improvisieren, manchmal indem es Daten erfindet. Und verlassen Sie sich nicht allein auf das Vorschaufenster: Testen Sie unter realen Bedingungen mit echten Daten und echten Nutzerformulierungen.
Kennen Sie zwei Grenzen, bevor Sie beginnen: Ein GPT verwendet verbundene Apps oder Aktionen, nicht beides, und Aktionen funktionieren nicht im Pro-Modus. Wichtigste: Benutzerdefinierte Aktionen werden bei der Migration nicht auf ein Plugin übertragen: Prüfen Sie zuerst, ob das Plugin-Verzeichnis bereits eine App für Ihren Zielservice bietet; wenn nicht, müssen Sie die Integration neu aufbauen, zum Beispiel mit einem MCP-Server.
Offizielle Quellen: Konfigurieren von Aktionen in GPTs (OpenAI Help Center: Authentifizierung, OpenAPI-Schema, Testen, Grenzen) · FAQ zur Einstellung und Migration von Custom GPTs (Aktionen werden nicht übertragen) · OpenAPI-Spezifikation (Schema-Format)
Kernaussagen
- Aktionen verbinden Ihr GPT mit externen Diensten über deren APIs
- Sie müssen ein OpenAPI-Schema bereitstellen, das die verfügbaren Endpunkte beschreibt
- Beschreibungen im Schema sind unerlässlich – das GPT nutzt sie, um zu entscheiden, welche Aktion es aufrufen soll
- Beginnen Sie mit einer kostenlosen öffentlichen API, um den Prozess zu erlernen
- Beschränken Sie die bereitgestellten Endpunkte auf das strikte Minimum für Ihren Anwendungsfall