Oversigt
Appskabeloner er en opsætningsvej for Business- og Enterprise-arbejdsområder, der har brug for en arbejdsområdespecifik version af en ChatGPT-app eller connector. I stedet for at aktivere én delt app fra kataloget starter en administrator eller ejer af arbejdsområdet fra en skabelon leveret af OpenAI, tilføjer de oplysninger, der er unikke for organisationen, og opretter en appkladde til gennemgang.
Skabeloner er nyttige, når OpenAI kan levere den fælles appadfærd, men hvert arbejdsområde skal levere udbyderspecifik konfiguration. Afhængigt af skabelonen kan den konfiguration omfatte en tenant eller et værtsnavn, OAuth-klientlegitimationsoplysninger, callback-URL'er, scopes, webhookoplysninger, administrerede MCP-server-URL'er eller andre udbyderindstillinger. For eksempel kan en GitHub Enterprise-skabelon oprette den arbejdsområdespecifikke connector, som Codex bruger til at nå organisationens GitHub Enterprise-vært.
Efter opsætningen bruger medlemmer ikke den oprindelige skabelon. De bruger den udgivne arbejdsområdeapp, der er oprettet ud fra den. Administratorer kan derefter administrere den app ligesom andre ChatGPT-apps, herunder rolleadgang, handlingskontroller, apptilladelser og godkendelse hos udbyderen.
Codex-plugins kan også omfatte appskabeloner eller apps oprettet ud fra skabeloner. Hvis et plugin omfatter en appskabelon, skal en administrator eller ejer af arbejdsområdet stadig oprette og udgive den arbejdsområdespecifikke app, før medlemmer kan forbinde den i ChatGPT og bruge den via det plugin. Når pluginnet kører, bruger det den appforekomst, der er tilgængelig i det pågældende arbejdsområde, i stedet for at bede medlemmer om selv at konfigurere den oprindelige skabelon. Hvis den nødvendige skabelon endnu ikke er sat op, kan medlemmer have brug for, at en administrator fuldfører opsætningen først. Pluginnet kan ikke bruge en appskabelon alene.
Brug denne artikel til det generelle skabelonflow. For udbyderspecifik opsætning, se:
Skabeloner er nyttige, når det samme appmønster kan fungere på tværs af mange organisationer, men hver organisation har brug for sin egen konfiguration.
Almindelige eksempler omfatter:
Udbyder-URL'en omfatter en virksomheds tenant, konto, organisation eller arbejdsområdets værtsnavn.
Organisationen skal medbringe sin egen OAuth-klient eller egne udbyderlegitimationsoplysninger.
Udbyderen kræver kundespecifik opsætning af callback-URL.
Appen skal bruge det samme implementeringsmønster, mens hvert arbejdsområde styrer adgang, handlinger og sikkerhedsindstillinger separat.
Hvordan skabeloner adskiller sig fra almindelige apps
En almindelig app kan normalt aktiveres direkte fra appkataloget. En skabelon starter i stedet et opsætningsflow.
Det sædvanlige flow er:
En administrator finder en skabelon i appkataloget.
Administratoren indtaster den nødvendige arbejdsområdespecifikke konfiguration.
ChatGPT opretter en appkladde til arbejdsområdet.
Administratoren gennemgår og udgiver kladden.
Administratoren konfigurerer adgangs- og handlingsindstillinger for den udgivne app.
Medlemmer bruger den udgivne arbejdsområdeapp, ikke den oprindelige skabelon.
Find og opsæt en appskabelon
Åbn Indstillinger for arbejdsområde > Apps.
Vælg Katalog.
Søg efter udbyderen eller appnavnet.
Se efter poster, der er markeret som skabeloner.
Vælg Aktivér for at starte opsætningsflowet.
Opsætningsflowet beder om de oplysninger, der er nødvendige for at oprette den arbejdsområdespecifikke app. De præcise felter afhænger af skabelonen.
For eksempel kan en GitHub Enterprise-skabelon bede om oplysninger såsom:
Appnavn og beskrivelse.
GitHub Enterprise-værtsnavn.
Callback-URL-konfiguration.
OAuth-klient-id og klienthemmelighed.
Privat nøgle til GitHub App.
Anmodede scopes.
Oplysninger om webhookopsætning.
Gennemgå hvert felt omhyggeligt, før du opretter kladden. Hvis din organisation administrerer OAuth- eller udbyderlegitimationsoplysninger centralt, skal du koordinere med det team, der ejer disse legitimationsoplysninger.
Se appspecifikke instruktioner: GitHub, Snowflake og Databricks.
Opsætning af OAuth-klient
Nogle skabeloner kræver, at din organisation medbringer sin egen OAuth-klient. Når dette er påkrævet, skal du oprette eller konfigurere OAuth-appen i den eksterne udbyders administratorkonsol og derefter kopiere callback-URL'en fra ChatGPT til udbyderens indstillinger for omdirigerings- eller callback-URL.
Indtast først OAuth-klient-id'et og hemmeligheden i ChatGPT, når du har bekræftet, at udbyderkonfigurationen matcher skabelonens opsætningsinstruktioner.
Hvis skabelonen indeholder standardscopes, skal du beholde standardindstillingerne, medmindre din organisation har gennemgået udbydertilladelserne og har en klar grund til at ændre dem.
Opret en kladde
Når du har indtastet de nødvendige oplysninger, skal du vælge Opret kladde.
Oprettelse af en kladde gør ikke automatisk appen tilgængelig for medlemmer. Gennemgå kladden, udgiv den, og konfigurer adgangs- og handlingsindstillinger, før du beder medlemmer om at bruge den.
Udgiv og administrer den resulterende app
Efter udgivelse skal du administrere den arbejdsområdespecifikke app fra Indstillinger for arbejdsområde > Apps > Aktiveret.
Anbefalede kontroller efter udgivelse:
Bekræft, at appen vises i Aktiverede apps.
Indstil Brugeradgang for de roller, der skal bruge appen.
Gennemgå Handlingskontrol for læse- og skrivehandlinger.
Gennemgå Apptilladelser for at vælge, hvornår ChatGPT spørger medlemmer, før appen bruges.
Bed en tilladt testbruger om at åbne Apps i ChatGPT og bekræfte, at appen vises.
Hvis appen kræver udbydergodkendelse, skal testbrugeren forbinde sin udbyderkonto.
Kør en lavrisiko-testprompt for at bekræfte, at appen fungerer som forventet.
Disse apptilladelser gælder for ChatGPT-samtaler. Workspace Agents bruger kontroller pr. agent, som er angivet af agentens builder, til at bestemme, hvilke apphandlinger der er tilgængelige, og hvornår slutbrugere bliver bedt om at godkende dem. For agentadfærd, se: ChatGPT Workspace Agents for Enterprise and Business.
Hvis en skabelon kun kan bruges én gang
Nogle skabeloner kan kun oprette én app pr. arbejdsområde. Hvis en skabelon allerede er brugt, er knappen Aktivér muligvis ikke tilgængelig. I så fald skal du administrere den eksisterende kladde eller udgivne app i stedet for at oprette en ny fra den samme skabelon.
Hvad medlemmer ser
Medlemmer ser den udgivne app, der er oprettet ud fra skabelonen. Om et medlem kan se eller bruge den, afhænger af indstillinger for arbejdsområdet og godkendelse hos udbyderen. Hvis appen er inkluderet i et plugin, kan medlemmer møde den gennem det plugin, men de samme krav til adgang til arbejdsområdet og godkendelse hos udbyderen gælder stadig.
Kontrollér, at:
Appen er udgivet.
Appen er aktiveret for arbejdsområdet.
Medlemmets rolle i arbejdsområdet har adgang.
Medlemmet er i det korrekte arbejdsområde.
Medlemmet har de nødvendige tilladelser hos den eksterne udbyder.
Udgivne apps vises i ChatGPT-appkataloget i den arbejdsområdespecifikke sektion.
Fejlfinding
Hvis opsætningen mislykkes, eller appen ikke vises, skal du bekræfte følgende:
Tenant-, konto- eller arbejdsområdets værtsnavn er korrekt.
Callback-URL'en blev kopieret nøjagtigt ind i udbyderkonfigurationen.
OAuth-klient-id'et og klienthemmeligheden er korrekte.
De anmodede scopes matcher det, som udbyderens OAuth-app tillader.
Der blev oprettet en kladde.
Kladden blev udgivet.
Rolleadgang giver testbrugeren mulighed for at se appen.
Tilladelser på udbydersiden tillader de data eller den handling, der testes.
Sikkerhedsnoter
Behandl OAuth-klienthemmeligheder og udbyderlegitimationsoplysninger som følsomme oplysninger.
Gennemgå de anmodede scopes, før du opretter kladden.
Brug Handlingskontrol efter udgivelse til at begrænse, hvad appen kan gøre.
Brug Apptilladelser til at bestemme, hvornår ChatGPT spørger medlemmer, før appen bruges.
Bemærk, at udbydertilladelser stadig gælder, efter appen er aktiveret i ChatGPT.