Översikt
Appmallar är ett konfigurationssätt för arbetsytor i Business och Enterprise som behöver en arbetsytespecifik version av en ChatGPT-app eller -anslutning. I stället för att aktivera en delad app från katalogen utgår en administratör eller ägare av arbetsytan från en mall från OpenAI, lägger till uppgifterna som är unika för organisationen och skapar ett apputkast för granskning.
Mallar är användbara när OpenAI kan tillhandahålla det gemensamma appbeteendet, men varje arbetsyta måste tillhandahålla leverantörsspecifik konfiguration. Beroende på mallen kan konfigurationen omfatta en klientorganisation eller ett värdnamn, OAuth-klientuppgifter, callback-URL:er, omfång, webhook-information, URL:er till hanterade MCP-servrar eller andra leverantörsinställningar. En GitHub Enterprise-mall kan till exempel skapa den arbetsytespecifika anslutning som Codex använder för att nå organisationens GitHub Enterprise-värd.
Efter konfigurationen använder medlemmar inte den ursprungliga mallen. De använder den publicerade arbetsyteappen som skapades från den. Administratörer kan sedan hantera den appen som andra ChatGPT-appar, inklusive rollåtkomst, åtgärdskontroller, appbehörigheter och leverantörsauktorisering.
Codex-plugin kan också innehålla appmallar eller appar som skapats från mallar. Om ett plugin innehåller en appmall måste en administratör eller ägare av arbetsytan fortfarande skapa och publicera den arbetsytespecifika appen innan medlemmar kan ansluta den i ChatGPT och använda den via pluginet. När pluginet körs använder det appinstansen som är tillgänglig i den arbetsytan i stället för att be medlemmar att själva konfigurera den ursprungliga mallen. Om den nödvändiga mallen inte har konfigurerats ännu kan medlemmar behöva en administratör som slutför konfigurationen först. Pluginet kan inte använda en appmall på egen hand.
Använd den här artikeln för det allmänna mallflödet. För leverantörsspecifik konfiguration, se:
Mallar är användbara när samma appmönster kan fungera i många organisationer, men varje organisation behöver sin egen konfiguration.
Vanliga exempel är:
Leverantörs-URL:en innehåller en klientorganisation, ett konto, en organisation eller ett värdnamn för arbetsytan.
Organisationen behöver tillhandahålla en egen OAuth-klient eller egna leverantörsuppgifter.
Leverantören kräver kundspecifik konfiguration av callback-URL.
Appen bör använda samma implementeringsmönster, medan varje arbetsyta styr åtkomst, åtgärder och säkerhetsinställningar separat.
Hur mallar skiljer sig från vanliga appar
En vanlig app kan oftast aktiveras direkt från appkatalogen. En mall startar i stället ett konfigurationsflöde.
Det vanliga flödet är:
En administratör hittar en mall i appkatalogen.
Administratören anger den arbetsytespecifika konfiguration som krävs.
ChatGPT skapar ett apputkast för arbetsytan.
Administratören granskar och publicerar utkastet.
Administratören konfigurerar åtkomst- och åtgärdsinställningar för den publicerade appen.
Medlemmar använder den publicerade arbetsyteappen, inte den ursprungliga mallen.
Hitta och konfigurera en appmall
Öppna Arbetsytans inställningar > Appar.
Välj Katalog.
Sök efter leverantören eller appnamnet.
Leta efter poster som är markerade som mallar.
Välj Aktivera för att starta konfigurationsflödet.
Konfigurationsflödet ber om de uppgifter som behövs för att skapa den arbetsytespecifika appen. De exakta fälten beror på mallen.
En GitHub Enterprise-mall kan till exempel be om uppgifter som:
Appnamn och beskrivning.
GitHub Enterprise-värdnamn.
Konfiguration av callback-URL.
OAuth-klient-ID och klienthemlighet.
Privat nyckel för GitHub App.
Begärda omfång.
Information om webhook-konfiguration.
Granska varje fält noggrant innan du skapar utkastet. Om din organisation hanterar OAuth- eller leverantörsuppgifter centralt ska du samordna med teamet som äger uppgifterna.
Se appspecifika instruktioner: GitHub, Snowflake och Databricks.
Konfiguration av OAuth-klient
Vissa mallar kräver att din organisation tillhandahåller en egen OAuth-klient. När detta krävs skapar eller konfigurerar du OAuth-appen i den externa leverantörens administratörskonsol och kopierar sedan callback-URL:en från ChatGPT till leverantörens inställningar för omdirigerings- eller callback-URL.
Ange OAuth-klient-ID:t och hemligheten i ChatGPT först efter att du har bekräftat att leverantörskonfigurationen matchar instruktionerna för mallkonfiguration.
Om mallen innehåller standardomfång ska du behålla standardvärdena om inte din organisation har granskat leverantörsbehörigheterna och har en tydlig anledning att ändra dem.
Skapa ett utkast
När du har angett den information som krävs väljer du Skapa utkast.
Att skapa ett utkast gör inte appen automatiskt tillgänglig för medlemmar. Granska utkastet, publicera det och konfigurera åtkomst- och åtgärdsinställningar innan du ber medlemmar att använda det.
Publicera och hantera den resulterande appen
Efter publicering hanterar du den arbetsytespecifika appen från Arbetsytans inställningar > Appar > Aktiverade.
Rekommenderade kontroller efter publicering:
Bekräfta att appen visas i Aktiverade appar.
Ange Användaråtkomst för de roller som ska använda appen.
Granska Åtgärdskontroll för läs- och skrivåtgärder.
Granska Appbehörigheter för att välja när ChatGPT frågar medlemmar innan appen används.
Be en tillåten testanvändare att öppna Appar i ChatGPT och bekräfta att appen visas.
Om appen kräver leverantörsautentisering ska testanvändaren ansluta sitt leverantörskonto.
Kör en testprompt med låg risk för att bekräfta att appen fungerar som förväntat.
Dessa appbehörigheter gäller för ChatGPT-konversationer. Arbetsyteagenter använder kontroller per Agent som anges av Agentens skapare för att avgöra vilka appåtgärder som är tillgängliga och när slutanvändare ombeds att godkänna dem. För Agentbeteende, se: ChatGPT-arbetsyteagenter för Enterprise och Business.
Om en mall bara kan användas en gång
Vissa mallar kan bara skapa en app per arbetsyta. Om en mall redan har använts kan knappen Aktivera vara otillgänglig. I så fall hanterar du det befintliga utkastet eller den publicerade appen i stället för att skapa en ny från samma mall.
Vad medlemmar ser
Medlemmar ser den publicerade appen som skapats från mallen. Om en medlem kan se eller använda den beror på arbetsytans inställningar och leverantörens auktorisering. Om appen ingår i ett plugin kan medlemmar stöta på den via det pluginet, men samma krav på åtkomst till arbetsytan och leverantörens auktorisering gäller fortfarande.
Kontrollera att:
Appen är publicerad.
Appen är aktiverad för arbetsytan.
Medlemmens roll i arbetsytan har åtkomst.
Medlemmen är i rätt arbetsyta.
Medlemmen har de behörigheter som krävs hos den externa leverantören.
Publicerade appar visas i ChatGPT:s appkatalog, i avsnittet för arbetsytan.
Felsökning
Om konfigurationen misslyckas eller appen inte visas ska du kontrollera följande:
Klientorganisationens, kontots eller arbetsytans värdnamn är korrekt.
Callback-URL:en kopierades exakt till leverantörskonfigurationen.
OAuth-klient-ID:t och klienthemligheten är korrekta.
Begärda omfång matchar vad leverantörens OAuth-app tillåter.
Ett utkast skapades.
Utkastet publicerades.
Rollåtkomsten tillåter testanvändaren att se appen.
Behörigheter hos leverantören tillåter de data eller den åtgärd som testas.
Säkerhetsanteckningar
Behandla OAuth-klienthemligheter och leverantörsuppgifter som känslig information.
Granska begärda omfång innan du skapar utkastet.
Använd Åtgärdskontroll efter publicering för att begränsa vad appen kan göra.
Använd Appbehörigheter för att bestämma när ChatGPT frågar medlemmar innan appen används.
Observera att leverantörens behörigheter fortfarande gäller efter att appen har aktiverats i ChatGPT.