Überblick

In diesem Artikel wird erklärt, wie du Aktionen in einem GPT konfigurierst – einschließlich der Verbindung zu externen APIs, der Definition dessen, was das GPT tun kann, sowie der Verwaltung von Authentifizierung, Schemata und Workspace-Einschränkungen.

Um eine Aktion zu konfigurieren, benötigst du die API-Details des Dienstes, mit dem du dich verbinden möchtest – einschließlich Authentifizierungsinformationen und einem OpenAPI-Schema. Ein GPT kann entweder Apps oder Aktionen verwenden, aber nicht beides gleichzeitig.

Jede Aktion wird durch zwei Hauptkomponenten definiert: wie sich das GPT bei der API authentifiziert und ein Schema, das festlegt, was die API kann.

Einschränkungen

Wenn dein Workspace keine Aktionsdomains zulässt, können benutzerdefinierte GPT-Aktionen nicht ausgeführt werden, weil keine Aktionsdomain die Prüfungen der Zulassungsliste bestehen kann. Das bedeutet nicht zwangsläufig, dass die Sichtbarkeit oder der Zugriff auf alle GPTs blockiert ist.

Aktionen sind im Pro-Modus nicht verfügbar; wenn du ein GPT mit benutzerdefinierten Aktionen erstellst, stehen darin nur die Modelle Instant und Thinking zur Auswahl.

Eine Aktion erstellen

Gehe im GPT-Editor zum Abschnitt Aktionen und wähle Neue Aktion erstellen.

Anschließend konfigurierst du, wie dein GPT eine externe API verbindet und verwendet.

Nachdem du eine Aktion konfiguriert hast, teste sie in der Vorschau, um zu bestätigen, dass sie sich wie erwartet verhält.

Authentifizierung

Die Authentifizierung steuert, wie sich dein GPT mit einer externen API verbindet.

Verfügbare Optionen:

• Keine: Keine Authentifizierung erforderlich

• API-Schlüssel: Verwendet einen geheimen Schlüssel zur Autorisierung von Anfragen

• OAuth: Verwendet die Nutzeranmeldung für kontobasierten Zugriff

API-Schlüssel

Verwende API-Schlüssel-Authentifizierung für Server-zu-Server-Zugriff. Sie kann wie folgt konfiguriert werden:

• Basic

• Bearer

• Benutzerdefinierter Header

OAuth

Verwende OAuth, wenn Aktionen Nutzerkonten erfordern. OAuth benötigt:

• Client-ID und Client Secret

• Autorisierungs-URL und Token-URL

• Scope und Methode für den Token-Austausch

Der Editor stellt eine Callback-URL bereit, um den OAuth-Flow abzuschließen.

Schema

Das Schema definiert, was deine API kann. Es teilt ChatGPT mit:

• Welcher Server aufgerufen werden soll

• Welche Endpunkte verfügbar sind

• Welche Parameter sie akzeptieren

• Wie jede Aktion identifiziert wird (Operation-IDs)

Das Schema muss als OpenAPI-Spezifikation in JSON oder YAML bereitgestellt werden.

Ein Schema hinzufügen

Du kannst ein Schema auf drei Arten hinzufügen:

• Direkt in den Editor einfügen

• Von einer URL importieren

• Mit einem integrierten Beispiel starten:

  • Weather (JSON)

  • Pet Store (YAML)

  • Leere Vorlage

Wenn das Schema gültig ist, zeigt der Editor erkannte Aktionen an. Wenn es ungültig ist, werden Validierungsfehler angezeigt.

Workspace-Einschränkungen (Enterprise und Edu)

Wenn du folgende Meldung siehst:

„In den Einstellungen deines Workspace sind keine Domains zugelassen.“

Dann bedeutet das, dass Aktionen durch die Einstellungen deines Workspace eingeschränkt sind.

• Admins können alle Domains zulassen oder Aktionen auf genehmigte Domains beschränken.

• Wenn keine Domains zugelassen sind, kannst du keine Aktionen verwenden.

Weitere Informationen zu Workspace-weiten Steuerungsmöglichkeiten für Aktionen und Domain-Einschränkungen findest du hier: GPT-Zugriff in Enterprise- und Edu-Workspaces verwalten.

Datenschutz und Nutzerkontrollen

• Jede Aktion kann eine URL zur Datenschutzrichtlinie enthalten.

• Öffentliche GPTs (Link oder GPT Store) mit Aktionen müssen eine gültige URL zur Datenschutzrichtlinie enthalten.

• Nutzer werden möglicherweise gebeten, Aktionen zu genehmigen, bevor sie ausgeführt werden.

• Bei OAuth-Aktionen können Nutzer verbundene Konten überprüfen und verwalten.

Weitere Hilfe

Wenn du Hilfe beim Schreiben oder Debuggen von Aktionen brauchst, nutze das offizielle ActionsGPT.