Prezentare generală
Șabloanele de aplicații sunt o cale de configurare pentru spațiile de lucru Business și Enterprise care au nevoie de o versiune specifică spațiului de lucru a unei aplicații sau a unui conector ChatGPT. În loc să activeze o aplicație partajată din director, un administrator sau proprietar al spațiului de lucru pornește de la un șablon furnizat de OpenAI, adaugă detaliile unice ale organizației sale și creează o ciornă de aplicație pentru revizuire.
Șabloanele sunt utile când OpenAI poate furniza comportamentul comun al aplicației, dar fiecare spațiu de lucru trebuie să furnizeze configurația specifică furnizorului. În funcție de șablon, acea configurație poate include un tenant sau un nume de gazdă, acreditări de client OAuth, URL-uri de callback, scope-uri, detalii webhook, URL-uri ale serverelor MCP gestionate sau alte setări ale furnizorului. De exemplu, un șablon GitHub Enterprise poate crea conectorul specific spațiului de lucru pe care Codex îl folosește pentru a accesa gazda GitHub Enterprise a organizației respective.
După configurare, membrii nu folosesc șablonul original. Ei folosesc aplicația publicată a spațiului de lucru, creată din acesta. Administratorii pot gestiona apoi acea aplicație ca pe alte aplicații ChatGPT, inclusiv accesul pe roluri, controalele acțiunilor, permisiunile aplicației și autorizarea furnizorului.
Pluginurile Codex pot include și șabloane de aplicații sau aplicații create din șabloane. Dacă un plugin include un șablon de aplicație, un administrator sau proprietar al spațiului de lucru trebuie totuși să creeze și să publice aplicația specifică spațiului de lucru înainte ca membrii să o poată conecta în ChatGPT și să o folosească prin acel plugin. Când pluginul rulează, folosește instanța aplicației disponibilă în acel spațiu de lucru, în loc să le ceară membrilor să configureze ei înșiși șablonul original. Dacă șablonul necesar nu a fost încă configurat, membrii pot avea nevoie ca un administrator să finalizeze mai întâi configurarea. Pluginul nu poate folosi singur un șablon de aplicație.
Folosiți acest articol pentru fluxul general al șabloanelor. Pentru configurarea specifică furnizorului, consultați:
Șabloanele sunt utile când același tipar de aplicație poate funcționa în multe organizații, dar fiecare organizație are nevoie de propria configurație.
Exemplele comune includ:
URL-ul furnizorului include un nume de gazdă pentru tenantul, contul, organizația sau spațiul de lucru al companiei.
Organizația trebuie să aducă propriul client OAuth sau propriile acreditări ale furnizorului.
Furnizorul necesită configurarea unui URL de callback specific clientului.
Aplicația ar trebui să folosească același tipar de implementare, în timp ce fiecare spațiu de lucru controlează separat accesul, acțiunile și setările de securitate.
Cum diferă șabloanele de aplicațiile obișnuite
O aplicație obișnuită poate fi de obicei activată direct din directorul de aplicații. Un șablon pornește în schimb un flux de configurare.
Fluxul obișnuit este:
Un administrator găsește un șablon în directorul de aplicații.
Administratorul introduce configurația necesară, specifică spațiului de lucru.
ChatGPT creează o ciornă de aplicație pentru spațiul de lucru.
Administratorul revizuiește și publică ciorna.
Administratorul configurează accesul și setările acțiunilor pentru aplicația publicată.
Membrii folosesc aplicația publicată a spațiului de lucru, nu șablonul original.
Găsiți și configurați un șablon de aplicație
Deschideți Setări spațiu de lucru > Aplicații.
Selectați Director.
Căutați furnizorul sau numele aplicației.
Căutați intrările marcate ca șabloane.
Selectați Activează pentru a porni fluxul de configurare.
Fluxul de configurare solicită detaliile necesare pentru a crea aplicația specifică spațiului de lucru. Câmpurile exacte depind de șablon.
De exemplu, un șablon GitHub Enterprise poate solicita detalii precum:
Numele și descrierea aplicației.
Numele de gazdă GitHub Enterprise.
Configurarea URL-ului de callback.
ID-ul clientului OAuth și secretul clientului.
Cheia privată a aplicației GitHub.
Scope-urile solicitate.
Detaliile configurării webhook.
Revizuiți cu atenție fiecare câmp înainte de a crea ciorna. Dacă organizația dvs. gestionează centralizat OAuth sau acreditările furnizorului, coordonați-vă cu echipa care deține acele acreditări.
Consultați instrucțiunile specifice aplicației: GitHub, Snowflake și Databricks.
Configurarea clientului OAuth
Unele șabloane cer organizației dvs. să aducă propriul client OAuth. Când acest lucru este necesar, creați sau configurați aplicația OAuth în consola de administrare a furnizorului extern, apoi copiați URL-ul de callback din ChatGPT în setările furnizorului pentru URL-ul de redirecționare sau de callback.
Introduceți ID-ul clientului OAuth și secretul în ChatGPT numai după ce confirmați că configurația furnizorului corespunde instrucțiunilor de configurare ale șablonului.
Dacă șablonul include scope-uri implicite, păstrați valorile implicite, cu excepția cazului în care organizația dvs. a revizuit permisiunile furnizorului și are un motiv clar să le modifice.
Creați o ciornă
După ce introduceți informațiile necesare, selectați Creează ciornă.
Crearea unei ciorne nu face automat aplicația disponibilă membrilor. Revizuiți ciorna, publicați-o și configurați accesul și setările acțiunilor înainte de a le cere membrilor să o folosească.
Publicați și gestionați aplicația rezultată
După publicare, gestionați aplicația specifică spațiului de lucru din Setări spațiu de lucru > Aplicații > Activate.
Verificări recomandate după publicare:
Confirmați că aplicația apare în Aplicații activate.
Setați Acces utilizator pentru rolurile care ar trebui să folosească aplicația.
Revizuiți Controlul acțiunilor pentru acțiunile de citire și scriere.
Revizuiți Permisiunile aplicației pentru a alege când ChatGPT le cere membrilor confirmare înainte de a folosi aplicația.
Cereți unui utilizator de test permis să deschidă Aplicații în ChatGPT și să confirme că aplicația apare.
Dacă aplicația necesită autentificare la furnizor, cereți utilizatorului de test să își conecteze contul de furnizor.
Rulați o solicitare de test cu risc scăzut pentru a confirma că aplicația funcționează conform așteptărilor.
Aceste permisiuni ale aplicației se aplică conversațiilor ChatGPT. Agenții spațiului de lucru folosesc controale per agent, stabilite de creatorul agentului, pentru a determina ce acțiuni ale aplicației sunt disponibile și când li se cere utilizatorilor finali să le aprobe. Pentru comportamentul agenților, consultați: Agenții spațiului de lucru ChatGPT pentru Enterprise și Business.
Dacă un șablon poate fi folosit o singură dată
Unele șabloane pot crea o singură aplicație per spațiu de lucru. Dacă un șablon a fost deja folosit, butonul Activează poate fi indisponibil. În acest caz, gestionați ciorna existentă sau aplicația publicată existentă, în loc să creați alta din același șablon.
Ce văd membrii
Membrii văd aplicația publicată, creată din șablon. Dacă un membru o poate vedea sau folosi depinde de setările spațiului de lucru și de autorizarea furnizorului. Dacă aplicația este inclusă într-un plugin, membrii o pot întâlni prin acel plugin, dar se aplică în continuare aceleași cerințe privind accesul la spațiul de lucru și autorizarea furnizorului.
Verificați că:
Aplicația este publicată.
Aplicația este activată pentru spațiul de lucru.
Rolul membrului în spațiul de lucru are acces.
Membrul se află în spațiul de lucru corect.
Membrul are permisiunile necesare la furnizorul extern.
Aplicațiile publicate vor apărea în directorul de aplicații ChatGPT, în secțiunea specifică spațiului de lucru.
Depanare
Dacă configurarea eșuează sau aplicația nu apare, confirmați următoarele:
Numele de gazdă al tenantului, contului sau spațiului de lucru este corect.
URL-ul de callback a fost copiat exact în configurația furnizorului.
ID-ul clientului OAuth și secretul clientului sunt corecte.
Scope-urile solicitate corespund celor permise de aplicația OAuth a furnizorului.
A fost creată o ciornă.
Ciorna a fost publicată.
Accesul pe roluri îi permite utilizatorului de test să vadă aplicația.
Permisiunile din partea furnizorului permit datele sau acțiunea testată.
Note de securitate
Tratați secretele clienților OAuth și acreditările furnizorilor ca informații sensibile.
Revizuiți scope-urile solicitate înainte de a crea ciorna.
Folosiți Controlul acțiunilor după publicare pentru a limita ce poate face aplicația.
Folosiți Permisiunile aplicației pentru a decide când ChatGPT le cere membrilor confirmare înainte de a folosi aplicația.
Rețineți că permisiunile furnizorului se aplică în continuare după ce aplicația este activată în ChatGPT.