Überblick
App-Vorlagen sind ein Einrichtungsweg für Business- und Enterprise-Workspaces, die eine workspace-spezifische Version einer ChatGPT-App oder eines Connectors benötigen. Statt eine gemeinsam genutzte App aus dem Verzeichnis zu aktivieren, beginnt ein:e Workspace-Administrator:in oder -Inhaber:in mit einer von OpenAI bereitgestellten Vorlage, ergänzt die organisationsspezifischen Angaben und erstellt eine App als Entwurf zur Prüfung.
Vorlagen sind nützlich, wenn OpenAI das allgemeine App-Verhalten bereitstellen kann, jeder Workspace aber eine anbieterspezifische Konfiguration bereitstellen muss. Je nach Vorlage kann diese Konfiguration einen Tenant- oder Hostnamen, OAuth-Client-Anmeldedaten, Callback-URLs, Scopes, Webhook-Details, URLs verwalteter MCP-Server oder andere Anbietereinstellungen umfassen. Beispielsweise kann eine GitHub-Enterprise-Vorlage den workspace-spezifischen Connector erstellen, den Codex verwendet, um den GitHub-Enterprise-Host dieser Organisation zu erreichen.
Nach der Einrichtung verwenden Mitglieder nicht die ursprüngliche Vorlage. Sie verwenden die daraus erstellte veröffentlichte Workspace-App. Administrator:innen können diese App anschließend wie andere ChatGPT-Apps verwalten, einschließlich Rollenzugriff, Aktionssteuerung, App-Berechtigungen und Anbieterautorisierung.
Codex-Plugins können ebenfalls App-Vorlagen oder aus Vorlagen erstellte Apps enthalten. Wenn ein Plugin eine App-Vorlage enthält, muss ein:e Workspace-Administrator:in oder -Inhaber:in weiterhin die workspace-spezifische App erstellen und veröffentlichen, bevor Mitglieder sie in ChatGPT verbinden und über dieses Plugin verwenden können. Wenn das Plugin ausgeführt wird, verwendet es die in diesem Workspace verfügbare App-Instanz, anstatt Mitglieder aufzufordern, die ursprüngliche Vorlage selbst zu konfigurieren. Wenn die erforderliche Vorlage noch nicht eingerichtet wurde, benötigen Mitglieder möglicherweise zuerst eine:n Administrator:in, die oder der die Einrichtung abschließt. Das Plugin kann eine App-Vorlage nicht eigenständig verwenden.
Verwende diesen Artikel für den allgemeinen Vorlagenablauf. Informationen zur anbieterspezifischen Einrichtung findest du hier:
Vorlagen sind nützlich, wenn dasselbe App-Muster für viele Organisationen funktionieren kann, jede Organisation aber ihre eigene Konfiguration benötigt.
Häufige Beispiele sind:
Die Anbieter-URL enthält einen Unternehmens-Tenant, ein Konto, eine Organisation oder einen Workspace-Hostnamen.
Die Organisation muss ihren eigenen OAuth-Client oder eigene Anbieteranmeldedaten bereitstellen.
Der Anbieter erfordert die Einrichtung einer kundenspezifischen 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 kann in der Regel direkt aus dem App-Verzeichnis aktiviert werden. Eine Vorlage startet stattdessen einen Einrichtungsablauf.
Der übliche Ablauf ist:
Ein:e Administrator:in findet eine Vorlage im App-Verzeichnis.
Der oder die Administrator:in gibt die erforderliche workspace-spezifische Konfiguration ein.
ChatGPT erstellt eine App als Entwurf für den Workspace.
Der oder die Administrator:in prüft und veröffentlicht den Entwurf.
Der oder die Administrator:in konfiguriert Zugriffs- und Aktionseinstellungen für die veröffentlichte App.
Mitglieder verwenden die veröffentlichte Workspace-App, nicht die ursprüngliche Vorlage.
App-Vorlage finden und einrichten
Öffne Workspace-Einstellungen > Apps.
Wähle Verzeichnis aus.
Suche nach dem Anbieter- oder App-Namen.
Achte auf Einträge, die als Vorlagen gekennzeichnet sind.
Wähle Aktivieren aus, um den Einrichtungsablauf zu starten.
Im Einrichtungsablauf werden die Angaben abgefragt, die zum Erstellen der workspace-spezifischen App erforderlich sind. Die genauen Felder hängen von der Vorlage ab.
Beispielsweise kann eine GitHub-Enterprise-Vorlage nach folgenden Angaben fragen:
App-Name und Beschreibung.
GitHub-Enterprise-Hostname.
Callback-URL-Konfiguration.
OAuth-Client-ID und Client Secret.
Privater Schlüssel der GitHub-App.
Angeforderte Scopes.
Details zur Webhook-Einrichtung.
Prüfe jedes Feld sorgfältig, bevor du den Entwurf erstellst. Wenn deine Organisation OAuth- oder Anbieteranmeldedaten zentral verwaltet, stimme dich mit dem Team ab, das für diese Anmeldedaten zuständig ist.
App-spezifische Anleitungen findest du hier: GitHub, Snowflake und Databricks.
OAuth-Client einrichten
Bei manchen Vorlagen muss deine Organisation ihren eigenen OAuth-Client bereitstellen. Wenn dies erforderlich ist, erstelle oder konfiguriere die OAuth-App in der Admin-Konsole des externen Anbieters. Kopiere anschließend die Callback-URL aus ChatGPT in die Redirect- oder Callback-URL-Einstellungen des Anbieters.
Gib die OAuth-Client-ID und das Secret erst dann in ChatGPT ein, nachdem du bestätigt hast, dass die Anbieterkonfiguration den Einrichtungsanweisungen der Vorlage entspricht.
Wenn die Vorlage Standard-Scopes enthält, behalte die Standardwerte bei, es sei denn, deine Organisation hat die Anbieterberechtigungen geprüft und einen klaren Grund, sie zu ändern.
Entwurf erstellen
Nachdem du die erforderlichen Informationen eingegeben hast, wähle Entwurf erstellen aus.
Durch das Erstellen eines Entwurfs wird die App nicht automatisch für Mitglieder verfügbar. Prüfe den Entwurf, veröffentliche ihn und konfiguriere Zugriffs- und Aktionseinstellungen, bevor du Mitglieder bittest, die App zu verwenden.
Die daraus erstellte App veröffentlichen und verwalten
Verwalte die workspace-spezifische App nach der Veröffentlichung über Workspace-Einstellungen > Apps > Aktiviert.
Empfohlene Prüfungen nach der Veröffentlichung:
Bestätige, dass die App unter Aktivierte Apps angezeigt wird.
Lege den Nutzer:innenzugriff für die Rollen fest, die die App verwenden sollen.
Prüfe die Aktionssteuerung für Lese- und Schreibaktionen.
Prüfe unter App-Berechtigungen, wann ChatGPT Mitglieder vor der Verwendung der App fragt.
Bitte eine berechtigte Testperson, Apps in ChatGPT zu öffnen und zu bestätigen, dass die App angezeigt wird.
Wenn für die App eine Anbieterauthentifizierung erforderlich ist, lasse die Testperson ihr Anbieterkonto verbinden.
Führe einen risikoarmen Test-Prompt aus, um zu bestätigen, dass die App wie erwartet funktioniert.
Diese App-Berechtigungen gelten für ChatGPT-Unterhaltungen. Workspace-Agents verwenden pro Agent festgelegte Kontrollen, die von der Ersteller:in des Agents konfiguriert werden. So bestimmen sie, welche App-Aktionen verfügbar sind und wann Endnutzer:innen um Genehmigung gebeten werden. Informationen zum Agent-Verhalten findest du hier: ChatGPT Workspace Agents für Enterprise und Business.
Wenn eine Vorlage nur einmal verwendet werden kann
Manche Vorlagen erstellen möglicherweise nur eine App pro Workspace. 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 verwenden 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.
Prüfe Folgendes:
Die App ist veröffentlicht.
Die App ist für den Workspace aktiviert.
Die Workspace-Rolle des Mitglieds hat Zugriff.
Das Mitglied befindet sich im richtigen Workspace.
Das Mitglied hat die erforderlichen Berechtigungen beim externen Anbieter.
Veröffentlichte Apps erscheinen im ChatGPT-App-Verzeichnis im workspace-spezifischen Bereich.
Fehlerbehebung
Wenn die Einrichtung fehlschlägt oder die App nicht angezeigt wird, prüfe Folgendes:
Der Hostname des Tenants, Kontos oder Workspaces ist korrekt.
Die Callback-URL wurde exakt in die Anbieterkonfiguration kopiert.
Die OAuth-Client-ID und das Client Secret sind korrekt.
Die angeforderten Scopes stimmen mit dem überein, was die OAuth-App des Anbieters zulässt.
Ein Entwurf wurde erstellt.
Der Entwurf wurde veröffentlicht.
Der Rollenzugriff erlaubt der Testperson, die App zu sehen.
Die Berechtigungen beim Anbieter erlauben die getesteten Daten oder Aktionen.
Sicherheitshinweise
Behandle OAuth-Client Secrets und Anbieteranmeldedaten als vertrauliche Informationen.
Prüfe die angeforderten Scopes, bevor du den Entwurf erstellst.
Verwende nach der Veröffentlichung Aktionssteuerung, um einzuschränken, was die App tun kann.
Lege mit App-Berechtigungen fest, wann ChatGPT Mitglieder vor der Verwendung der App fragt.
Beachte, dass die Anbieterberechtigungen weiterhin gelten, nachdem die App in ChatGPT aktiviert wurde.