Panoramica
I modelli di app offrono un percorso di configurazione per le aree di lavoro gestite che necessitano di una versione specifica di un'app o di un connettore ChatGPT. Gli amministratori e i proprietari dell'area di lavoro possono trovare i modelli nell'interfaccia di amministrazione App o Plugin disponibile, aggiungere la configurazione specifica dell'organizzazione e creare una bozza dell'app da rivedere. I modelli di app gestite non compaiono nelle aree di lavoro personali.
I modelli sono utili quando OpenAI può fornire le funzionalità comuni dell'app, ma ogni area di lavoro deve specificare la configurazione relativa al provider. A seconda del modello, questa configurazione può includere un nome di tenant o host, credenziali del client OAuth, URL di callback, ambiti di autorizzazione, dettagli dei webhook, URL di server MCP gestiti o altre impostazioni del provider. Ad esempio, un modello GitHub Enterprise può creare il connettore specifico per l'area di lavoro che Codex usa per accedere all'host GitHub Enterprise dell'organizzazione.
Dopo la configurazione, i membri non usano il modello originale. Usano l'app dell'area di lavoro creata dal modello e pubblicata. Gli amministratori possono quindi gestire l'app come le altre app ChatGPT. Su ChatGPT Business, i proprietari e gli amministratori abilitano o disabilitano l'app per l'area di lavoro. Su ChatGPT Enterprise/Edu, i proprietari e gli amministratori possono usare l'accesso alle app in base al ruolo, dove supportato. Gli amministratori possono anche gestire i controlli sulle azioni, le autorizzazioni delle app e l'autorizzazione presso il provider.
I plugin possono includere modelli di app o app create da modelli. Se un plugin include un modello di app, un amministratore o un proprietario dell'area di lavoro deve creare e pubblicare l'app specifica per l'area di lavoro prima che i membri possano collegarla in ChatGPT o usarla tramite il plugin. Il plugin usa l'istanza dell'app disponibile in quell'area di lavoro; i membri non configurano il modello originale.
Consulta questo articolo per la procedura generale di utilizzo dei modelli. Per la configurazione specifica del provider, consulta:
Ecco alcuni motivi comuni per usare un modello:
L'URL del provider include un tenant, un account, un'organizzazione o un nome host dell'area di lavoro aziendale.
L'organizzazione deve usare un proprio client OAuth o le proprie credenziali del provider.
Il provider richiede una configurazione dell'URL di callback specifica per il cliente.
L'app deve usare lo stesso schema di implementazione, mentre ogni area di lavoro controlla separatamente l'accesso, le azioni e le impostazioni di sicurezza.
Differenze tra modelli e app standard
Un'app standard può in genere essere abilitata direttamente. Un modello avvia invece una procedura di configurazione a cura dell'amministratore dell'area di lavoro.
La procedura abituale è la seguente:
Un amministratore trova il modello nella sezione App o Plugin dell'interfaccia di amministrazione dell'area di lavoro, a seconda dell'interfaccia disponibile.
L'amministratore inserisce la configurazione richiesta, specifica per l'area di lavoro.
ChatGPT crea una bozza dell'app per l'area di lavoro.
L'amministratore rivede e pubblica la bozza.
L'amministratore configura le impostazioni di accesso e delle azioni per l'app pubblicata.
I membri usano l'app pubblicata dell'area di lavoro, non il modello originale.
Trovare e configurare un modello di app
Le procedure seguenti descrivono l'interfaccia di amministrazione App. Se la tua area di lavoro usa Amministrazione > Plugin, apri invece il plugin o il modello pertinente e segui la relativa procedura di configurazione. Per informazioni sulla navigazione nell'area di lavoro e sui controlli di amministrazione specifici per piano, consulta: Controlli di amministrazione, sicurezza e conformità per plugin e app.
Vai a Impostazioni dell'area di lavoro > App.
Seleziona Directory.
Cerca il nome del provider o dell'app.
Cerca le voci contrassegnate come modelli.
Seleziona Abilita per avviare la procedura di configurazione.
La procedura di configurazione richiede i dettagli necessari per creare l'app specifica per l'area di lavoro. I campi esatti dipendono dal modello.
Ad esempio, un modello GitHub Enterprise potrebbe richiedere dettagli come:
Nome e descrizione dell'app.
Nome host di GitHub Enterprise.
Configurazione dell'URL di callback.
ID e segreto del client OAuth.
Chiave privata della GitHub App.
Ambiti di autorizzazione richiesti.
Dettagli di configurazione dei webhook.
Controlla attentamente ogni campo prima di creare la bozza. Se la tua organizzazione gestisce centralmente le credenziali OAuth o del provider, coordinati con il team responsabile di tali credenziali.
Per la configurazione specifica del provider, consulta: GitHub Enterprise, Snowflake e Databricks.
Configurazione del client OAuth
Alcuni modelli richiedono che l'organizzazione usi un 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 e il segreto del client OAuth in ChatGPT solo dopo aver verificato che la configurazione del provider corrisponda alle istruzioni di configurazione del modello.
Se il modello include ambiti di autorizzazione predefiniti, mantienili a meno che la tua organizzazione non abbia esaminato le autorizzazioni del provider e abbia un motivo preciso per modificarli.
Creare una bozza
Dopo aver inserito le informazioni richieste, seleziona Crea bozza.
La creazione di una bozza non rende automaticamente disponibile l'app ai membri. Rivedi la bozza, pubblicala e configura le impostazioni di accesso e delle azioni prima di chiedere ai membri di usare l'app.
Pubblicare e gestire l'app creata
Dopo la pubblicazione, gestisci l'app specifica per l'area di lavoro dalla sezione App o Plugin delle impostazioni dell'area di lavoro, a seconda dell'interfaccia disponibile.
Controlli consigliati dopo la pubblicazione:
Verifica che l'app compaia in App abilitate.
Su ChatGPT Business, abilita o disabilita l'app per l'area di lavoro. Su ChatGPT Enterprise/Edu, configura Accesso per ruolo per i ruoli che devono usare l'app, dove è supportato l'accesso alle app in base al ruolo.
Controlla le azioni di lettura e scrittura in Azioni.
Esamina Autorizzazioni dell'app per scegliere quando ChatGPT chiede conferma ai membri prima di usare l'app.
Chiedi a un utente di prova autorizzato di andare su App o Plugin, a seconda dell'interfaccia disponibile, e verificare che l'app pubblicata compaia.
Se l'app richiede l'autenticazione presso il provider, chiedi all'utente di prova di collegare il proprio account del provider.
Esegui un prompt di prova a basso rischio per verificare che l'app funzioni come previsto.
Queste autorizzazioni si applicano alle conversazioni di ChatGPT. Gli agenti dell'area di lavoro usano controlli separati definiti da chi crea l'agente. Per i dettagli, consulta: Agenti dell'area di lavoro di ChatGPT per Enterprise e Business.
Se un modello può essere usato una sola volta
Alcuni modelli potrebbero consentire la creazione di 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 o l'app pubblicata esistente anziché 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 presso il provider. Se l'app è inclusa in un plugin, i membri potrebbero trovarla tramite quel plugin, ma restano validi gli stessi requisiti di accesso all'area di lavoro e di autorizzazione presso il provider.
Se un plugin richiede un'app creata da un modello, potrebbe indicare che è necessaria la configurazione finché un amministratore non crea e pubblica l'app specifica per l'area di lavoro, non la abilita per l'area di lavoro su ChatGPT Business o per il ruolo pertinente su ChatGPT Enterprise/Edu, dove è supportato l'accesso alle app in base al ruolo, e non vengono completate tutte le autorizzazioni richieste presso il provider da parte dell'utente o dell'amministratore.
Verifica che:
L'app sia pubblicata.
L'app sia abilitata per l'area di lavoro.
Su ChatGPT Enterprise/Edu, il ruolo del membro nell'area di lavoro consenta l'accesso, dove è supportato l'accesso alle app in base al ruolo.
Il membro si trovi nell'area di lavoro corretta.
Il membro disponga delle autorizzazioni necessarie presso il provider esterno.
Le app pubblicate compaiono nella sezione App o Plugin delle impostazioni dell'area di lavoro, a seconda dell'interfaccia disponibile. Se l'app fa parte di un plugin, potrebbe comparire anche come app obbligatoria o facoltativa nella pagina dei dettagli del plugin.
Risolvere i problemi dei modelli di app
Se la configurazione non riesce o l'app non compare, verifica 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 e il segreto del client OAuth sono corretti.
Gli ambiti di autorizzazione richiesti corrispondono a quelli consentiti dall'app OAuth del provider.
È stata creata una bozza.
La bozza è stata pubblicata.
Su ChatGPT Business, l'app è abilitata per l'area di lavoro. Su ChatGPT Enterprise/Edu, l'accesso per ruolo consente all'utente di prova di vedere l'app, dove è supportato l'accesso alle app in base al ruolo.
Le autorizzazioni sul lato del provider consentono l'accesso ai dati o l'esecuzione dell'azione oggetto del test.
Esaminare i requisiti di sicurezza
Tratta i segreti del client OAuth e le credenziali del provider come informazioni sensibili.
Esamina gli ambiti di autorizzazione richiesti prima di creare la bozza.
Dopo la pubblicazione, usa Azioni per limitare ciò che l'app può fare.
Usa Autorizzazioni dell'app per decidere quando ChatGPT chiede conferma ai membri prima di usare l'app.
Tieni presente che le autorizzazioni del provider continuano ad applicarsi anche dopo l'abilitazione dell'app in ChatGPT.