GPT Actions: ChatGPT Ihre APIs aufrufen lassen

# GPT Actions: ChatGPT Ihre APIs aufrufen lassen

GPT Actions erlauben einem Custom GPT, externe APIs aufzurufen, die Sie beschreiben. Statt zu raten, holt ChatGPT damit Live-Daten oder löst in Ihrem Namen ein echtes System aus. Sie schreiben eine kleine OpenAPI-Spec, richten sie auf Ihren Endpoint, konfigurieren die Auth, und das Modell entscheidet im Gespräch, wann es den Aufruf macht.

Das ist dieselbe Mechanik wie Function Calling in der APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →, nur verpackt für den No-Code-Builder für Custom GPTs. Sie definieren die *Tools*, ChatGPT übernimmt das *Wann* und *Wie*.

Was eine Action tatsächlich ist

Eine Action besteht aus einem oder mehreren HTTP-Endpoints, die einem GPT über eine OpenAPI-Spezifikation zugänglich gemacht werden. OpenAPI (früher Swagger) ist eine standardisierte, maschinenlesbare Beschreibung einer REST-APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →: Pfade, Parameter, Request Bodies und Responses.

Wenn Sie eine Action zu einem GPT hinzufügen, passieren zur Laufzeit drei Dinge:

1. Das Modell liest Ihre Operationsbeschreibungen und entscheidet, dass ein Aufruf nötig ist.

2. ChatGPT baut den HTTP-Request (füllt Parameter aus dem Gespräch), hängt die Auth an und sendet ihn.

3. Ihre APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → antwortet mit JSON, und das Modell liest dieses JSON, um seine Antwort zu formulieren.

Das Modell sieht Ihren Server nie. Es sieht nur das SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen →, das Sie ihm gegeben haben, und die zurückkommende Response. Das heißt: Ihre description-Felder sind keine Dokumentation, sie sind *Prompt*. Vage Beschreibungen führen zu falschen Aufrufen.

Wo Actions liegen

Actions werden im GPT-Editor auf chatgpt.com konfiguriert (Explore GPTs, Create, dann der Configure-Tab). Scrollen Sie zu Actions und klicken Sie auf Create new action. Sie fügen ein SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → ein, wählen einen Authentifizierungstyp, und ChatGPT validiert das direkt.

Verwechseln Sie Actions nicht mit Connectors. Connectors sind vorgefertigte, von OpenAI verwaltete Integrationen (Google Drive, SharePoint, GitHub und andere), die Daten *in* ChatGPT bringen, für Suche und Retrieval. Actions sind *Ihre* eigenen APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →-Aufrufe, von Ihnen definiert. Nutzen Sie einen Connector, wenn es für die Quelle einen gibt; bauen Sie eine Action, wenn Sie Ihr eigenes Backend ansprechen oder etwas auslösen müssen.

Ein konkretes Beispiel: Bestellstatus abfragen

Angenommen, Ihr Support-Team will ein GPT, das die Frage „Wo ist Bestellung 10428?“ beantwortet, indem es Ihre interne Orders-APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → aufruft. Ihr Endpoint existiert bereits:

GET https://api.acme-shop.com/v1/orders/{orderId}

ErErDas Verhältnis von Interaktionen (Likes, Kommentare, Shares) zur Reichweite eines Inhalts. Zeigt, wie stark die Zielgruppe reagiert, gemessen an der Zahl der Personen, die den Inhalt gesehen haben.Vollständige Definition ansehen → liefert etwa Folgendes:

{
  "orderId": "10428",
  "status": "shipped",
  "carrier": "DHL",
  "trackingNumber": "JD0149...",
  "estimatedDelivery": "2026-02-14"
}

Nun beschreiben Sie diesen Endpoint für das GPT. Hier ist ein sauberes, minimales OpenAPI-3.1-SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen →, das Sie direkt in den Actions-Editor einfügen kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen:

openapi: 3.1.0
info:
  title: Acme Orders API
  version: 1.0.0
servers:
  - url: https://api.acme-shop.com/v1
paths:
  /orders/{orderId}:
    get:
      operationId: getOrderStatus
      summary: Get the current status and tracking info for one order.
      description: >
        Look up a single order by its numeric ID. Use this whenever a
        user asks where their order is, its delivery date, or its
        shipping status. Returns status, carrier, and tracking number.
      parameters:
        - name: orderId
          in: path
          required: true
          description: The order's numeric ID, e.g. 10428.
          schema:
            type: string
      responses:
        "200":
          description: Order found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderId: { type: string }
                  status: { type: string }
                  carrier: { type: string }
                  trackingNumber: { type: string }
                  estimatedDelivery: { type: string, format: date }
        "404":
          description: No order with that ID exists.

Ein paar Punkte machen dieses SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → gut und nicht nur gültig:

• `operationId` ist beschreibend. getOrderStatus liest sich für das Modell besser als get1. Das wird der Funktionsname.
• Die `description` sagt dem Modell, wann es sie nutzen soll. Beachten Sie den Satz „Use this whenever a user asks...“. Das ist Intent-Routing.
• Der `404` ist dokumentiert. Wenn das Modell einen 404 erhält, kann es dem Nutzer sagen „Ich konnte diese Bestellung nicht finden“, statt einen Status zu halluzinieren.

Nach dem Speichern zeigt ChatGPT die verfügbare Operation. Testen Sie sie, indem Sie dem GPT eine natürliche Frage stellen. Beim ersten Aufruf einer neuen Domain fragt ChatGPT beim Nutzer nach Bestätigung und sendet dann den Request.

Authentifizierung

Actions unterstützen im Builder drei Auth-Modi: None, API Key und OAuth. Das SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → oben legt fest, *was* aufgerufen wird; die Auth steuert, *wie Sie belegen, wer Sie sind*.

APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → Key

Die einfachste gesicherte Option. Sie fügen einen Key im GPT-Editor ein, wählen, wie ererDas Verhältnis von Interaktionen (Likes, Kommentare, Shares) zur Reichweite eines Inhalts. Zeigt, wie stark die Zielgruppe reagiert, gemessen an der Zahl der Personen, die den Inhalt gesehen haben.Vollständige Definition ansehen → gesendet wird (Bearer-Header, Basic oder ein eigener Header), und OpenAI speichert ihn verschlüsselt. ChatGPT hängt ihn an jeden Aufruf. Fügen Sie Ihrem SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → einen passenden securitySchemes-Block hinzu:

components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
security:
  - bearerAuth: []

Den Key teilen alle, die das GPT nutzen. Für einen Read-only-Endpoint im internen Netz mit eigenen Zugriffskontrollen ist das in Ordnung. Es ist *nicht* in Ordnung, wenn jeder Nutzer nur seine eigenen Daten sehen soll, denn das Modell würde mit einer gemeinsamen Identität agieren.

OAuth

Wenn Sie Identität pro Nutzer brauchen (jeder Support-Agent oder jeder Kunde authentifiziert sich selbst), nutzen Sie OAuth. Sie geben Authorization-URL, TokenTokenEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen →-URL, Client-ID, Client-Secret und Scopes an. ChatGPT führt den Standard-OAuth-Flow aus: Der Nutzer klickt Sign in, genehmigt den Zugriff auf Ihrem Auth-Server, und ChatGPT speichert das TokenTokenEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen → dieses Nutzers. Aufrufe tragen dann *die Berechtigungen dieses Nutzers*.

Das ist die richtige Wahl für alles, was Daten schreibt oder private Datensätze offenlegt. Das komplette Setup steht in der Actions-Authentifizierungs-Dokumentation.

Eine Anmerkung zu Secrets und Rate Limits

Legen Sie Zugangsdaten niemals ins SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → selbst oder in die Instructions des GPT. Wer ein GPT nutzen kann, kann es manchmal dazu bringen, seine Konfiguration zu verraten. Bewahren Sie Secrets in den dafür vorgesehenen Auth-Feldern und schützen Sie Ihren Endpoint mit eigenem Rate Limiting. Ein beliebtes GPT kann echten Traffic erzeugen, und das Modell kann bei Fehlern erneut versuchen.

Die APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → für ein Modell entwerfen, nicht für einen Menschen

Eine REST-APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → für Engineers und eine für ein LLMLLMEin Large Language Model ist ein KI-System, das auf riesigen Textmengen trainiert wurde, um Sprache vorherzusagen und zu erzeugen. Damit sind Aufgaben wie Schreiben, Zusammenfassen und Beantworten von Fragen möglich.Vollständige Definition ansehen → unterscheiden sich in Feinheiten. Ziehen Sie hier an:

• Liefern Sie kleines, flaches JSON. Die Response landet im Context WindowContext WindowDas Context Window ist die maximale Textmenge (gemessen in Tokens), die ein Sprachmodell auf einmal verarbeiten kann, einschließlich Input-Prompt und generiertem Output.Vollständige Definition ansehen → und kostet TokensTokensEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen →. Streichen Sie Felder, die das Modell nicht braucht. Eine Bestellabfrage braucht nicht das komplette Audit-Log.
• Nutzen Sie klare Feldnamen. estimatedDelivery ist besser als est_dlv_dt. Das Modell schließt über Namen.
• Machen Sie Fehler lesbar. Geben Sie bei Fehlern eine menschenlesbare message zurück, damit das Modell sie weitergeben kann.
• Halten Sie Operationen schmal. Ein Endpoint, der fünf Dinge tut, verwirrt das Routing. Besser getOrderStatus, cancelOrder und getInvoice als separate Operationen mit eigenen Beschreibungen.

Eine Konsequenz, die man sich einprägen sollte: Das Modell kann nur tun, was Ihr SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → *beschreibt*. Wenn es Bestellungen stornieren soll, brauchen Sie eine cancelOrder-Operation (ein POST oder DELETE) mit eigener Beschreibung und idealerweise OAuth, damit die Action als echter Nutzer mit Stornoberechtigung läuft.

Folgenreiche Aktionen und Bestätigung

Manche Aufrufe sind Read-only. Manche verändern die Welt: eine Zahlung erstatten, eine E-Mail senden, einen Datensatz löschen. ChatGPT behandelt diese anders.

Standardmäßig fragt ChatGPT den Nutzer um Bestätigung, bevor es eine Action auf einer neuen Domain aufruft. Bei Schreibvorgängen wollen Sie diese Reibung. Sie kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen Operationen so markieren, dass der Nutzer jedes Mal bestätigen muss, was bei allem Destruktiven gute Praxis ist. Behandeln Sie jedes POST, PUT, PATCH und DELETE als folgenreich, bis das Gegenteil bewiesen ist, und entwerfen Sie Ihren Endpoint so, dass ein Bestätigungsschritt günstig ist (etwa ein Flow mit zwei Aufrufen: einer für die Vorschau, einer für das Commit).

Behalten Sie eine klare Grenze im Kopf. Das GPT schließt über Ihre Beschreibungen und kann die falsche Operation aufrufen oder das falsche Argument übergeben. *Ihr Server* ist die eigentliche Autorität. Validieren Sie jeden Request serverseitig: prüfen, dass die Bestellung zum authentifizierten Nutzer gehört, dass der Betrag innerhalb der Grenzen liegt, dass die ID wohlgeformt ist. Gehen Sie nie davon aus, dass das Modell es richtig gemacht hat.

Wie das mit der APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → und dem Agents SDK zusammenhängt

Actions sind die Custom-GPT-Oberfläche für Tool-Nutzung. Darunter treibt dieselbe Idee die OpenAI APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → an, wo Sie Tools als JSON-Schemas definieren und das Modell einen strukturierten Tool-Call zurückgibt, den Ihr Code ausführt. Wenn Sie aus dem GPT-Builder herauswachsen (Sie brauchen eigene Logik zwischen den Aufrufen, ein eigenes UI oder Orchestrierung über viele Tools), wechseln Sie zur Responses API oder zum Agents SDK, wo Sie den Loop direkt steuern.

Der Migrationspfad ist klar: Die Beschreibungen und Parameter-Schemas, die Sie für eine Action geschrieben haben, übertragen sich fast direkt in Tool-Definitionen im Code. Sehen Sie GPT Actions als die gehostete Variante desselben Muster ohne eigene Orchestrierung. Prototypen Sie eine Integration als Action und heben Sie sie ins Agents SDK, wenn Sie volle Kontrolle brauchen.

Actions debuggen

Wenn ein Aufruf sich falsch verhält, arbeiten Sie das in dieser Reihenfolge durch:

1. Hat das Modell überhaupt aufgerufen? Wenn es aus dem Bauch heraus geantwortet hat, ist Ihre description zu schwach oder zu generisch. Ergänzen Sie den expliziten Trigger-Satz „Use this when...“.

2. Falsche Parameter? Prüfen Sie die description-Felder und Typen der Parameter. Mehrdeutigkeit hier erzeugt fehlerhafte Requests.

3. Auth-Fehler? Testen Sie den Endpoint mit genau demselben Key oder TokenTokenEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen → außerhalb von ChatGPT (ein curl-Aufruf), um zu isolieren, ob das Problem Ihre Auth oder die Konfiguration des GPT ist.

4. Schema beim Speichern abgelehnt? Der Editor validiert gegen OpenAPI 3.1. Fügen Sie Ihr YAML in einen externen Validator ein, um die problematische Zeile zu finden.

Ein schneller curl-Check, bevor Sie überhaupt den Builder anfassen:

curl -s https://api.acme-shop.com/v1/orders/10428 \
  -H "Authorization: Bearer $ACME_TOKEN"

Wenn das sauberes JSON zurückgibt, ist die GPT-Seite nur SchemaSchemaEin Schema ist der formale Bauplan, der festlegt, wie Daten in einer Datenbank, einer Datei oder einer Nachricht strukturiert, benannt, typisiert und miteinander verknüpft sind.Vollständige Definition ansehen → und Auth-Konfiguration.

Key Takeaways

• Schreiben Sie Beschreibungen als Prompts, nicht als Dokumentation. Über die Felder operationId, summary und description entscheidet das Modell, wann und wie es Ihre APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → aufruft. Nehmen Sie in jede Operation einen expliziten Satz „Use this when...“ auf.
• Passen Sie die Auth an die Identitätsanforderungen an. APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen → Key für gemeinsame, Read-only-interne Endpoints; OAuth immer dann, wenn jeder Nutzer als ererDas Verhältnis von Interaktionen (Likes, Kommentare, Shares) zur Reichweite eines Inhalts. Zeigt, wie stark die Zielgruppe reagiert, gemessen an der Zahl der Personen, die den Inhalt gesehen haben.Vollständige Definition ansehen → selbst agieren soll oder die Action Daten schreibt.
• Behandeln Sie das Modell als nicht vertrauenswürdigen Input. Validieren Sie jeden Request serverseitig und markieren Sie Schreiboperationen als folgenreich, damit Nutzer bestätigen, bevor sich etwas ändert.
• Halten Sie Responses klein und flach. Geben Sie nur die Felder zurück, die das Modell braucht; die Response verbraucht Context-TokensTokensEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen →, und das Modell schließt über Ihre Feldnamen.
• Prototyp als Action, Aufstieg zum Agents SDK. Dieselben Schemas lassen sich übernehmen, also starten Sie im GPT-Builder und wechseln Sie zu Code, wenn Sie Orchestrierung oder eigene Logik zwischen den Aufrufen brauchen.