Übersicht

In diesem Artikel wird erläutert, wie Sie Aktionen in einem GPT konfigurieren, einschließlich der Verbindung mit externen APIs, der Definition, was das GPT tun kann, und der Verwaltung von Authentifizierung, Schemas und Workspace-Einschränkungen.

Zum Konfigurieren einer Aktion benötigen Sie die API-Details für den Dienst, den Sie verbinden möchten, einschließlich Authentifizierungsinformationen und eines OpenAPI-Schemas. 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 definiert, was die API tun kann.

Einschränkungen

Wenn Ihr Workspace keine Aktions-Domains zulässt, können benutzerdefinierte GPT-Aktionen nicht ausgeführt werden, weil keine Aktions-Domain die Allowlist-Prüfungen bestehen kann. Das bedeutet nicht zwangsläufig, dass die gesamte GPT-Sichtbarkeit oder der gesamte GPT-Zugriff blockiert ist.

Aktionen sind im Pro-Modus nicht verfügbar. Wenn Sie ein GPT mit benutzerdefinierten Aktionen erstellen oder bearbeiten, zeigt die Modellauswahl nur Nicht-Pro-Modelle an, die Aktionen unterstützen.

Migration zu Plugins

Benutzerdefinierte Aktionen werden bei der Migration eines GPT zu einem Plugin nicht automatisch übertragen. Richte eine Ersatzintegration ein und teste sie, bevor du dich auf das Plugin verlässt. Die folgenden Anweisungen gelten weiterhin für bestehende, noch nicht migrierte GPTs, die du bearbeiten darfst. Hinweise zur Migration findest du in den FAQ zur Einstellung und Migration individueller GPTs.

Eine Aktion erstellen

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

Anschließend konfigurierst du, wie dein GPT eine Verbindung zu einer externen API herstellt und diese nutzt.

Teste die Aktion nach der Konfiguration in der Vorschau, um zu prüfen, ob sie wie erwartet funktioniert.

Authentifizierung

Die Authentifizierung steuert, wie Ihr GPT eine Verbindung zu einer externen API herstellt.

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

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

• Basic

• Bearer

• Benutzerdefinierter Header

OAuth

Verwenden Sie OAuth, wenn Aktionen Nutzerkonten erfordern. OAuth erfordert:

• Client-ID und Client Secret

• Autorisierungs-URL und Token-URL

• Scope und Methode zum Token-Austausch

Der Editor stellt eine Callback-URL zum Abschließen des OAuth-Flows bereit.

Schema

Das Schema definiert, was Ihre API tun kann. Es teilt ChatGPT Folgendes mit:

• Welcher Server aufgerufen werden soll

• Welche Endpunkte verfügbar sind

• Welche Parameter sie akzeptieren

• Wie jede Aktion identifiziert wird (Vorgangs-IDs)

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

Schema hinzufügen

Sie können ein Schema auf drei Arten hinzufügen:

• Direkt in den Editor einfügen

• Aus einer URL importieren

• Mit einem integrierten Beispiel beginnen:

  • Wetter (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 die folgende Meldung angezeigt wird:


„In den Einstellungen Ihres Workspaces sind keine Domains zugelassen.“

Das bedeutet, dass Aktionen durch Ihre Workspace-Einstellungen eingeschränkt sind.

• Administrator:innen können alle Domains zulassen oder Aktionen auf genehmigte Domains beschränken.

• Wenn keine Domains zugelassen sind, können Sie keine Aktionen verwenden.

Informationen zu Kontrollen auf Workspace-Ebene für Aktionen und Domain-Einschränkungen finden Sie unter: 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:innen werden möglicherweise aufgefordert, Aktionen vor der Ausführung zu genehmigen.

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

Weitere Hilfe

Wenn Sie Hilfe beim Schreiben oder Debuggen von Aktionen benötigen, verwenden Sie das offizielle ActionsGPT.