Usa questa guida se sei un amministratore dell’area di lavoro ChatGPT e stai configurando il template dell’app Databricks per la tua organizzazione. Un template non è l’app finale usata dai membri. È un flusso di configurazione che crea una bozza di app specifica per l’area di lavoro dopo che hai fornito la configurazione Databricks richiesta.
Per Databricks, la maggior parte della configurazione avviene nella Databricks Account Console. Crei una connessione app OAuth personalizzata, registri l’URL di callback di ChatGPT, copi le credenziali client generate, quindi incolli quei valori nel flusso di configurazione del template di ChatGPT. Dopo che ChatGPT crea la bozza dell’app, puoi pubblicarla e gestirla come le altre app dell’area di lavoro.
Cosa stai configurando
Stai creando in ChatGPT un’app Databricks specifica per l’area di lavoro. L’app usa:
Una connessione app OAuth Databricks creata nella tua Databricks Account Console.
L’ID client OAuth e il segreto client OAuth di Databricks.
L’URL di callback esatto copiato da ChatGPT.
Ambiti Databricks corrispondenti alle funzionalità del connettore che vuoi abilitare.
Eventuali dettagli del provider Databricks richiesti dal flusso di configurazione di ChatGPT, come host dell’area di lavoro, host dell’account, ID account o warehouse.
Prima di iniziare
Ti servono:
Accesso da amministratore o proprietario dell’area di lavoro ChatGPT.
Accesso da amministratore dell’account Databricks. L’accesso da amministratore dell’area di lavoro può essere sufficiente per alcune attività, ma le connessioni app personalizzate vengono configurate dalla Databricks Account Console.
La Databricks Account Console aperta in una scheda separata.
La schermata di configurazione del template dell’app Databricks aperta in ChatGPT, così puoi copiare l’URL di callback esatto.
Una decisione sul fatto che l’app abbia bisogno di accesso generale alle API Databricks o solo di accesso a Databricks SQL.
Un luogo sicuro in cui gestire il segreto client Databricks.
Non inventare l’URL di callback. Copia l’URL di callback esatto mostrato in ChatGPT.
Valori da preparare
URL di callback: copialo dal flusso di configurazione del template di ChatGPT.
ID client OAuth Databricks.
Segreto client OAuth Databricks.
Ambiti di accesso Databricks, come ALL APIs o SQL.
Campi dell’area di lavoro o dell’account Databricks richiesti dal flusso di configurazione di ChatGPT.
Pubblica e gestisci l’app in ChatGPT
La creazione della bozza dell’app non la rende automaticamente disponibile ai membri. Dopo aver esaminato la bozza:
Pubblica la bozza dell’app.
Conferma che l’app compaia in Impostazioni area di lavoro > App > Abilitate.
Configura Accesso utente per i ruoli che devono usarla.
Esamina Controllo azioni per le azioni Databricks esposte dall’app.
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 compaia.
Queste autorizzazioni dell’app si applicano alle conversazioni ChatGPT. Gli agenti dell’area di lavoro usano controlli per agente impostati dal builder dell’agente per determinare quali azioni dell’app sono disponibili e quando agli utenti finali viene chiesto di approvarle. Per il comportamento dell’agente, vedi: Agenti dell’area di lavoro ChatGPT per Enterprise e Business.
Avvia la configurazione del template in ChatGPT
In ChatGPT, passa all’area di lavoro in cui l’app deve essere disponibile.
Apri Impostazioni area di lavoro > App.
Seleziona Directory.
Cerca Databricks.
Seleziona il template dell’app Databricks e avvia la configurazione.
Inserisci un nome e una descrizione chiari per l’app, ad esempio Databricks o Databricks - Data Platform.
Nella sezione del client OAuth, copia l’URL di callback da ChatGPT. Tieni aperta questa scheda.
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 sostituirlo con un URL ChatGPT generico.
Crea la connessione app OAuth in Databricks
Apri la Databricks Account Console per il tuo account Databricks.
Nella barra laterale sinistra, apri Impostazioni.
Apri la scheda Connessioni app.
Seleziona Aggiungi connessione.
Inserisci un nome applicazione, ad esempio ChatGPT Databricks Connector.
In URL di reindirizzamento, incolla l’URL di callback esatto copiato da ChatGPT.
In Ambiti di accesso, scegli gli ambiti necessari all’app.
Usa ALL APIs per un’app Databricks generale che richiede API Databricks oltre a SQL.
Usa solo SQL per un’app limitata alle API Databricks SQL.
Lascia i TTL dei token ai valori predefiniti di Databricks, a meno che la tua organizzazione non abbia una policy specifica.
Abilita Genera un segreto client. ChatGPT richiede un client OAuth riservato per questo flusso.
Crea la connessione.
Copia le credenziali da Databricks
Nella finestra Connessione creata, copia l’ID client.
Copia subito il Segreto client e conservalo in modo sicuro.
Se chiudi la finestra prima di copiare il segreto, crea o ruota le credenziali dell’app OAuth 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 in ChatGPT
Torna alla scheda di configurazione del template di ChatGPT.
Incolla l’ID client Databricks in ID client OAuth.
Incolla il segreto client Databricks in Segreto client OAuth.
Lascia invariati gli ambiti, a meno che tu non debba intenzionalmente sostituire i valori predefiniti del template.
Compila eventuali campi del provider Databricks richiesti dal flusso di configurazione, come host dell’area di lavoro, host dell’account, ID account, warehouse o altri valori specifici di Databricks.
Crea la bozza dell’app.
Testa l’app come utente
Avvia il flusso di connessione da ChatGPT come utente di test autorizzato.
Conferma che il browser apra l’account o l’area di lavoro Databricks previsti.
Approva gli ambiti richiesti.
Verifica che il browser torni a ChatGPT e che l’app risulti connessa.
Esegui prima un’azione di lettura a basso rischio, come recuperare le informazioni dell’utente corrente o interrogare una risorsa Databricks SQL approvata.
Se le azioni di scrittura sono abilitate, esegui il test con un flusso di lavoro Databricks chiaramente a basso rischio prima di una distribuzione più ampia.
Gestisci l’accesso
Databricks e ChatGPT contribuiscono entrambi al controllo degli accessi.
In ChatGPT, gli amministratori dell’area di lavoro gestiscono se l’app pubblicata è disponibile, quali ruoli dell’area di lavoro possono usarla, quali azioni sono abilitate e quando ChatGPT chiede agli utenti prima di usare l’app.
In Databricks, gli amministratori gestiscono quali utenti possono autorizzare l’app OAuth e a quali risorse Databricks possono accedere tali utenti. Le autorizzazioni del provider continuano ad applicarsi dopo l’abilitazione dell’app in ChatGPT.
Risoluzione dei problemi
Mancata corrispondenza dell’URI di reindirizzamento: conferma che l’URL di reindirizzamento Databricks corrisponda esattamente all’URL di callback mostrato in ChatGPT, inclusi percorso e ID di callback.
Segreto mancante: i segreti Databricks vengono mostrati una sola volta. Genera un nuovo segreto client se non è stato copiato.
App OAuth non disponibile subito: Databricks indica che l’elaborazione degli aggiornamenti delle applicazioni OAuth può richiedere fino a 30 minuti.
Ambito insufficiente: se ChatGPT riesce ad autenticarsi ma le chiamate API Databricks non riescono, conferma che l’app Databricks abbia ALL APIs quando l’app necessita di API non SQL.
Le azioni SQL non riescono: conferma l’ambito SQL, la configurazione del warehouse e le autorizzazioni Databricks.
Area di lavoro errata: crea e pubblica l’app nella stessa area di lavoro ChatGPT in cui gli utenti la connetteranno.
Gli utenti non riescono a connettersi: conferma che l’utente abbia accesso a Databricks e sia autorizzato ad autorizzare l’app OAuth.