Oversigt
Appskabeloner er en opsætningsmetode til administrerede arbejdsområder, der har brug for en arbejdsområdespecifik version af en ChatGPT-app eller -connector. Administratorer og ejere af arbejdsområder kan finde skabeloner i administratorvisningen under de tilgængelige Apps eller Plugins, tilføje organisationsspecifik konfiguration og oprette en appkladde til gennemgang. Administrerede appskabeloner vises ikke i personlige arbejdsområder.
Skabeloner er nyttige, når OpenAI kan levere appens generelle funktionalitet, men hvert arbejdsområde selv skal angive den udbyderspecifikke konfiguration. Afhængigt af skabelonen kan konfigurationen omfatte en lejer eller et værtsnavn, OAuth-klientlegitimationsoplysninger, callbackwebadresser, scopes, webhookoplysninger, webadresser til administrerede MCP-servere eller andre udbyderindstillinger. En GitHub Enterprise-skabelon kan f.eks. oprette den arbejdsområdespecifikke connector, som Codex bruger til at få adgang til organisationens GitHub Enterprise-vært.
Efter opsætningen bruger medlemmerne ikke den oprindelige skabelon. De bruger den publicerede app til arbejdsområdet, som er oprettet ud fra skabelonen. Administratorer kan derefter administrere appen som andre ChatGPT-apps, herunder rollebaseret adgang, handlingsstyring, apptilladelser og godkendelse hos udbyderen.
Plugins kan indeholde appskabeloner eller apps, der er oprettet ud fra skabeloner. Hvis en plugin indeholder en appskabelon, skal en administrator eller ejer af arbejdsområdet oprette og publicere den arbejdsområdespecifikke app, før medlemmerne kan forbinde den i ChatGPT eller bruge den via denne plugin. Denne plugin bruger den appinstans, der er tilgængelig i arbejdsområdet. Medlemmerne konfigurerer ikke den oprindelige skabelon.
Brug denne artikel til at få oplysninger om det generelle skabelonforløb. Se følgende for udbyderspecifik opsætning:
Typiske grunde til at bruge en skabelon omfatter:
Udbyderens webadresse indeholder værtsnavnet på en virksomhedslejer, konto, organisation eller et arbejdsområde.
Organisationen skal bruge sin egen OAuth-klient eller egne legitimationsoplysninger til udbyderen.
Udbyderen kræver kundespecifik opsætning af callbackwebadressen.
Appen skal anvende det samme implementeringsmønster, mens hvert arbejdsområde administrerer adgang, handlinger og sikkerhedsindstillinger separat.
Sådan adskiller skabeloner sig fra almindelige apps
En almindelig app kan normalt aktiveres direkte. En skabelon starter i stedet et opsætningsforløb for arbejdsområdets administrator.
Det normale forløb er:
En administrator finder skabelonen i arbejdsområdets administratorvisning under Apps eller Plugins, afhængigt af den tilgængelige grænseflade.
Administratoren angiver den påkrævede konfiguration for arbejdsområdet.
ChatGPT opretter en appkladde til arbejdsområdet.
Administratoren gennemgår og publicerer kladden.
Administratoren konfigurerer adgang og handlingsindstillinger for den publicerede app.
Medlemmerne bruger den publicerede app til arbejdsområdet, ikke den oprindelige skabelon.
Find og konfigurer en appskabelon
Fremgangsmåderne nedenfor beskriver administratorgrænsefladen under Apps. Hvis dit arbejdsområde bruger Administrator > Plugins, skal du i stedet åbne den relevante plugin eller skabelon og følge opsætningsforløbet. Du kan få oplysninger om navigation i arbejdsområdet under Administrationsindstillinger, sikkerhed og overholdelse for plugins og apps.
Gå til Indstillinger for arbejdsområde > Apps.
Vælg Oversigt.
Søg efter udbyderen eller appens navn.
Se efter poster, der er markeret som skabeloner.
Vælg Aktivér for at starte opsætningsforløbet.
Opsætningsforløbet beder om de oplysninger, der er nødvendige for at oprette den arbejdsområdespecifikke app. De præcise felter afhænger af skabelonen.
En GitHub Enterprise-skabelon kan f.eks. bede om oplysninger som:
Appnavn og beskrivelse.
Værtsnavn til GitHub Enterprise.
Konfiguration af callbackwebadresse.
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 er ansvarligt for dem.
Se følgende for udbyderspecifik opsætning: GitHub Enterprise, Snowflake og Databricks.
Opsætning af OAuth-klient
Nogle skabeloner kræver, at din organisation bruger sin egen OAuth-klient. Når dette er påkrævet, skal du oprette eller konfigurere OAuth-appen i den eksterne udbyders administrationskonsol og derefter kopiere callbackwebadressen fra ChatGPT til udbyderens indstillinger for omdirigerings- eller callbackwebadresser.
Angiv først OAuth-klient-id'et og klienthemmeligheden i ChatGPT, når du har bekræftet, at udbyderens konfiguration stemmer overens med skabelonens opsætningsvejledning.
Hvis skabelonen indeholder standardscopes, skal du beholde dem, medmindre din organisation har gennemgået udbydertilladelserne og har en klar grund til at ændre dem.
Opret en kladde
Når du har angivet de nødvendige oplysninger, skal du vælge Opret kladde.
Når du opretter en kladde, bliver appen ikke automatisk tilgængelig for medlemmerne. Gennemgå og publicer kladden, og konfigurer adgang og handlingsindstillinger, før du beder medlemmerne om at bruge appen.
Publicer og administrer den oprettede app
Efter publicering kan du administrere den arbejdsområdespecifikke app via de tilgængelige indstillinger for Apps eller Plugins i arbejdsområdet.
Anbefalede kontroller efter publicering:
Bekræft, at appen vises under Aktiverede apps.
Indstil Rolleadgang for de roller, der skal bruge appen.
Gennemgå læse- og skrivehandlinger under Handlinger.
Gennemgå Apptilladelser for at vælge, hvornår ChatGPT skal spørge medlemmerne, før appen bruges.
Bed en godkendt testbruger om at gå til Apps eller Plugins, afhængigt af hvad der er tilgængeligt, og bekræfte, at den publicerede app vises.
Hvis appen kræver godkendelse hos udbyderen, skal testbrugeren forbinde sin udbyderkonto.
Kør en testprompt med lav risiko for at bekræfte, at appen fungerer som forventet.
Disse tilladelser gælder for samtaler i ChatGPT. Agenter i arbejdsområdet bruger separate indstillinger, der er defineret af agentens udvikler. Se ChatGPT-agenter i arbejdsområder til Enterprise og Business for at få flere oplysninger.
Hvis en skabelon kun kan bruges én gang
Nogle skabeloner kan muligvis kun oprette én app pr. arbejdsområde. Hvis en skabelon allerede er blevet brugt, er knappen Aktivér muligvis ikke tilgængelig. I så fald skal du administrere den eksisterende kladde eller publicerede app i stedet for at oprette en ny ud fra den samme skabelon.
Det kan medlemmerne se
Medlemmerne kan se den publicerede app, der er oprettet ud fra skabelonen. Om et medlem kan se eller bruge den, afhænger af indstillingerne for arbejdsområdet og godkendelsen hos udbyderen. Hvis appen er inkluderet i en plugin, kan medlemmerne støde på den via denne plugin, men de samme krav til adgang til arbejdsområdet og godkendelse hos udbyderen gælder stadig.
Hvis en plugin kræver en app, der er oprettet ud fra en skabelon, kan den vise, at opsætning er påkrævet, indtil en administrator har oprettet og publiceret den arbejdsområdespecifikke app, aktiveret den for den relevante rolle, og alle påkrævede bruger- eller administratorgodkendelser hos udbyderen er gennemført.
Kontrollér følgende:
Appen er publiceret.
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.
Publicerede apps vises under de tilgængelige indstillinger for Apps eller Plugins i arbejdsområdet. Hvis appen er en del af en plugin, kan den også blive vist som en påkrævet eller valgfri app på siden med oplysninger om denne plugin.
Fejlfinding af appskabeloner
Hvis opsætningen mislykkes, eller appen ikke vises, skal du kontrollere følgende:
Værtsnavnet på lejeren, kontoen eller arbejdsområdet er korrekt.
Callbackwebadressen er kopieret nøjagtigt til udbyderens konfiguration.
OAuth-klient-id'et og klienthemmeligheden er korrekte.
De anmodede scopes svarer til dem, som udbyderens OAuth-app tillader.
Der er oprettet en kladde.
Kladden er publiceret.
Rolleadgangen giver testbrugeren mulighed for at se appen.
Tilladelserne hos udbyderen giver adgang til de data eller den handling, der testes.
Gennemgå sikkerhedskravene
Behandl OAuth-klienthemmeligheder og udbyderlegitimationsoplysninger som følsomme oplysninger.
Gennemgå de anmodede scopes, før du opretter kladden.
Brug Handlinger efter publicering til at begrænse, hvad appen kan gøre.
Brug Apptilladelser til at bestemme, hvornår ChatGPT skal spørge medlemmerne, før appen bruges.
Bemærk, at udbyderens tilladelser stadig gælder, efter appen er aktiveret i ChatGPT.