Overzicht
App-templates zijn een configuratietraject voor Business- en Enterprise-werkruimten die een werkruimtespecifieke versie van een ChatGPT-app of connector nodig hebben. In plaats van één gedeelde app uit de directory in te schakelen, begint een werkruimtebeheerder of eigenaar met een door OpenAI geleverde template, voegt de gegevens toe die uniek zijn voor de organisatie en maakt een concept-app ter beoordeling.
Templates zijn nuttig wanneer OpenAI het algemene appgedrag kan leveren, maar elke werkruimte providerspecifieke configuratie moet opgeven. Afhankelijk van de template kan die configuratie een tenant- of hostnaam, OAuth-clientreferenties, callback-URL's, scopes, webhookgegevens, beheerde MCP-server-URL's of andere providerinstellingen omvatten. Een GitHub Enterprise-template kan bijvoorbeeld de werkruimtespecifieke connector maken die Codex gebruikt om de GitHub Enterprise-host van die organisatie te bereiken.
Na de configuratie gebruiken leden de oorspronkelijke template niet. Ze gebruiken de gepubliceerde werkruimte-app die hieruit is gemaakt. Beheerders kunnen die app vervolgens beheren zoals andere ChatGPT-apps, inclusief roltoegang, actiebeheer, app-machtigingen en providerautorisatie.
Codex-plugins kunnen ook app-templates of apps bevatten die vanuit templates zijn gemaakt. Als een plugin een app-template bevat, moet een werkruimtebeheerder of eigenaar de werkruimtespecifieke app nog steeds maken en publiceren voordat leden deze in ChatGPT kunnen koppelen en via die plugin kunnen gebruiken. Wanneer de plugin wordt uitgevoerd, gebruikt deze de app-instantie die in die werkruimte beschikbaar is, in plaats van leden te vragen de oorspronkelijke template zelf te configureren. Als de vereiste template nog niet is ingesteld, hebben leden mogelijk een beheerder nodig om eerst de configuratie te voltooien. De plugin kan een app-template niet op zichzelf gebruiken.
Gebruik dit artikel voor het algemene templateproces. Zie voor providerspecifieke configuratie:
Templates zijn nuttig wanneer hetzelfde apppatroon voor veel organisaties kan werken, maar elke organisatie een eigen configuratie nodig heeft.
Veelvoorkomende voorbeelden zijn:
De provider-URL bevat een bedrijfstenant, account, organisatie of hostnaam van een werkruimte.
De organisatie moet haar eigen OAuth-client of providerreferenties meenemen.
De provider vereist klantspecifieke configuratie van callback-URL's.
De app moet hetzelfde implementatiepatroon gebruiken, terwijl elke werkruimte toegang, acties en beveiligingsinstellingen afzonderlijk beheert.
Waarin templates verschillen van reguliere apps
Een reguliere app kan meestal rechtstreeks vanuit de appdirectory worden ingeschakeld. Een template start in plaats daarvan een configuratieproces.
Het gebruikelijke proces is:
Een beheerder vindt een template in de appdirectory.
De beheerder voert de vereiste werkruimtespecifieke configuratie in.
ChatGPT maakt een concept-app voor de werkruimte.
De beheerder beoordeelt en publiceert het concept.
De beheerder configureert toegangs- en actie-instellingen voor de gepubliceerde app.
Leden gebruiken de gepubliceerde werkruimte-app, niet de oorspronkelijke template.
Een app-template zoeken en instellen
Open Werkruimte-instellingen > Apps.
Selecteer Directory.
Zoek op de provider of appnaam.
Zoek naar vermeldingen die als templates zijn gemarkeerd.
Selecteer Inschakelen om het configuratieproces te starten.
In het configuratieproces wordt gevraagd om de gegevens die nodig zijn om de werkruimtespecifieke app te maken. De exacte velden hangen af van de template.
Een GitHub Enterprise-template kan bijvoorbeeld om gegevens vragen zoals:
Appnaam en beschrijving.
GitHub Enterprise-hostnaam.
Configuratie van callback-URL.
OAuth-client-ID en clientgeheim.
Privésleutel van GitHub App.
Aangevraagde scopes.
Gegevens voor webhookconfiguratie.
Controleer elk veld zorgvuldig voordat u het concept maakt. Als uw organisatie OAuth- of providerreferenties centraal beheert, stem dan af met het team dat eigenaar is van die referenties.
Zie app-specifieke instructies: GitHub, Snowflake en Databricks.
OAuth-client instellen
Voor sommige templates moet uw organisatie een eigen OAuth-client meebrengen. Wanneer dit vereist is, maakt of configureert u de OAuth-app in de beheerconsole van de externe provider en kopieert u vervolgens de callback-URL uit ChatGPT naar de instellingen voor omleidings- of callback-URL's van de provider.
Voer de OAuth-client-ID en het geheim pas in ChatGPT in nadat u hebt bevestigd dat de providerconfiguratie overeenkomt met de configuratie-instructies van de template.
Als de template standaardscopes bevat, behoudt u de standaardwaarden tenzij uw organisatie de providermachtigingen heeft beoordeeld en een duidelijke reden heeft om ze te wijzigen.
Een concept maken
Selecteer na het invoeren van de vereiste informatie Concept maken.
Het maken van een concept maakt de app niet automatisch beschikbaar voor leden. Beoordeel het concept, publiceer het en configureer toegangs- en actie-instellingen voordat u leden vraagt de app te gebruiken.
De resulterende app publiceren en beheren
Beheer na publicatie de werkruimtespecifieke app via Werkruimte-instellingen > Apps > Ingeschakeld.
Aanbevolen controles na publicatie:
Controleer of de app wordt weergegeven in Ingeschakelde apps.
Stel Gebruikerstoegang in voor de rollen die de app moeten gebruiken.
Controleer Actiebeheer voor lees- en schrijfacties.
Controleer App-machtigingen om te kiezen wanneer ChatGPT leden om toestemming vraagt voordat de app wordt gebruikt.
Vraag een toegestane testgebruiker Apps in ChatGPT te openen en te bevestigen dat de app verschijnt.
Als de app providerauthenticatie vereist, laat u de testgebruiker het provideraccount koppelen.
Voer een prompt met laag risico uit om te bevestigen dat de app werkt zoals verwacht.
Deze app-machtigingen zijn van toepassing op ChatGPT-gesprekken. Werkruimte-agents gebruiken instellingen per agent die door de bouwer van de agent zijn ingesteld om te bepalen welke appacties beschikbaar zijn en wanneer eindgebruikers wordt gevraagd deze goed te keuren. Zie voor agentgedrag: ChatGPT-werkruimte-agents voor Enterprise en Business.
Als een template slechts één keer kan worden gebruikt
Sommige templates maken mogelijk slechts één app per werkruimte. Als een template al is gebruikt, is de knop Inschakelen mogelijk niet beschikbaar. Beheer in dat geval het bestaande concept of de gepubliceerde app in plaats van een nieuwe vanuit dezelfde template te maken.
Wat leden zien
Leden zien de gepubliceerde app die vanuit de template is gemaakt. Of een lid deze kan zien of gebruiken, hangt af van de werkruimte-instellingen en providerautorisatie. Als de app is opgenomen in een plugin, kunnen leden deze via die plugin tegenkomen, maar dezelfde vereisten voor werkruimtetoegang en providerautorisatie blijven gelden.
Controleer het volgende:
De app is gepubliceerd.
De app is ingeschakeld voor de werkruimte.
De werkruimterol van het lid heeft toegang.
Het lid bevindt zich in de juiste werkruimte.
Het lid heeft de vereiste machtigingen bij de externe provider.
Gepubliceerde apps worden weergegeven in de ChatGPT-appdirectory, in de werkruimtespecifieke sectie.
Probleemoplossing
Als de configuratie mislukt of de app niet verschijnt, controleer dan het volgende:
De tenant, het account of de hostnaam van de werkruimte is correct.
De callback-URL is exact gekopieerd naar de providerconfiguratie.
De OAuth-client-ID en het clientgeheim zijn correct.
De aangevraagde scopes komen overeen met wat de OAuth-app van de provider toestaat.
Er is een concept gemaakt.
Het concept is gepubliceerd.
Roltoegang staat toe dat de testgebruiker de app ziet.
Providerzijdige machtigingen staan de gegevens of actie toe die wordt getest.
Beveiligingsopmerkingen
Behandel OAuth-clientgeheimen en providerreferenties als gevoelige informatie.
Controleer aangevraagde scopes voordat u het concept maakt.
Gebruik Actiebeheer na publicatie om te beperken wat de app kan doen.
Gebruik App-machtigingen om te bepalen wanneer ChatGPT leden om toestemming vraagt voordat de app wordt gebruikt.
Houd er rekening mee dat providermachtigingen blijven gelden nadat de app in ChatGPT is ingeschakeld.