Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

GPTs mit externen APIs verbinden

Lektion 9 von 17 Aktualisiert am 5. November 2026 Mittelstufe
Auf dieser Seite
  1. Über den Standalone-GPT hinaus
  2. Was ist eine Aktion?
  3. Das OpenAPI-Schema
  4. Konfigurieren einer Aktion im GPT-Editor
  5. Ihre Aufgabe: Eine öffentliche API
  6. Kernaussagen

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.

Eine Aktion in vier Schritten Vier Schritte: Beschreiben Sie die API mit einem OpenAPI-Schema in JSON oder YAML; wählen Sie Authentifizierung, keine, Schlüssel oder OAuth; testen Sie im Vorschaufenster; das GPT ruft dann die API auf, wenn es nützlich ist. API VERBINDEN Eine Aktion in vier Schritten 1 Schema OpenAPI, JSON oder YAML 2 Zugriff Keine, Schlüssel oder OAuth 3 Testen Im Vorschaufenster 4 Nutzung Das GPT ruft die API auf Keine Aktionen im Pro-Modus, und Aktionen werden nicht auf ein Plugin übertragen.
Basierend auf dem Artikel „Konfigurieren von Aktionen in GPTs" aus dem OpenAI Help Center (November 2026).

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