Översikt

Appmallar är ett konfigurationsflöde för hanterade arbetsytor som behöver en arbetsytespecifik version av en ChatGPT-app eller anslutningskomponent. Administratörer och ägare för arbetsytor hittar mallar i Arbetsytans inställningar > Appar > Katalog, lägger till organisationsspecifik konfiguration och skapar ett apputkast för granskning. Hanterade appmallar visas inte i personliga arbetsytor.

Mallar är användbara när OpenAI kan tillhandahålla appens gemensamma beteende, men varje arbetsyta måste ange leverantörsspecifik konfiguration. Beroende på mallen kan den 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 anslutningskomponent 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 arbetsytesappen som skapats från den. Administratörer kan sedan hantera den appen som andra ChatGPT-appar, inklusive rollåtkomst, åtgärdskontroller, appbehörigheter och leverantörsauktorisering.


Plugin-program kan också innehålla appmallar eller appar som skapats från mallar. Om ett plugin-program innehåller en appmall behöver en arbetsyteadministratör eller ägare fortfarande skapa och publicera den arbetsytespecifika appen innan medlemmar kan ansluta den i ChatGPT eller använda den via plugin-programmet. När plugin-programmet körs använder det den appinstans som är tillgänglig i arbetsytan i stället för att be medlemmar konfigurera den ursprungliga mallen själva. Om den obligatoriska mallen inte har konfigurerats ännu kan medlemmar behöva be en administratör slutföra konfigurationen först. Plugin-programmet 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:

• GitHub Enterprise

• Snowflake

• Databricks

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:

• Leverantörens URL innehåller ett företags klientorganisation, konto, organisation eller arbetsytevärdnamn.

• Organisationen behöver använda sin egen OAuth-klient eller sina egna leverantörsuppgifter.

• Leverantören kräver kundspecifik konfiguration av callback-URL.

• Appen ska använda samma implementeringsmönster, samtidigt som varje arbetsyta styr åtkomst, åtgärder och säkerhetsinställningar separat.

Så skiljer sig mallar frånvanliga appar

En vanlig app kan oftast aktiveras direkt. En mall startar i stället ett konfigurationsflöde för arbetsyteadministratörer.

Det vanliga flödet är:

• En administratör hittar en mall i Arbetsytans inställningar > Appar > Katalog.

• 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 arbetsytesappen, inte den ursprungliga mallen.

Hitta och konfigurera en appmall

• Öppna Arbetsytans inställningar > Appar.

• Välj Katalog.

• Sök efter leverantören eller appens namn.

• Leta efter poster som är markerade som mallar.

• Välj Aktivera för att starta konfigurationsflödet.

Konfigurationsflödet frågar efter 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 för webhook-konfiguration.

Granska varje fält noggrant innan du skapar utkastet. Om din organisation hanterar OAuth- eller leverantörsuppgifter centralt, samordna med teamet som ansvarar för dessa uppgifter.

Se appspecifika instruktioner:GitHub,Snowflake ochDatabricks.

Konfiguration av OAuth-klient

Vissa mallar kräver att din organisation använder 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 och hemlighet i ChatGPT först efter att du har bekräftat att leverantörskonfigurationen matchar mallens konfigurationsanvisningar.

Om mallen innehåller standardomfång bör du behålla dem, såvida inte organisationen har granskat leverantörsbehörigheterna och har ett tydligt skäl 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 automatiskt appen tillgänglig för medlemmar. Granska utkastet, publicera det och konfigurera åtkomst- och åtgärdsinställningar innan du ber medlemmar 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 ska fråga medlemmar innan appen används.

• Be en tillåten testanvändare öppna Appar i ChatGPT och bekräfta att appen visas.

• Om appen kräver leverantörsautentisering ber du testanvändaren ansluta sitt leverantörskonto.

• Kör en Prompt 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. Workspace Agents 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 Agent-beteende, se:ChatGPT Workspace Agents 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. Hantera i så fall 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-program kan medlemmar stöta på den via plugin-programmet, men samma krav på åtkomst till arbetsytan och leverantörsauktorisering gäller fortfarande.

Om ett plugin-program kräver en app som skapats från en mall kan plugin-programmet visa att konfiguration behövs tills en administratör skapar och publicerar den arbetsytespecifika appen, aktiverar den för relevant roll och all nödvändig användar- eller administratörsauktorisering hos leverantören är klar.

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 Arbetsytans inställningar > Appar > Aktiverade. Om appen ingår i ett plugin-program kan den också visas som en obligatorisk eller valfri app på plugin-programmets informationssida.

Felsökning

Om konfigurationen misslyckas eller appen inte visas, kontrollera följande:

• Klientorganisationens, kontots eller arbetsytans värdnamn är korrekt.

• Callback-URL:en har kopierats exakt till leverantörskonfigurationen.

• OAuth-klient-ID:t och klienthemligheten är korrekta.

• Begärda omfång matchar det som leverantörens OAuth-app tillåter.

• Ett utkast har skapats.

• Utkastet har publicerats.

• Rollåtkomsten gör att testanvändaren kan se appen.

• Behörigheter på leverantörssidan tillåter den data eller åtgärd som testas.

Säkerhetsanmärkningar

• 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 ska fråga medlemmar innan appen används.

• Observera att leverantörsbehörigheter fortfarande gäller efter att appen har aktiverats i ChatGPT.