Overzicht
App-sjablonen bieden beheerde werkruimten een configuratiemethode voor een werkruimtespecifieke versie van een ChatGPT-app of connector. Werkruimtebeheerders en -eigenaren kunnen sjablonen vinden via de beschikbare beheeromgeving voor Apps of Plug-ins, organisatiespecifieke configuratie toevoegen en een concept-app ter beoordeling maken. Sjablonen voor beheerde apps worden niet weergegeven in persoonlijke werkruimten.
Sjablonen zijn nuttig wanneer OpenAI de algemene werking van de app kan leveren, maar elke werkruimte een providerspecifieke configuratie moet opgeven. Afhankelijk van de sjabloon kan die configuratie bestaan uit een tenant- of hostnaam, OAuth-clientreferenties, callback-URL's, bereiken, webhookgegevens, URL's van beheerde MCP-servers of andere providerinstellingen. Een sjabloon voor GitHub Enterprise kan bijvoorbeeld de werkruimtespecifieke connector maken waarmee Codex toegang krijgt tot de GitHub Enterprise-host van die organisatie.
Na de configuratie gebruiken leden de oorspronkelijke sjabloon niet. Ze gebruiken de gepubliceerde werkruimte-app die op basis daarvan is gemaakt. Beheerders kunnen die app vervolgens beheren zoals andere ChatGPT-apps, waaronder roltoegang, instellingen voor acties, app-machtigingen en autorisatie bij de provider.
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 de oorspronkelijke sjabloon niet.
Gebruik dit artikel voor de algemene procedure voor sjablonen. Zie voor providerspecifieke configuratie:
Veelvoorkomende redenen om een sjabloon te gebruiken zijn:
De provider-URL bevat een tenant-, account-, organisatie- of werkruimtehostnaam van het bedrijf.
De organisatie moet een eigen OAuth-client of providerreferenties gebruiken.
De provider vereist een klantspecifieke configuratie van de callback-URL.
De app moet hetzelfde implementatiepatroon gebruiken, terwijl elke werkruimte de toegang, acties en beveiligingsinstellingen afzonderlijk beheert.
Hoe sjablonen verschillen van gewone apps
Een gewone app kan doorgaans rechtstreeks worden ingeschakeld. Een sjabloon start in plaats daarvan een configuratieprocedure voor werkruimtebeheerders.
De gebruikelijke procedure is als volgt:
Een beheerder zoekt de sjabloon in de beheeromgeving voor Apps of Plug-ins van de werkruimte, afhankelijk van de beschikbare interface.
De beheerder voert de vereiste werkruimtespecifieke configuratie in.
ChatGPT maakt een concept-app voor de werkruimte.
De beheerder controleert en publiceert het concept.
De beheerder configureert de toegangs- en actie-instellingen voor de gepubliceerde app.
Leden gebruiken de gepubliceerde werkruimte-app, niet de oorspronkelijke sjabloon.
Een app-sjabloon zoeken en configureren
De onderstaande procedures beschrijven de beheerinterface voor Apps. Als uw werkruimte Beheer > Plug-ins gebruikt, opent u de betreffende plug-in of sjabloon en volgt u de bijbehorende configuratieprocedure. Zie voor navigatie in de werkruimte: Beheerdersinstellingen, beveiliging en compliance voor plug-ins en apps.
Ga naar Werkruimte-instellingen > Apps.
Selecteer Directory.
Zoek op de naam van de provider of app.
Zoek naar vermeldingen die als sjabloon zijn gemarkeerd.
Selecteer Inschakelen om de configuratieprocedure te starten.
Tijdens de configuratieprocedure wordt gevraagd om de gegevens die nodig zijn om de werkruimtespecifieke app te maken. De precieze velden zijn afhankelijk van de sjabloon.
Een sjabloon voor GitHub Enterprise kan bijvoorbeeld vragen om gegevens zoals:
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 bereiken.
Configuratiegegevens voor de webhook.
Controleer elk veld zorgvuldig voordat u het concept maakt. Als uw organisatie OAuth- of providerreferenties centraal beheert, stemt u dit af met het team dat verantwoordelijk is voor die referenties.
Zie voor providerspecifieke configuratie: GitHub Enterprise, Snowflake en Databricks.
OAuth-client configureren
Voor sommige sjablonen moet uw organisatie een eigen OAuth-client gebruiken. Als dit vereist is, maakt of configureert u de OAuth-app in de beheerconsole van de externe provider. Kopieer vervolgens de callback-URL uit ChatGPT naar de instellingen voor omleidings- of callback-URL's van de provider.
Voer het OAuth-client-ID en clientgeheim pas in ChatGPT in nadat u hebt bevestigd dat de providerconfiguratie overeenkomt met de configuratie-instructies van de sjabloon.
Als de sjabloon standaardbereiken bevat, behoudt u deze tenzij uw organisatie de providermachtigingen heeft beoordeeld en een duidelijke reden heeft om ze te wijzigen.
Een concept maken
Selecteer Concept maken nadat u de vereiste gegevens hebt ingevoerd.
Door een concept te maken, wordt de app niet automatisch beschikbaar voor leden. Controleer en publiceer het concept en configureer de toegangs- en actie-instellingen voordat u leden vraagt de app te gebruiken.
De resulterende app publiceren en beheren
Beheer de werkruimtespecifieke app na publicatie via de beschikbare werkruimte-instellingen voor Apps of Plug-ins.
Aanbevolen controles na publicatie:
Controleer of de app bij Ingeschakelde apps staat.
Stel Roltoegang in voor de rollen die de app moeten gebruiken.
Controleer onder Acties de lees- en schrijfacties.
Controleer App-machtigingen om te bepalen 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 wordt weergegeven.
Als voor de app authenticatie bij de provider vereist is, laat u de testgebruiker het eigen provideraccount koppelen.
Voer een prompt met een laag risico uit om te controleren of de app naar verwachting werkt.
Deze machtigingen gelden voor gesprekken in ChatGPT. Werkruimte-agents gebruiken afzonderlijke instellingen die door de maker van de agent zijn gedefinieerd. Zie voor meer informatie: ChatGPT-werkruimte-agents voor Enterprise en Business.
Als een sjabloon slechts eenmaal kan worden gebruikt
Met sommige sjablonen kan per werkruimte slechts één app worden gemaakt. 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 nog een app op basis van dezelfde sjabloon te maken.
Wat leden zien
Leden zien de gepubliceerde app die op basis van de sjabloon is gemaakt. Of een lid de app kan zien of gebruiken, hangt af van de werkruimte-instellingen en autorisatie bij de provider. Als de app deel uitmaakt van een plug-in, kunnen leden de app via die plug-in tegenkomen. Dezelfde vereisten voor toegang tot de werkruimte en autorisatie bij de provider blijven echter gelden.
Als een plug-in een app vereist die op basis van een sjabloon is gemaakt, kan de plug-in aangeven dat configuratie nodig is totdat een beheerder de werkruimtespecifieke app heeft gemaakt en gepubliceerd, deze voor de relevante rol heeft ingeschakeld en alle vereiste autorisaties van gebruikers of beheerders bij de provider zijn voltooid.
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 beschikbare werkruimte-instellingen voor Apps of Plug-ins. Als de app deel uitmaakt van een plug-in, kan deze op de detailpagina van de plug-in ook als vereiste of optionele app worden weergegeven.
Problemen met app-sjablonen oplossen
Als de configuratie mislukt of de app niet wordt weergegeven, controleert u het volgende:
De hostnaam van de tenant, het account of de werkruimte is correct.
De callback-URL is exact naar de providerconfiguratie gekopieerd.
Het OAuth-client-ID en clientgeheim zijn correct.
De aangevraagde bereiken komen overeen met wat de OAuth-app van de provider toestaat.
Er is een concept gemaakt.
Het concept is gepubliceerd.
De roltoegang staat toe dat de testgebruiker de app ziet.
De machtigingen bij de provider staan de geteste gegevens of actie toe.
Beveiligingsvereisten controleren
Behandel OAuth-clientgeheimen en providerreferenties als gevoelige informatie.
Controleer de aangevraagde bereiken voordat u 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 providermachtigingen blijven gelden nadat de app in ChatGPT is ingeschakeld.