Overzicht
Met app-sjablonen kun je in beheerde werkruimtes een werkruimtespecifieke versie van een ChatGPT-app of -connector instellen. Werkruimtebeheerders en -eigenaren kunnen sjablonen vinden in de beschikbare beheerinterface voor Apps of Plug-ins, organisatiespecifieke instellingen toevoegen en een concept-app maken om te beoordelen. Beheerde app-sjablonen verschijnen niet in persoonlijke werkruimtes.
Sjablonen zijn handig wanneer OpenAI de algemene app-functionaliteit kan bieden, maar elke werkruimte zelf de aanbiederspecifieke instellingen moet aanleveren. Afhankelijk van het sjabloon kunnen die instellingen bestaan uit een tenant- of hostnaam, OAuth-clientgegevens, callback-URL's, scopes, webhookgegevens, URL's van beheerde MCP-servers of andere instellingen van de aanbieder. Een sjabloon voor GitHub Enterprise kan bijvoorbeeld de werkruimtespecifieke connector maken waarmee Codex verbinding maakt met de GitHub Enterprise-host van die organisatie.
Na de configuratie gebruiken leden niet het oorspronkelijke sjabloon. Ze gebruiken de gepubliceerde werkruimte-app die ermee is gemaakt. Beheerders kunnen die app vervolgens beheren zoals andere ChatGPT-apps. In ChatGPT Business schakelen eigenaren en beheerders de app in of uit voor de werkruimte. In ChatGPT Enterprise/Edu kunnen eigenaren en beheerders gebruikmaken van rolgebaseerde app-toegang waar die wordt ondersteund. Beheerders kunnen ook actie-instellingen, app-machtigingen en autorisatie bij de aanbieder beheren.
Plug-ins kunnen app-sjablonen bevatten of apps die op basis van sjablonen zijn gemaakt. Als een plug-in een app-sjabloon bevat, moet een werkruimtebeheerder of -eigenaar de werkruimtespecifieke app maken en publiceren voordat leden deze in ChatGPT kunnen koppelen of via de plug-in kunnen gebruiken. De plug-in gebruikt de app-instantie die in die werkruimte beschikbaar is; leden configureren het oorspronkelijke sjabloon niet.
Gebruik dit artikel voor de algemene werkwijze voor sjablonen. Zie voor aanbiederspecifieke configuratie:
Veelvoorkomende redenen om een sjabloon te gebruiken zijn:
De URL van de aanbieder bevat een bedrijfsspecifieke tenant, account, organisatie of hostnaam van een werkruimte.
De organisatie moet een eigen OAuth-client of eigen inloggegevens voor de aanbieder gebruiken.
De aanbieder vereist dat de callback-URL per klant wordt geconfigureerd.
De app moet overal dezelfde implementatieaanpak gebruiken, terwijl elke werkruimte afzonderlijk de toegang, acties en beveiligingsinstellingen beheert.
Hoe sjablonen verschillen van gewone apps
Een gewone app kan meestal direct worden ingeschakeld. Een sjabloon start daarentegen een configuratieproces voor de werkruimtebeheerder.
De gebruikelijke werkwijze is:
Een beheerder zoekt het sjabloon in de beheerinterface van de werkruimte onder Apps of Plug-ins, afhankelijk van de beschikbare interface.
De beheerder voert de vereiste werkruimtespecifieke instellingen in.
ChatGPT maakt een concept-app voor de werkruimte.
De beheerder beoordeelt en publiceert het concept.
De beheerder configureert de toegangs- en actie-instellingen voor de gepubliceerde app.
Leden gebruiken de gepubliceerde werkruimte-app, niet het oorspronkelijke sjabloon.
Een app-sjabloon zoeken en instellen
De onderstaande procedures beschrijven de beheerinterface voor Apps. Als je werkruimte Beheer > Plug-ins gebruikt, open dan de betreffende plug-in of het sjabloon en volg het bijbehorende configuratieproces. Zie voor navigatie binnen de werkruimte en beheeropties per abonnement: Beheeropties, beveiliging en compliance voor plug-ins en apps.
Ga naar Werkruimte-instellingen > Apps.
Selecteer Catalogus.
Zoek op de naam van de aanbieder of app.
Zoek naar items die als sjabloon zijn gemarkeerd.
Selecteer Inschakelen om het configuratieproces te starten.
Tijdens het configuratieproces wordt gevraagd om de gegevens die nodig zijn om de werkruimtespecifieke app te maken. De exacte velden hangen af van het sjabloon.
Een sjabloon voor GitHub Enterprise kan bijvoorbeeld om de volgende gegevens vragen:
Naam en beschrijving van de app.
Hostnaam van GitHub Enterprise.
Configuratie van de callback-URL.
OAuth-client-ID en clientgeheim.
Privésleutel van de GitHub-app.
Aangevraagde scopes.
Configuratiegegevens voor webhooks.
Controleer elk veld zorgvuldig voordat je het concept maakt. Als je organisatie OAuth-gegevens of inloggegevens voor de aanbieder centraal beheert, stem dit dan af met het team dat daarvoor verantwoordelijk is.
Zie voor aanbiederspecifieke configuratie: GitHub Enterprise, Snowflake en Databricks.
OAuth-client instellen
Bij sommige sjablonen moet je organisatie een eigen OAuth-client gebruiken. Als dit vereist is, maak of configureer je de OAuth-app in de beheerconsole van de externe aanbieder. Kopieer vervolgens de callback-URL uit ChatGPT naar de instellingen voor de omleidings- of callback-URL bij de aanbieder.
Voer de OAuth-client-ID en het clientgeheim pas in ChatGPT in nadat je hebt gecontroleerd of de configuratie bij de aanbieder overeenkomt met de configuratie-instructies van het sjabloon.
Als het sjabloon standaardscopes bevat, behoud deze dan, tenzij je organisatie de machtigingen bij de aanbieder heeft beoordeeld en een duidelijke reden heeft om ze te wijzigen.
Een concept maken
Selecteer Concept maken nadat je de vereiste gegevens hebt ingevoerd.
Als je een concept maakt, wordt de app niet automatisch beschikbaar voor leden. Beoordeel en publiceer het concept en configureer de toegangs- en actie-instellingen voordat je leden vraagt de app te gebruiken.
De gemaakte app publiceren en beheren
Na publicatie beheer je de werkruimtespecifieke app via de beschikbare werkruimte-instellingen onder Apps of Plug-ins.
Aanbevolen controles na publicatie:
Controleer of de app onder Ingeschakelde apps verschijnt.
Schakel in ChatGPT Business de app in of uit voor de werkruimte. Stel in ChatGPT Enterprise/Edu Roltoegang in voor de rollen die de app moeten kunnen gebruiken, waar rolgebaseerde app-toegang wordt ondersteund.
Controleer onder Acties de lees- en schrijfacties.
Controleer de App-machtigingen om te kiezen wanneer ChatGPT leden om toestemming vraagt voordat de app wordt gebruikt.
Vraag een bevoegde testgebruiker om naar Apps of Plug-ins te gaan, afhankelijk van wat beschikbaar is, en te controleren of de gepubliceerde app verschijnt.
Als de app authenticatie bij de aanbieder vereist, laat de testgebruiker dan het eigen account bij die aanbieder koppelen.
Voer een testprompt met een laag risico uit om te controleren of de app naar verwachting werkt.
Deze machtigingen gelden voor ChatGPT-gesprekken. Werkruimte-agents gebruiken afzonderlijke instellingen die door de maker van de agent worden bepaald. Zie voor meer informatie: ChatGPT-werkruimte-agents voor Enterprise en Business.
Als een sjabloon maar één keer kan worden gebruikt
Met sommige sjablonen kun je mogelijk maar één app per werkruimte maken. Als een sjabloon 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 app te maken op basis van hetzelfde sjabloon.
Wat leden zien
Leden zien de gepubliceerde app die op basis van het sjabloon is gemaakt. Of een lid de app kan zien of gebruiken, hangt af van de werkruimte-instellingen en de autorisatie bij de aanbieder. Als de app onderdeel is van een plug-in, kunnen leden de app via die plug-in tegenkomen. Dezelfde vereisten voor toegang tot de werkruimte en autorisatie bij de aanbieder blijven van toepassing.
Als een plug-in een app vereist die op basis van een sjabloon is gemaakt, kan de plug-in aangeven dat configuratie nodig is. Die melding blijft staan totdat een beheerder de werkruimtespecifieke app heeft gemaakt en gepubliceerd, deze heeft ingeschakeld voor de werkruimte in ChatGPT Business of voor de relevante rol in ChatGPT Enterprise/Edu waar rolgebaseerde app-toegang wordt ondersteund, en alle vereiste autorisaties bij de aanbieder door gebruikers of beheerders zijn voltooid.
Controleer het volgende:
De app is gepubliceerd.
De app is ingeschakeld voor de werkruimte.
In ChatGPT Enterprise/Edu heeft de werkruimterol van het lid toegang, waar rolgebaseerde app-toegang wordt ondersteund.
Het lid bevindt zich in de juiste werkruimte.
Het lid heeft de vereiste machtigingen bij de externe aanbieder.
Gepubliceerde apps verschijnen in de beschikbare werkruimte-instellingen onder Apps of Plug-ins. Als de app onderdeel is van een plug-in, kan deze ook als vereiste of optionele app op de detailpagina van de plug-in verschijnen.
Problemen met app-sjablonen oplossen
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 overgenomen in de configuratie bij de aanbieder.
De OAuth-client-ID en het clientgeheim zijn correct.
De aangevraagde scopes komen overeen met wat de OAuth-app bij de aanbieder toestaat.
Er is een concept gemaakt.
Het concept is gepubliceerd.
In ChatGPT Business is de app ingeschakeld voor de werkruimte. In ChatGPT Enterprise/Edu zorgt roltoegang ervoor dat de testgebruiker de app kan zien, waar rolgebaseerde app-toegang wordt ondersteund.
De machtigingen bij de aanbieder staan toegang tot de geteste gegevens of uitvoering van de geteste actie toe.
Beveiligingsvereisten controleren
Behandel OAuth-clientgeheimen en inloggegevens voor de aanbieder als gevoelige informatie.
Controleer de aangevraagde scopes voordat je het concept maakt.
Gebruik na publicatie Acties 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 de machtigingen bij de aanbieder van kracht blijven nadat de app in ChatGPT is ingeschakeld.