Usa questa guida se sei amministratore di un'area di lavoro ChatGPT o utente ChatGPT Plus o Pro e stai configurando l'app Databricks Genie con OAuth integrato o con il client OAuth della tua organizzazione.
OAuth integrato: usa la connessione preconfigurata quando è disponibile in ChatGPT e abilitata per la tua area di lavoro Databricks. Non devi creare un'app OAuth né inserire un ID client o un segreto client. Segui le istruzioni nella sezione OAuth integrato di seguito.
Client OAuth personalizzato: scegli questa procedura se OAuth integrato non è disponibile o se la tua organizzazione richiede l'uso di un proprio client OAuth. Segui le istruzioni nella sezione Client OAuth personalizzato di seguito.
Che cosa stai configurando
Stai creando una connessione all'app Databricks per il tuo account o la tua area di lavoro ChatGPT. Entrambe le procedure richiedono i dati del provider Databricks richiesti in ChatGPT e le autorizzazioni per le risorse che intendi usare. Se usi un client OAuth personalizzato, prepara anche:
Una connessione a un'app OAuth di Databricks creata nella console dell'account Databricks.
L'ID client e il segreto client OAuth di Databricks.
L'URL di callback esatto copiato da ChatGPT.
Gli ambiti Databricks corrispondenti alle funzionalità dell'app che vuoi abilitare.
Tutti i dati del provider Databricks richiesti dalla procedura di configurazione di ChatGPT, come host dell'area di lavoro, host dell'account, ID account o warehouse.
Prima di iniziare
Per configurare un'area di lavoro, apri la console di amministrazione, seleziona l'area di lavoro ChatGPT desiderata e apri Plugin. Seleziona Gestisci app legacy per aprire la pagina App, ancora disponibile. Per informazioni sulla navigazione nell'area di lavoro e sull'accesso alle app legacy, consulta Controlli amministrativi, sicurezza e conformità per plugin e app.
Ti servono:
L'accesso come amministratore o proprietario di un'area di lavoro ChatGPT, oppure un account ChatGPT Plus o Pro.
Per un client OAuth personalizzato, l'accesso come amministratore dell'account Databricks. L'accesso come amministratore dell'area di lavoro può bastare per alcune attività, ma le connessioni alle app personalizzate si configurano dalla console dell'account Databricks. Per OAuth integrato, un amministratore Databricks deve verificare che l'applicazione ChatGPT sia disponibile e abilitata per la tua area di lavoro.
Per un client OAuth personalizzato, la console dell'account Databricks aperta in una scheda separata.
Per un client OAuth personalizzato, la schermata di connessione a Databricks Genie aperta in ChatGPT, così da poter copiare l'URL di callback esatto.
Una scelta delle funzionalità necessarie all'app: Genie e dashboard IA/BI, un accesso più ampio alle API Databricks oppure un'app limitata alle API Databricks SQL. L'accesso solo SQL non è sufficiente per le azioni di Genie o delle dashboard.
Per un client OAuth personalizzato, un luogo sicuro in cui gestire il segreto client di Databricks.
Se il tuo account o la tua area di lavoro Databricks limita l'accesso tramite un elenco di accesso IP, un controllo del traffico in ingresso basato sul contesto, un firewall o un'altra policy di rete, l'aiuto di un amministratore Databricks che possa autorizzare gli attuali intervalli di IP in uscita delle app di ChatGPT.
Per un client OAuth personalizzato, copia l'URL di callback esatto mostrato in ChatGPT.
Valori da preparare
Per un client OAuth personalizzato, l'URL di callback: copialo dalla procedura di configurazione dell'app in ChatGPT.
Per un client OAuth personalizzato, l'ID client OAuth di Databricks.
Per un client OAuth personalizzato, il segreto client OAuth di Databricks.
Per un client OAuth personalizzato, gli ambiti di accesso Databricks adatti alle funzionalità dell'app. Per una nuova connessione a Genie o alle dashboard che mostra
ai-gateway,dashboardseoffline_access, prepara questi ambiti. TUTTE le API (all-apisconoffline_access) resta l'alternativa precedente, più ampia. Usa SQL solo per un'app limitata alle API Databricks SQL.I campi dell'area di lavoro o dell'account Databricks richiesti dalla procedura di configurazione di ChatGPT.
OAuth integrato
Prima assicurati di soddisfare i prerequisiti indicati sopra. Usa questa procedura solo se OAuth integrato è disponibile in ChatGPT ed è abilitato per la tua area di lavoro Databricks.
Chiedi a un amministratore Databricks di verificare che l'applicazione ChatGPT sia disponibile nelle impostazioni delle integrazioni delle app della console dell'account e sia abilitata per la tua area di lavoro. Se l'applicazione ChatGPT non è elencata nella console dell'account Databricks, contatta il tuo referente Databricks per sapere se la funzionalità è disponibile per il tuo account.
In ChatGPT, passa all'account o all'area di lavoro in cui l'app deve essere disponibile. Vai a Impostazioni > Plugin per una configurazione personale oppure, come amministratore o proprietario dell'area di lavoro, a Console di amministrazione > Plugin per configurare un'area di lavoro.
Seleziona Databricks Genie, quindi Aggiungi connessione app.
Inserisci il Nome host dell'area di lavoro (obbligatorio) senza
https://né un percorso URL.Da questo nome host, ChatGPT ricava l'endpoint MCP di Genie locale all'area di lavoro,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Non è necessario un endpoint MCP regionale separato.Seleziona Continua, quindi accedi a Databricks ed esamina la richiesta di consenso.
Prosegui con le sezioni Connessione e test e Gestione degli accessi riportate di seguito, inclusi i test con i membri autorizzati e le verifiche di accesso all'area di lavoro.
Client OAuth personalizzato
Prima assicurati di soddisfare i prerequisiti indicati sopra. Segui questa procedura se OAuth integrato non è disponibile o se la tua organizzazione richiede l'uso di un proprio client OAuth. Dopo la configurazione, completa le procedure nelle sezioni Connessione e test e Gestione degli accessi di seguito.
Avvia la configurazione OAuth personalizzata in ChatGPT
In ChatGPT, passa all'account o all'area di lavoro in cui l'app deve essere disponibile.
Vai a Impostazioni > Plugin per una configurazione personale oppure, come amministratore o proprietario dell'area di lavoro, a Console di amministrazione > Plugin per configurare un'area di lavoro.
Seleziona Databricks Genie nel Catalogo.
Seleziona Aggiungi connessione app.
Nella finestra di dialogo Connetti Databricks Genie, individua i campi ID client OAuth e Segreto client OAuth. L'inserimento delle credenziali in questi campi visibili attiva la procedura per il client personalizzato; non serve un selettore separato.
Copia l'URL di callback da ChatGPT. Lascia aperta questa finestra di dialogo.
Esempio di URL di callback:
https://chatgpt.com/connector/oauth/<callback_id>
Non rimuovere l'ID di callback, non aggiungere una barra finale e non sostituire l'URL con un URL generico di ChatGPT. L'URL registrato in Databricks deve corrispondere esattamente all'URL di callback mostrato in ChatGPT.
Crea una connessione a un'app OAuth personalizzata in Databricks
Apri la console del tuo account Databricks.
Nella barra laterale sinistra, apri Impostazioni.
Apri la scheda Connessioni alle app.
Seleziona Aggiungi connessione.
Inserisci un nome per l'applicazione, ad esempio ChatGPT Databricks.
In URL di reindirizzamento, incolla l'URL di callback esatto copiato da ChatGPT.
In Ambiti di accesso, scegli gli ambiti necessari all'app.
Per una nuova connessione a Genie o alle dashboard che mostra
ai-gateway,dashboardseoffline_accessin ChatGPT, consenti gli stessi ambiti nell'app OAuth di Databricks.TUTTE le API resta l'alternativa precedente, più ampia, per l'accesso generale alle API Databricks. Per questa configurazione, usa
all-apiseoffline_accessin ChatGPT e assicurati che l'app OAuth di Databricks li consenta entrambi. Per una nuova connessione a Genie o alle dashboard, preferisci gli ambiti granulari visualizzati.Usa SQL solo per un'app limitata alle API Databricks SQL. L'accesso solo SQL non è sufficiente per le azioni di Genie o delle dashboard.
Assicurati che ogni ambito elencato in seguito in ChatGPT sia abilitato in questa app OAuth di Databricks. Databricks consente automaticamente openid, email, profile e offline_access per le app create nell'interfaccia utente.
Lascia i TTL dei token ai valori predefiniti di Databricks, salvo specifiche policy della tua organizzazione: 60 minuti per il token di accesso e 10080 minuti per il token di aggiornamento.
Attiva Genera un segreto client. Per questa procedura, ChatGPT richiede un client OAuth riservato.
Crea la connessione.
Copia le credenziali da Databricks
Nella finestra di dialogo Connessione creata, copia l'ID client.
Copia subito il Segreto client e conservalo in modo sicuro.
Se chiudi la finestra di dialogo prima di copiare il segreto, crea nuove credenziali dell'app OAuth o ruota quelle esistenti e usa il nuovo segreto.
Databricks mostra il segreto una sola volta. Trattalo come una credenziale e non includerlo in screenshot, ticket, commenti o chat.
Completa la configurazione OAuth personalizzata in ChatGPT
Torna alla finestra di dialogo Connetti Databricks Genie.
Inserisci l'ID client Databricks in ID client OAuth.
Inserisci il segreto client Databricks in Segreto client OAuth.
Inserendo queste credenziali, verrà usato il tuo client OAuth personalizzato; non serve un selettore separato.
In Ambiti (facoltativo), inserisci gli ambiti necessari per l'endpoint Databricks e le funzionalità della tua app. Assicurati che corrispondano agli ambiti abilitati nell'app OAuth Databricks.
Per una nuova connessione Genie/dashboard che mostra
ai-gateway,dashboardseoffline_access, mantieni questi ambiti. Assicurati che l'app OAuth Databricks consenta gli stessi ambiti.ai-gatewayabilita la connessione MCP di Genie locale all'area di lavoro,dashboardsabilita le azioni sulle dashboard IA/BI eoffline_accessabilita i token di aggiornamento.L'alternativa precedente e più ampia,
all-apiseoffline_access, resta supportata per un accesso più esteso alle API, ma non è consigliata per questa connessione Genie/dashboard. Se l'app Databricks consente soloall-apis, aggiornala o ricreala per consentireai-gateway,dashboardseoffline_access. Se gli ambiti granulari non sono disponibili, imposta esplicitamenteall-apiseoffline_accessin ChatGPT e assicurati che l'app Databricks li consenta entrambi. Non richiedere i tre ambiti granulari in ChatGPT se l'app Databricks consente soloall-apis.Inserisci un ambito per riga oppure separa gli ambiti con virgole. Ogni ambito elencato in ChatGPT deve essere abilitato nell'app OAuth Databricks.
Inserisci il Nome host dell'area di lavoro (obbligatorio) senza https:// né un percorso URL. Compila tutti gli altri campi obbligatori del provider Databricks mostrati durante la configurazione.
Da questo nome host, ChatGPT ricava l'endpoint MCP di Genie locale all'area di lavoro,
https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Non è necessario un endpoint MCP regionale separato.Seleziona Continua.
ChatGPT richiede esattamente gli ambiti inseriti in Ambiti (facoltativo). Non aggiunge automaticamente gli ambiti più ampi previsti dal modello di configurazione.
Connetti e verifica
Per entrambe le procedure OAuth, completa i seguenti test di connessione e controlli di accesso.
Controlla i dettagli, le azioni e le impostazioni di autenticazione dell'app.
Se sei amministratore di un'area di lavoro, abilita l'app per l'area di lavoro e configura chi può usarla in base alle relative policy.
Avvia la procedura di connessione da ChatGPT con un utente di test autorizzato, quindi accedi a Databricks.
Verifica che il browser apra l'account o l'area di lavoro Databricks previsti.
Controlla gli ambiti richiesti, quindi seleziona Autorizza.
Verifica che il browser torni a ChatGPT e che l'app risulti connessa.
Esegui un'azione di lettura a basso rischio che corrisponda alle funzionalità della connessione. Per una connessione a Genie, invia una richiesta a Genie su dati a cui l'utente di test è autorizzato ad accedere. Per le altre funzionalità supportate, recupera le informazioni sull'utente corrente o esegui una query su una risorsa Databricks SQL approvata. Verifica che l'utente disponga delle autorizzazioni necessarie per le risorse Databricks; gli ambiti OAuth da soli non concedono l'accesso ai dati.
Se le azioni di scrittura sono abilitate, esegui un test con un flusso di lavoro Databricks chiaramente a basso rischio prima di estendere l'uso dell'app.
Per una configurazione dell'area di lavoro, chiedi a un membro autorizzato senza ruolo di amministratore di connettersi e ripetere il test a basso rischio.
Gestisci l'accesso
Databricks e ChatGPT contribuiscono entrambi al controllo degli accessi.
In ChatGPT, gli amministratori dell'area di lavoro gestiscono la disponibilità dell'app e le modalità di utilizzo da parte dei membri. In Business, gli amministratori gestiscono l'abilitazione dell'app per tutta l'area di lavoro. Esamina i controlli amministrativi delle app Databricks (Impostazioni dell'area di lavoro > App oppure Console di amministrazione > Plugin > Gestisci app legacy) per:
Accesso utenti, per configurare quali ruoli dell'area di lavoro possono usare l'app nelle aree di lavoro Enterprise ed Edu supportate.
Controllo delle azioni, per configurare quali azioni Databricks sono abilitate.
Autorizzazioni dell'app, per configurare quando ChatGPT chiede il consenso ai membri prima di usare l'app.
Queste autorizzazioni dell'app si applicano alle conversazioni di ChatGPT. Gli agenti dell'area di lavoro usano controlli specifici per ciascun agente, impostati dal suo creatore, per determinare quali azioni dell'app sono disponibili e quando chiedere agli utenti finali di approvarle. Per informazioni sul comportamento degli agenti, consulta: Agenti dell'area di lavoro ChatGPT per Enterprise e Business.
In Databricks, gli amministratori gestiscono quali utenti possono autorizzare l'app OAuth e a quali risorse Databricks possono accedere. Le autorizzazioni del provider continuano ad applicarsi anche dopo l'abilitazione dell'app in ChatGPT.
Per informazioni sulla navigazione nell'area di lavoro, sull'accesso alle app e sui controlli delle app specifici per piano, consulta: Controlli amministrativi, sicurezza e conformità nelle app.
Risoluzione dei problemi di configurazione dell'app Databricks
URI di reindirizzamento non corrispondente: se usi un client OAuth personalizzato, verifica che il valore di URL di reindirizzamento in Databricks corrisponda esattamente all'URL di callback mostrato in ChatGPT, inclusi il percorso e l'ID di callback. Non rimuovere l'ID di callback, non aggiungere una barra finale e non sostituire l'URL con un altro URL di reindirizzamento di ChatGPT.
Segreto mancante: se usi un client OAuth personalizzato, ricorda che i segreti di Databricks vengono mostrati una sola volta. Genera un nuovo segreto client se non lo hai copiato.
App OAuth non immediatamente disponibile: secondo Databricks, l'elaborazione degli aggiornamenti alle applicazioni OAuth può richiedere fino a 30 minuti.
Ambito insufficiente o non corrispondente: se usi un client OAuth personalizzato, confronta Ambiti (facoltativo) in ChatGPT con Ambiti di accesso nell'app OAuth di Databricks. Ogni ambito richiesto da ChatGPT deve essere abilitato nell'app. Verifica che gli ambiti supportino l'endpoint e le funzionalità che usi.
Per una nuova connessione a Genie o alle dashboard che mostra
ai-gateway,dashboardseoffline_access, mantieni questi ambiti in ChatGPT e assicurati che l'app Databricks li consenta tutti e tre. Se l'app consente soloall-apis, aggiornala o ricreala per consentire i tre ambiti granulari.Se gli ambiti granulari non sono disponibili, usa l'alternativa supportata più ampia: imposta
all-apiseoffline_accessin ChatGPT e assicurati che l'app Databricks li consenta entrambi. Un'app che consente soloall-apisnon soddisfa una richiesta di ChatGPT perai-gateway,dashboardseoffline_access. L'accesso solo SQL è adatto esclusivamente a un'app limitata alle API Databricks SQL; non è sufficiente per le azioni di Genie o delle dashboard.Le azioni SQL non riescono: per un'app limitata alle API Databricks SQL, verifica l'ambito SQL, la configurazione del warehouse e le autorizzazioni Databricks.
Area di lavoro ChatGPT errata: crea e abilita l'app nella stessa area di lavoro ChatGPT in cui gli utenti la collegheranno.
Account o area di lavoro Databricks errati: verifica il valore di Nome host dell'area di lavoro (obbligatorio), quindi ripeti la procedura di accesso e verifica che Databricks apra l'account o l'area di lavoro previsti.
Gli utenti non riescono a connettersi: verifica che l'utente abbia accesso a Databricks e possa autorizzare l'app OAuth. In Business, verifica che l'app sia abilitata per tutta l'area di lavoro. Nelle aree di lavoro Enterprise ed Edu supportate, verifica anche che l'impostazione Accesso utenti di ChatGPT consenta l'uso dell'app.
La policy di rete di Databricks blocca l'app: se Databricks consente solo determinati IP di origine, un amministratore Databricks deve aggiornare gli elenchi di accesso IP dell'account o dell'area di lavoro interessati, i controlli del traffico in ingresso basati sul contesto, il firewall o altre regole di rete gestite dal cliente.
Consenti le connessioni in ingresso dagli attuali intervalli di IP in uscita delle app di ChatGPT.
Configura questo elenco di IP consentiti in Databricks o nel livello di rete gestito dal cliente. È distinto dall'elenco di IP consentiti dell'area di lavoro ChatGPT.
Gli intervalli pubblicati possono cambiare. Quando possibile, automatizza gli aggiornamenti a partire dal JSON.
Non ruotare il segreto client né modificare gli ambiti OAuth per aggirare un blocco di rete. Verifica prima se Databricks sta rifiutando gli IP di origine dell'app.