Ü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.
Aktion erstellen
Navigieren Sie im GPT-Editor zum Abschnitt Aktionen und wählen Sie Neue Aktion erstellen aus.
Anschließend konfigurieren Sie, wie Ihr GPT eine Verbindung zu einer externen API herstellt und diese verwendet.
Testen Sie eine Aktion nach der Konfiguration in der Vorschau, um zu bestätigen, dass sie sich wie erwartet verhält.
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.