Panoramica
I modelli di app sono un percorso di configurazione per le aree di lavoro Business ed Enterprise che necessitano di una versione specifica dell'area di lavoro di un'app o di un connettore ChatGPT. Invece di abilitare un'unica app condivisa dalla directory, un amministratore o proprietario dell'area di lavoro parte da un modello fornito da OpenAI, aggiunge i dettagli specifici della propria organizzazione e crea una bozza di app da esaminare.
I modelli sono utili quando OpenAI può fornire il comportamento comune dell'app, ma ogni area di lavoro deve fornire la configurazione specifica del provider. A seconda del modello, tale configurazione può includere un nome tenant o host, credenziali client OAuth, URL di callback, ambiti, dettagli dei webhook, URL dei server MCP gestiti o altre impostazioni del provider. Ad esempio, un modello GitHub Enterprise può creare il connettore specifico dell'area di lavoro che Codex usa per raggiungere l'host GitHub Enterprise di quell'organizzazione.
Dopo la configurazione, i membri non usano il modello originale. Usano l'app dell'area di lavoro pubblicata creata da esso. Gli amministratori possono quindi gestire quell'app come le altre app ChatGPT, inclusi accesso per ruolo, controlli delle azioni, autorizzazioni app e autorizzazione del provider.
Anche i plugin Codex possono includere modelli di app o app create da modelli. Se un plugin include un modello di app, un amministratore o proprietario dell'area di lavoro deve comunque creare e pubblicare l'app specifica dell'area di lavoro prima che i membri possano connetterla in ChatGPT e usarla tramite quel plugin. Quando il plugin viene eseguito, usa l'istanza dell'app disponibile in quell'area di lavoro invece di chiedere ai membri di configurare da soli il modello originale. Se il modello richiesto non è ancora stato configurato, i membri potrebbero aver bisogno che un amministratore completi prima la configurazione. Il plugin non può usare un modello di app da solo.
Usa questo articolo per il flusso generale dei modelli. Per la configurazione specifica del provider, consulta:
I modelli sono utili quando lo stesso schema di app può funzionare in molte organizzazioni, ma ciascuna organizzazione necessita della propria configurazione.
Esempi comuni includono:
L'URL del provider include un tenant, un account, un'organizzazione o un nome host dell'area di lavoro aziendale.
L'organizzazione deve fornire il proprio client OAuth o le credenziali del provider.
Il provider richiede la configurazione dell'URL di callback specifica del cliente.
L'app dovrebbe usare lo stesso schema di implementazione, mentre ogni area di lavoro controlla separatamente accesso, azioni e impostazioni di sicurezza.
In che modo i modelli differiscono dalle app normali
Di solito un'app normale può essere abilitata direttamente dalla directory delle app. Un modello avvia invece un flusso di configurazione.
Il flusso abituale è:
Un amministratore trova un modello nella directory delle app.
L'amministratore inserisce la configurazione specifica dell'area di lavoro richiesta.
ChatGPT crea una bozza di app per l'area di lavoro.
L'amministratore esamina e pubblica la bozza.
L'amministratore configura l'accesso e le impostazioni delle azioni per l'app pubblicata.
I membri usano l'app dell'area di lavoro pubblicata, non il modello originale.
Trovare e configurare un modello di app
Apri Impostazioni area di lavoro > App.
Seleziona Directory.
Cerca il provider o il nome dell'app.
Cerca le voci contrassegnate come modelli.
Seleziona Abilita per avviare il flusso di configurazione.
Il flusso di configurazione richiede i dettagli necessari per creare l'app specifica dell'area di lavoro. I campi esatti dipendono dal modello.
Ad esempio, un modello GitHub Enterprise può richiedere dettagli come:
Nome e descrizione dell'app.
Nome host GitHub Enterprise.
Configurazione dell'URL di callback.
ID client OAuth e segreto client.
Chiave privata dell'app GitHub.
Ambiti richiesti.
Dettagli di configurazione del webhook.
Esamina attentamente ogni campo prima di creare la bozza. Se la tua organizzazione gestisce OAuth o le credenziali del provider centralmente, coordinati con il team proprietario di tali credenziali.
Consulta le istruzioni specifiche dell'app: GitHub, Snowflake e Databricks.
Configurazione del client OAuth
Alcuni modelli richiedono che la tua organizzazione fornisca il proprio client OAuth. Quando è richiesto, crea o configura l'app OAuth nella console di amministrazione del provider esterno, quindi copia l'URL di callback da ChatGPT nelle impostazioni dell'URL di reindirizzamento o di callback del provider.
Inserisci l'ID client e il segreto OAuth in ChatGPT solo dopo aver confermato che la configurazione del provider corrisponde alle istruzioni di configurazione del modello.
Se il modello include ambiti predefiniti, mantieni quelli predefiniti a meno che la tua organizzazione non abbia esaminato le autorizzazioni del provider e abbia un motivo chiaro per modificarli.
Creare una bozza
Dopo aver inserito le informazioni richieste, seleziona Crea bozza.
La creazione di una bozza non rende automaticamente l'app disponibile ai membri. Esamina la bozza, pubblicala e configura l'accesso e le impostazioni delle azioni prima di chiedere ai membri di usarla.
Pubblicare e gestire l'app risultante
Dopo la pubblicazione, gestisci l'app specifica dell'area di lavoro da Impostazioni area di lavoro > App > Abilitate.
Controlli consigliati dopo la pubblicazione:
Conferma che l'app venga visualizzata in App abilitate.
Imposta Accesso utenti per i ruoli che devono usare l'app.
Esamina Controllo azioni per le azioni di lettura e scrittura.
Esamina Autorizzazioni app per scegliere quando ChatGPT deve chiedere ai membri prima di usare l'app.
Chiedi a un utente di test autorizzato di aprire App in ChatGPT e confermare che l'app venga visualizzata.
Se l'app richiede l'autenticazione del provider, chiedi all'utente di test di connettere il proprio account del provider.
Esegui un prompt di test a basso rischio per confermare che l'app funzioni come previsto.
Queste autorizzazioni app si applicano alle conversazioni ChatGPT. Gli agenti dell'area di lavoro usano controlli per agente impostati dal creatore dell'agente per determinare quali azioni dell'app sono disponibili e quando viene chiesto agli utenti finali di approvarle. Per il comportamento degli agenti, consulta: Agenti dell'area di lavoro ChatGPT per Enterprise e Business.
Se un modello può essere usato una sola volta
Alcuni modelli possono creare una sola app per area di lavoro. Se un modello è già stato usato, il pulsante Abilita potrebbe non essere disponibile. In tal caso, gestisci la bozza esistente o l'app pubblicata invece di crearne un'altra dallo stesso modello.
Cosa vedono i membri
I membri vedono l'app pubblicata creata dal modello. La possibilità per un membro di vederla o usarla dipende dalle impostazioni dell'area di lavoro e dall'autorizzazione del provider. Se l'app è inclusa in un plugin, i membri possono incontrarla tramite quel plugin, ma si applicano comunque gli stessi requisiti di accesso all'area di lavoro e di autorizzazione del provider.
Verifica che:
L'app sia pubblicata.
L'app sia abilitata per l'area di lavoro.
Il ruolo del membro nell'area di lavoro abbia accesso.
Il membro sia nell'area di lavoro corretta.
Il membro abbia le autorizzazioni richieste nel provider esterno.
Le app pubblicate verranno visualizzate nella directory delle app di ChatGPT, nella sezione specifica dell'area di lavoro.
Risoluzione dei problemi
Se la configurazione non riesce o l'app non viene visualizzata, conferma quanto segue:
Il tenant, l'account o il nome host dell'area di lavoro è corretto.
L'URL di callback è stato copiato esattamente nella configurazione del provider.
L'ID client OAuth e il segreto client sono corretti.
Gli ambiti richiesti corrispondono a ciò che l'app OAuth del provider consente.
È stata creata una bozza.
La bozza è stata pubblicata.
L'accesso basato sul ruolo consente all'utente di test di vedere l'app.
Le autorizzazioni lato provider consentono i dati o l'azione in fase di test.
Note sulla sicurezza
Tratta i segreti client OAuth e le credenziali del provider come informazioni sensibili.
Esamina gli ambiti richiesti prima di creare la bozza.
Usa Controllo azioni dopo la pubblicazione per limitare ciò che l'app può fare.
Usa Autorizzazioni app per decidere quando ChatGPT deve chiedere ai membri prima di usare l'app.
Tieni presente che le autorizzazioni del provider continuano ad applicarsi dopo che l'app è stata abilitata in ChatGPT.