Überblick
App-Vorlagen bieten eine Einrichtungsmöglichkeit für verwaltete Workspaces, die eine Workspace-spezifische Version einer ChatGPT-App oder eines Connectors benötigen. Personen mit Admin- oder Inhaberrechten für den Workspace können Vorlagen im verfügbaren Verwaltungsbereich Apps oder Plugins finden, eine organisationsspezifische Konfiguration hinzufügen und einen App-Entwurf zur Prüfung erstellen. Verwaltete App-Vorlagen erscheinen nicht in persönlichen Workspaces.
Vorlagen sind hilfreich, wenn OpenAI die gemeinsamen App-Funktionen bereitstellen kann, aber jeder Workspace eine anbieterspezifische Konfiguration benötigt. Je nach Vorlage kann diese Konfiguration einen Mandanten- oder Hostnamen, OAuth-Client-Zugangsdaten, Callback-URLs, Berechtigungsbereiche, Webhook-Details, URLs verwalteter MCP-Server oder andere Anbietereinstellungen umfassen. Beispielsweise kann eine Vorlage für GitHub Enterprise den Workspace-spezifischen Connector erstellen, mit dem Codex auf den GitHub Enterprise-Host der Organisation zugreift.
Nach der Einrichtung verwenden Mitglieder nicht die ursprüngliche Vorlage. Sie verwenden die daraus erstellte und veröffentlichte Workspace-App. Admins können diese App anschließend wie andere ChatGPT-Apps verwalten. In ChatGPT Business aktivieren oder deaktivieren Personen mit Inhaber- oder Adminrechten die App für den Workspace. In ChatGPT Enterprise/Edu können Personen mit Inhaber- oder Adminrechten den rollenbasierten App-Zugriff nutzen, sofern dieser unterstützt wird. Admins können außerdem Aktionssteuerungen, App-Berechtigungen und die Autorisierung beim Anbieter verwalten.
Plugins können App-Vorlagen oder aus Vorlagen erstellte Apps enthalten. Wenn ein Plugin eine App-Vorlage enthält, muss eine Person mit Admin- oder Inhaberrechten für den Workspace die Workspace-spezifische App erstellen und veröffentlichen, bevor Mitglieder sie in ChatGPT verbinden oder über das Plugin nutzen können. Das Plugin verwendet die in diesem Workspace verfügbare App-Instanz. Mitglieder konfigurieren nicht die ursprüngliche Vorlage.
Dieser Artikel beschreibt den allgemeinen Ablauf für Vorlagen. Anleitungen zur anbieterspezifischen Einrichtung findest du hier:
Häufige Gründe für die Verwendung einer Vorlage sind:
Die Anbieter-URL enthält einen Unternehmensmandanten, ein Konto, eine Organisation oder einen Workspace-Hostnamen.
Die Organisation muss einen eigenen OAuth-Client oder eigene Zugangsdaten für den Anbieter bereitstellen.
Der Anbieter verlangt eine unternehmensspezifische Einrichtung der Callback-URL.
Die App soll dasselbe Implementierungsmuster verwenden, während jeder Workspace Zugriff, Aktionen und Sicherheitseinstellungen separat steuert.
Wie sich Vorlagen von regulären Apps unterscheiden
Eine reguläre App lässt sich in der Regel direkt aktivieren. Eine Vorlage startet stattdessen einen Einrichtungsablauf für Workspace-Admins.
Der übliche Ablauf ist:
Eine Person mit Adminrechten findet die Vorlage je nach verfügbarer Oberfläche im Verwaltungsbereich Apps oder Plugins des Workspaces.
Diese Person gibt die erforderliche Workspace-spezifische Konfiguration ein.
ChatGPT erstellt einen App-Entwurf für den Workspace.
Die Person mit Adminrechten prüft und veröffentlicht den Entwurf.
Diese Person konfiguriert die Zugriffs- und Aktionseinstellungen für die veröffentlichte App.
Mitglieder verwenden die veröffentlichte Workspace-App, nicht die ursprüngliche Vorlage.
Eine App-Vorlage finden und einrichten
Die folgenden Schritte beschreiben die Verwaltungsoberfläche Apps. Wenn das betreffende Plugin oder die Vorlage eine Einrichtung unter Plugins in der Admin-Konsole anbietet, folge diesem Einrichtungsablauf. Verwende für die folgenden Schritte die weiterhin verfügbare Oberfläche Apps. Informationen zur Navigation im Workspace und zu den Admin-Steuerungen je nach Plan findest du im Artikel Admin-Steuerungen, Sicherheit und Compliance für Plugins und Apps.
Gehe zu Workspace-Einstellungen > Apps. Du kannst auch die Admin-Konsole aufrufen, den gewünschten ChatGPT-Workspace auswählen und Plugins öffnen. Wähle Legacy-Apps verwalten, um die Seite Apps zu öffnen.
Wähle Verzeichnis.
Suche nach dem Anbieter oder dem App-Namen.
Achte auf Einträge, die als Vorlagen gekennzeichnet sind.
Wähle Aktivieren, um die Einrichtung zu starten.
Bei der Einrichtung werden die Angaben abgefragt, die zum Erstellen der Workspace-spezifischen App benötigt werden. Welche Felder angezeigt werden, hängt von der Vorlage ab.
Eine Vorlage für GitHub Enterprise kann beispielsweise folgende Angaben abfragen:
App-Name und Beschreibung.
Hostname für GitHub Enterprise.
Konfiguration der Callback-URL.
OAuth-Client-ID und Client-Geheimnis.
Privater Schlüssel der GitHub App.
Angeforderte Berechtigungsbereiche.
Angaben zur Webhook-Einrichtung.
Prüfe jedes Feld sorgfältig, bevor du den Entwurf erstellst. Wenn deine Organisation OAuth-Zugangsdaten oder Zugangsdaten für den Anbieter zentral verwaltet, stimme dich mit dem dafür zuständigen Team ab.
Anbieterspezifische Anleitungen zur Einrichtung findest du in den Artikeln zu GitHub Enterprise, Snowflake und Databricks.
OAuth-Client einrichten
Bei manchen Vorlagen muss deine Organisation einen eigenen OAuth-Client bereitstellen. Erstelle oder konfiguriere in diesem Fall die OAuth-App in der Admin-Konsole des externen Anbieters. Kopiere anschließend die Callback-URL aus ChatGPT in die Einstellungen für die Weiterleitungs- oder Callback-URL beim Anbieter.
Gib die OAuth-Client-ID und das Client-Geheimnis erst in ChatGPT ein, nachdem du geprüft hast, dass die Anbieterkonfiguration den Einrichtungsanweisungen der Vorlage entspricht.
Wenn die Vorlage voreingestellte Berechtigungsbereiche enthält, behalte sie bei, es sei denn, deine Organisation hat die Berechtigungen beim Anbieter geprüft und einen klaren Grund, sie zu ändern.
Einen Entwurf erstellen
Wähle nach Eingabe der erforderlichen Informationen Entwurf erstellen.
Durch das Erstellen eines Entwurfs wird die App nicht automatisch für Mitglieder verfügbar. Prüfe und veröffentliche den Entwurf und konfiguriere die Zugriffs- und Aktionseinstellungen, bevor du Mitglieder bittest, die App zu nutzen.
Die erstellte App veröffentlichen und verwalten
Verwalte die App nach der Veröffentlichung unter Plugins. Rufe dazu die Admin-Konsole auf, öffne Plugins und wähle das Plugin aus, das deiner App entspricht. Du kannst die App auch unter Workspace-Einstellungen > Apps verwalten. Informationen zur Navigation im Workspace und zum Zugriff auf Legacy-Apps findest du im Artikel Admin-Steuerungen, Sicherheit und Compliance für Plugins und Apps.
Empfohlene Prüfungen nach der Veröffentlichung:
Prüfe, ob die App unter Aktivierte Apps erscheint.
Aktiviere oder deaktiviere die App in ChatGPT Business für den Workspace. Lege in ChatGPT Enterprise/Edu unter Rollenzugriff fest, welche Rollen die App nutzen dürfen, sofern rollenbasierter App-Zugriff unterstützt wird.
Prüfe unter Aktionen die Lese- und Schreibaktionen.
Prüfe die App-Berechtigungen, um festzulegen, wann ChatGPT Mitglieder vor der Nutzung der App um Zustimmung bittet.
Bitte eine autorisierte Testperson, je nach Verfügbarkeit Apps oder Plugins aufzurufen und zu prüfen, ob die veröffentlichte App erscheint.
Wenn die App eine Authentifizierung beim Anbieter erfordert, bitte die Testperson, ihr Konto beim Anbieter zu verbinden.
Führe einen risikoarmen Test-Prompt aus, um zu prüfen, ob die App wie erwartet funktioniert.
Diese Berechtigungen gelten für ChatGPT-Unterhaltungen. Für Workspace-Agenten gelten separate Steuerungen, die von der Person festgelegt werden, die den Agenten erstellt hat. Weitere Informationen findest du im Artikel ChatGPT-Workspace-Agenten für Enterprise und Business.
Wenn eine Vorlage nur einmal verwendet werden kann
Mit manchen Vorlagen lässt sich möglicherweise nur eine App pro Workspace erstellen. Wenn eine Vorlage bereits verwendet wurde, ist die Schaltfläche „Aktivieren“ möglicherweise nicht verfügbar. Verwalte in diesem Fall den vorhandenen Entwurf oder die veröffentlichte App, statt eine weitere App aus derselben Vorlage zu erstellen.
Was Mitglieder sehen
Mitglieder sehen die veröffentlichte App, die aus der Vorlage erstellt wurde. Ob ein Mitglied sie sehen oder nutzen kann, hängt von den Workspace-Einstellungen und der Autorisierung beim Anbieter ab. Wenn die App in einem Plugin enthalten ist, können Mitglieder über dieses Plugin auf sie stoßen. Es gelten jedoch weiterhin dieselben Anforderungen an den Workspace-Zugriff und die Autorisierung beim Anbieter.
Wenn ein Plugin eine aus einer Vorlage erstellte App benötigt, zeigt es möglicherweise an, dass eine Einrichtung erforderlich ist. Dieser Hinweis kann bestehen bleiben, bis eine Person mit Adminrechten die Workspace-spezifische App erstellt und veröffentlicht, sie in ChatGPT Business für den Workspace oder in ChatGPT Enterprise/Edu für die entsprechende Rolle aktiviert, sofern rollenbasierter App-Zugriff unterstützt wird, und alle erforderlichen Autorisierungen beim Anbieter durch die nutzende Person oder eine Person mit Adminrechten abgeschlossen sind.
Prüfe Folgendes:
Die App ist veröffentlicht.
Die App ist für den Workspace aktiviert.
In ChatGPT Enterprise/Edu hat die Workspace-Rolle des Mitglieds Zugriff, sofern rollenbasierter App-Zugriff unterstützt wird.
Das Mitglied befindet sich im richtigen Workspace.
Das Mitglied hat die erforderlichen Berechtigungen beim externen Anbieter.
Veröffentlichte Apps erscheinen in den verfügbaren Workspace-Einstellungen unter Apps oder auf der Seite Plugins in der Admin-Konsole. Wenn die App Teil eines Plugins ist, kann sie auch auf der Detailseite des Plugins als erforderliche oder optionale App erscheinen.
Probleme mit App-Vorlagen beheben
Wenn die Einrichtung fehlschlägt oder die App nicht erscheint, prüfe Folgendes:
Der Mandanten-, Konto- oder Workspace-Hostname ist korrekt.
Die Callback-URL wurde exakt in die Anbieterkonfiguration kopiert.
Die OAuth-Client-ID und das Client-Geheimnis sind korrekt.
Die angeforderten Berechtigungsbereiche entsprechen den Berechtigungen, die die OAuth-App beim Anbieter zulässt.
Ein Entwurf wurde erstellt.
Der Entwurf wurde veröffentlicht.
In ChatGPT Business ist die App für den Workspace aktiviert. In ChatGPT Enterprise/Edu erlaubt der Rollenzugriff der Testperson, die App zu sehen, sofern rollenbasierter App-Zugriff unterstützt wird.
Die Berechtigungen auf Anbieterseite erlauben den Zugriff auf die getesteten Daten oder die Ausführung der getesteten Aktion.
Sicherheitsanforderungen prüfen
Behandle OAuth-Client-Geheimnisse und Zugangsdaten für den Anbieter als vertrauliche Informationen.
Prüfe die angeforderten Berechtigungsbereiche, bevor du den Entwurf erstellst.
Begrenze nach der Veröffentlichung unter Aktionen, was die App tun kann.
Lege unter App-Berechtigungen fest, wann ChatGPT Mitglieder vor der Nutzung der App um Zustimmung bittet.
Beachte, dass die Berechtigungen beim Anbieter auch nach der Aktivierung der App in ChatGPT weiterhin gelten.