Přehled
Šablony aplikací představují postup nastavení pro pracovní prostory Business a Enterprise, které potřebují verzi aplikace nebo konektoru ChatGPT specifickou pro daný pracovní prostor. Místo povolení jedné sdílené aplikace z adresáře začne správce nebo vlastník pracovního prostoru šablonou poskytnutou OpenAI, přidá údaje jedinečné pro svou organizaci a vytvoří koncept aplikace ke kontrole.
Šablony jsou užitečné, když OpenAI může poskytnout běžné chování aplikace, ale každý pracovní prostor musí dodat konfiguraci specifickou pro poskytovatele. V závislosti na šabloně může tato konfigurace zahrnovat název tenanta nebo hostitele, přihlašovací údaje klienta OAuth, adresy URL zpětného volání, rozsahy, podrobnosti webhooku, adresy URL spravovaných serverů MCP nebo jiná nastavení poskytovatele. Například šablona GitHub Enterprise může vytvořit konektor specifický pro pracovní prostor, který Codex používá pro přístup k hostiteli GitHub Enterprise dané organizace.
Po nastavení členové nepoužívají původní šablonu. Používají publikovanou aplikaci pracovního prostoru, která z ní byla vytvořena. Správci pak mohou tuto aplikaci spravovat stejně jako jiné aplikace ChatGPT, včetně přístupu podle rolí, řízení akcí, oprávnění aplikace a autorizace poskytovatele.
Pluginy Codex mohou také zahrnovat šablony aplikací nebo aplikace vytvořené ze šablon. Pokud plugin obsahuje šablonu aplikace, správce nebo vlastník pracovního prostoru musí stále vytvořit a publikovat aplikaci specifickou pro pracovní prostor, než ji členové budou moci připojit v ChatGPT a používat prostřednictvím tohoto pluginu. Když plugin běží, používá instanci aplikace dostupnou v daném pracovním prostoru, místo aby po členech požadoval konfiguraci původní šablony. Pokud požadovaná šablona ještě nebyla nastavena, členové mohou nejprve potřebovat, aby nastavení dokončil správce. Plugin nemůže používat samotnou šablonu aplikace.
Tento článek použijte pro obecný postup práce se šablonami. Nastavení specifické pro poskytovatele najdete zde:
Šablony jsou užitečné, když stejný vzor aplikace může fungovat v mnoha organizacích, ale každá organizace potřebuje vlastní konfiguraci.
Běžné příklady zahrnují:
Adresa URL poskytovatele obsahuje název hostitele tenanta, účtu, organizace nebo pracovního prostoru společnosti.
Organizace musí dodat vlastního klienta OAuth nebo přihlašovací údaje poskytovatele.
Poskytovatel vyžaduje nastavení adresy URL zpětného volání specifické pro zákazníka.
Aplikace by měla používat stejný vzor implementace, zatímco každý pracovní prostor samostatně řídí přístup, akce a nastavení zabezpečení.
Jak se šablony liší od běžných aplikací
Běžnou aplikaci lze obvykle povolit přímo z adresáře aplikací. Šablona místo toho spustí postup nastavení.
Obvyklý postup je:
Správce najde šablonu v adresáři aplikací.
Správce zadá požadovanou konfiguraci specifickou pro pracovní prostor.
ChatGPT vytvoří koncept aplikace pro pracovní prostor.
Správce zkontroluje a publikuje koncept.
Správce nakonfiguruje přístup a nastavení akcí pro publikovanou aplikaci.
Členové používají publikovanou aplikaci pracovního prostoru, nikoli původní šablonu.
Vyhledání a nastavení šablony aplikace
Otevřete Nastavení pracovního prostoru > Aplikace.
Vyberte Adresář.
Vyhledejte poskytovatele nebo název aplikace.
Hledejte položky označené jako šablony.
Výběrem možnosti Povolit spusťte postup nastavení.
Postup nastavení vyžaduje údaje potřebné k vytvoření aplikace specifické pro pracovní prostor. Přesná pole závisí na šabloně.
Například šablona GitHub Enterprise může vyžadovat údaje jako:
Název a popis aplikace.
Název hostitele GitHub Enterprise.
Konfigurace adresy URL zpětného volání.
ID klienta OAuth a tajný klíč klienta.
Soukromý klíč aplikace GitHub App.
Požadované rozsahy.
Podrobnosti nastavení webhooku.
Před vytvořením konceptu pečlivě zkontrolujte každé pole. Pokud vaše organizace spravuje OAuth nebo přihlašovací údaje poskytovatele centrálně, koordinujte postup s týmem, který tyto údaje vlastní.
Viz pokyny pro konkrétní aplikace: GitHub, Snowflake a Databricks.
Nastavení klienta OAuth
Některé šablony vyžadují, aby vaše organizace dodala vlastního klienta OAuth. Je-li to vyžadováno, vytvořte nebo nakonfigurujte aplikaci OAuth v administrační konzoli externího poskytovatele a poté zkopírujte adresu URL zpětného volání z ChatGPT do nastavení adresy URL pro přesměrování nebo zpětné volání u poskytovatele.
ID klienta OAuth a tajný klíč zadejte v ChatGPT až po ověření, že konfigurace poskytovatele odpovídá pokynům k nastavení šablony.
Pokud šablona obsahuje výchozí rozsahy, ponechte je, pokud vaše organizace nezkontrolovala oprávnění poskytovatele a nemá jasný důvod je změnit.
Vytvoření konceptu
Po zadání požadovaných informací vyberte Vytvořit koncept.
Vytvoření konceptu automaticky nezpřístupní aplikaci členům. Než členy požádáte, aby ji používali, koncept zkontrolujte, publikujte ho a nakonfigurujte přístup a nastavení akcí.
Publikování a správa výsledné aplikace
Po publikování spravujte aplikaci specifickou pro pracovní prostor v části Nastavení pracovního prostoru > Aplikace > Povoleno.
Doporučené kontroly po publikování:
Ověřte, že se aplikace zobrazuje v části Povolené aplikace.
Nastavte Přístup uživatelů pro role, které mají aplikaci používat.
Zkontrolujte Řízení akcí pro akce čtení a zápisu.
Zkontrolujte Oprávnění aplikace a zvolte, kdy se ChatGPT členů zeptá před použitím aplikace.
Požádejte povoleného testovacího uživatele, aby v ChatGPT otevřel Aplikace a ověřil, že se aplikace zobrazuje.
Pokud aplikace vyžaduje ověření u poskytovatele, nechte testovacího uživatele připojit jeho účet u poskytovatele.
Spusťte testovací prompt s nízkým rizikem a ověřte, že aplikace funguje podle očekávání.
Tato oprávnění aplikace platí pro konverzace v ChatGPT. Agenti pracovního prostoru používají ovládací prvky pro jednotlivé agenty nastavené tvůrcem agenta k určení, které akce aplikace jsou dostupné a kdy mají být koncoví uživatelé požádáni o jejich schválení. Chování agentů najdete zde: Agenti pracovního prostoru ChatGPT pro Enterprise a Business.
Pokud lze šablonu použít pouze jednou
Některé šablony mohou vytvořit pouze jednu aplikaci na pracovní prostor. Pokud už byla šablona použita, tlačítko Povolit nemusí být dostupné. V takovém případě spravujte stávající koncept nebo publikovanou aplikaci místo vytváření další ze stejné šablony.
Co členové uvidí
Členové uvidí publikovanou aplikaci vytvořenou ze šablony. Zda ji člen může vidět nebo používat, závisí na nastavení pracovního prostoru a autorizaci poskytovatele. Pokud je aplikace součástí pluginu, členové se s ní mohou setkat prostřednictvím tohoto pluginu, ale stále platí stejné požadavky na přístup k pracovnímu prostoru a autorizaci poskytovatele.
Zkontrolujte, že:
Aplikace je publikovaná.
Aplikace je pro pracovní prostor povolená.
Role člena v pracovním prostoru má přístup.
Člen je ve správném pracovním prostoru.
Člen má u externího poskytovatele požadovaná oprávnění.
Publikované aplikace se zobrazí v adresáři aplikací ChatGPT v části určené pro daný pracovní prostor.
Řešení potíží
Pokud nastavení selže nebo se aplikace nezobrazí, ověřte následující:
Název hostitele tenanta, účtu nebo pracovního prostoru je správný.
Adresa URL zpětného volání byla přesně zkopírována do konfigurace poskytovatele.
ID klienta OAuth a tajný klíč klienta jsou správné.
Požadované rozsahy odpovídají tomu, co aplikace OAuth poskytovatele umožňuje.
Byl vytvořen koncept.
Koncept byl publikován.
Přístup podle rolí umožňuje testovacímu uživateli aplikaci zobrazit.
Oprávnění na straně poskytovatele umožňují testovaná data nebo akci.
Poznámky k zabezpečení
S tajnými klíči klienta OAuth a přihlašovacími údaji poskytovatele zacházejte jako s citlivými informacemi.
Před vytvořením konceptu zkontrolujte požadované rozsahy.
Po publikování použijte Řízení akcí k omezení toho, co aplikace může dělat.
Pomocí Oprávnění aplikace určete, kdy se ChatGPT členů zeptá před použitím aplikace.
Upozorňujeme, že oprávnění poskytovatele platí i po povolení aplikace v ChatGPT.