Überblick
App-Vorlagen bieten einen Einrichtungsweg für verwaltete Workspaces, die eine Workspace-spezifische Version einer ChatGPT-App oder eines Connectors benötigen. Personen mit Administrator- oder Inhaberrolle im Workspace können im verfügbaren Adminbereich unter Apps oder Plug-Ins nach Vorlagen suchen, unternehmensspezifische Konfigurationen ergänzen und eine App als Entwurf zur Prüfung erstellen. Vorlagen für verwaltete Apps erscheinen nicht in persönlichen Workspaces.
Vorlagen sind nützlich, wenn OpenAI das allgemeine Verhalten der App bereitstellen kann, aber jeder Workspace eine anbieterspezifische Konfiguration bereitstellen muss. Je nach Vorlage kann diese Konfiguration einen Mandanten- oder Hostnamen, OAuth-Client-Anmeldedaten, Callback-URLs, Bereiche, Webhook-Details, URLs verwalteter MCP-Server oder andere Anbietereinstellungen umfassen. Eine Vorlage für GitHub Enterprise kann beispielsweise den Workspace-spezifischen Connector erstellen, über den 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. Anschließend kann die Administration diese App wie andere ChatGPT-Apps verwalten. Dazu gehören Rollenzugriff, Aktionssteuerung, App-Berechtigungen und die Autorisierung beim Anbieter.
Plug-Ins können App-Vorlagen oder daraus erstellte Apps enthalten. Enthält ein Plug-In eine App-Vorlage, muss eine Person mit Administrator- oder Inhaberrolle im Workspace die Workspace-spezifische App erstellen und veröffentlichen, bevor Mitglieder sie mit ChatGPT verbinden oder über das Plug-In verwenden können. Das Plug-In 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. Informationen zur anbieterspezifischen Einrichtung findest du hier:
Häufige Gründe für die Verwendung einer Vorlage sind:
Die Anbieter-URL enthält den Hostnamen eines Mandanten, Kontos, einer Organisation oder eines Workspace.
Die Organisation muss einen eigenen OAuth-Client oder eigene Anmeldedaten für den Anbieter bereitstellen.
Der Anbieter verlangt die Einrichtung einer kundenspezifischen Callback-URL.
Die App soll dasselbe Implementierungsmuster verwenden, während jeder Workspace Zugriff, Aktionen und Sicherheitseinstellungen separat steuert.
Unterschiede zwischen Vorlagen und regulären Apps
Eine reguläre App lässt sich normalerweise direkt aktivieren. Eine Vorlage startet stattdessen einen Einrichtungsablauf für die Workspace-Administration.
Der übliche Ablauf:
Eine Person mit Administratorrolle findet die Vorlage je nach verfügbarer Oberfläche im Adminbereich des Workspace unter Apps oder Plug-Ins.
Die Person gibt die erforderliche Workspace-spezifische Konfiguration ein.
ChatGPT erstellt eine App als Entwurf für den Workspace.
Die Person prüft und veröffentlicht den Entwurf.
Die Person konfiguriert die Zugriffs- und Aktionseinstellungen für die veröffentlichte App.
Mitglieder verwenden die veröffentlichte Workspace-App, nicht die ursprüngliche Vorlage.
App-Vorlage suchen und einrichten
Die folgenden Schritte beschreiben die Verwaltungsoberfläche unter Apps. Wenn dein Workspace Administration > Plug-Ins verwendet, öffne stattdessen das betreffende Plug-In oder die Vorlage und folge dem Einrichtungsablauf. Informationen zur Navigation im Workspace findest du unter Verwaltungsfunktionen, Sicherheit und Compliance für Plug-Ins und Apps.
Öffne Workspace-Einstellungen > Apps.
Wähle Verzeichnis aus.
Suche nach dem Namen des Anbieters oder der App.
Suche nach Einträgen, die als Vorlagen gekennzeichnet sind.
Wähle Aktivieren aus, um die Einrichtung zu starten.
Bei der Einrichtung werden die Angaben abgefragt, die zum Erstellen der Workspace-spezifischen App erforderlich sind. Die genauen Felder hängen von der Vorlage ab.
Eine Vorlage für GitHub Enterprise kann beispielsweise folgende Angaben abfragen:
Name und Beschreibung der App.
Hostname von GitHub Enterprise.
Konfiguration der Callback-URL.
OAuth-Client-ID und Client-Secret.
Privater Schlüssel der GitHub App.
Angeforderte Bereiche.
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 zuständigen Team ab.
Informationen zur anbieterspezifischen Einrichtung findest du unter GitHub Enterprise, Snowflake und Databricks.
OAuth-Client einrichten
Bei einigen Vorlagen muss deine Organisation einen eigenen OAuth-Client bereitstellen. Erstelle oder konfiguriere in diesem Fall die OAuth-App in der Verwaltungskonsole des externen Anbieters. Kopiere anschließend die Callback-URL aus ChatGPT in die Einstellungen des Anbieters für Weiterleitungs- oder Callback-URLs.
Gib die OAuth-Client-ID und das Client-Secret erst in ChatGPT ein, nachdem du bestätigt hast, dass die Anbieterkonfiguration den Einrichtungsanweisungen der Vorlage entspricht.
Wenn die Vorlage Standardbereiche enthält, behalte diese bei, sofern deine Organisation die Anbieterberechtigungen nicht geprüft hat und kein klarer Grund für eine Änderung besteht.
Entwurf erstellen
Wähle nach Eingabe der erforderlichen Informationen Entwurf erstellen aus.
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 verwenden.
Die erstellte App veröffentlichen und verwalten
Verwalte die Workspace-spezifische App nach der Veröffentlichung über die verfügbaren Workspace-Einstellungen unter Apps oder Plug-Ins.
Empfohlene Prüfungen nach der Veröffentlichung:
Bestätige, dass die App unter Aktivierte Apps erscheint.
Lege unter Rollenzugriff fest, welche Rollen die App verwenden dürfen.
Prüfe unter Aktionen die Lese- und Schreibaktionen.
Lege unter App-Berechtigungen fest, wann ChatGPT Mitglieder vor der Verwendung der App um Zustimmung bittet.
Bitte eine autorisierte Testperson, je nach verfügbarer Oberfläche Apps oder Plug-Ins zu öffnen und zu bestätigen, dass die veröffentlichte App erscheint.
Wenn die App eine Authentifizierung beim Anbieter erfordert, soll die Testperson ihr Anbieterkonto verbinden.
Führe einen risikoarmen Test-Prompt aus, um zu bestätigen, dass die App wie erwartet funktioniert.
Diese Berechtigungen gelten für Unterhaltungen in ChatGPT. Workspace-Agenten verwenden separate Steuerungen, die von der Person festgelegt werden, die den Agenten erstellt. Weitere Informationen findest du unter ChatGPT Workspace-Agenten für Enterprise und Business.
Wenn eine Vorlage nur einmal verwendet werden kann
Einige 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 aus derselben Vorlage eine weitere App zu erstellen.
Was Mitglieder sehen
Mitglieder sehen die veröffentlichte App, die aus der Vorlage erstellt wurde. Ob ein Mitglied die App sehen oder verwenden kann, hängt von den Workspace-Einstellungen und der Autorisierung beim Anbieter ab. Ist die App in einem Plug-In enthalten, können Mitglieder über dieses Plug-In auf sie stoßen. Die Anforderungen an den Workspace-Zugriff und die Autorisierung beim Anbieter gelten jedoch weiterhin.
Wenn ein Plug-In eine aus einer Vorlage erstellte App benötigt, weist das Plug-In möglicherweise darauf hin, dass die Einrichtung noch erforderlich ist. Dieser Hinweis bleibt bestehen, bis eine Person mit Administratorrolle die Workspace-spezifische App erstellt und veröffentlicht, sie für die betreffende Rolle aktiviert und alle erforderlichen Autorisierungen von Mitgliedern oder der Administration beim Anbieter abgeschlossen sind.
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 verfügt beim externen Anbieter über die erforderlichen Berechtigungen.
Veröffentlichte Apps erscheinen in den verfügbaren Workspace-Einstellungen unter Apps oder Plug-Ins. Wenn die App Teil eines Plug-Ins ist, kann sie auf der Detailseite des Plug-Ins auch 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 Hostname des Mandanten, Kontos oder Workspace ist korrekt.
Die Callback-URL wurde exakt in die Anbieterkonfiguration kopiert.
Die OAuth-Client-ID und das Client-Secret sind korrekt.
Die angeforderten Bereiche entsprechen den Berechtigungen der OAuth-App beim Anbieter.
Ein Entwurf wurde erstellt.
Der Entwurf wurde veröffentlicht.
Der Rollenzugriff erlaubt der Testperson, die App zu sehen.
Die Berechtigungen beim Anbieter erlauben den getesteten Datenzugriff oder die getestete Aktion.
Sicherheitsanforderungen prüfen
Behandle OAuth-Client-Secrets und Anbieteranmeldedaten als vertrauliche Informationen.
Prüfe die angeforderten Bereiche, bevor du den Entwurf erstellst.
Begrenze nach der Veröffentlichung unter Aktionen, welche Aktionen die App ausführen darf.
Lege unter App-Berechtigungen fest, wann ChatGPT Mitglieder vor der Verwendung der App um Zustimmung bittet.
Beachte, dass die Berechtigungen beim Anbieter auch nach der Aktivierung der App in ChatGPT weiterhin gelten.