Määritä Databricks-sovellusmalli ChatGPT:ssä

Tämä opas on tarkoitettu ChatGPT-työtilan ylläpitäjille sekä ChatGPT Plus- tai Pro-käyttäjille, jotka ottavat Databricks Genie -sovelluksen käyttöön sisäänrakennetulla OAuth-yhteydellä tai organisaationsa omalla OAuth-asiakasohjelmalla.

• Sisäänrakennettu OAuth: Käytä valmiiksi määritettyä yhteyttä, jos se on saatavilla ChatGPT:ssä ja otettu käyttöön Databricks-työtilassasi. Sinun ei tarvitse luoda OAuth-sovellusta eikä syöttää asiakasohjelman tunnusta tai salaisuutta. Noudata alla olevan Sisäänrakennettu OAuth -osion ohjeita.

• Oma OAuth-asiakasohjelma: Valitse tämä vaihtoehto, jos sisäänrakennettu OAuth ei ole saatavilla tai organisaatiosi edellyttää oman OAuth-asiakasohjelman käyttöä. Noudata alla olevan Oma OAuth-asiakasohjelma -osion ohjeita.

Mitä olet ottamassa käyttöön

Olet luomassa Databricks-sovellusyhteyttä ChatGPT-tilillesi tai -työtilaasi. Molemmat vaihtoehdot edellyttävät ChatGPT:ssä pyydettyjä Databricks-palveluntarjoajan tietoja sekä käyttöoikeuksia resursseihin, joita aiot käyttää. Jos käytät omaa OAuth-asiakasohjelmaa, valmistele myös seuraavat:

• Databricksin tilinhallintakonsolissa luotu Databricks OAuth -sovellusyhteys.

• Databricksin OAuth-asiakasohjelman tunnus ja salaisuus.

• ChatGPT:stä sellaisenaan kopioitu paluuosoite.

• Databricks-käyttöoikeusalueet, jotka vastaavat sovelluksessa käyttöön otettavia toimintoja.

• ChatGPT:n käyttöönotossa pyydetyt Databricks-palveluntarjoajan tiedot, kuten työtilan isäntä, tilin isäntä, tilin tunnus tai tietovarasto.

Ennen kuin aloitat

Jos otat sovelluksen käyttöön työtilassa, avaa hallintakonsoli, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat. Avaa edelleen käytettävissä oleva Sovellukset-sivu valitsemalla Hallinnoi vanhoja sovelluksia. Lisätietoja työtilassa siirtymisestä ja vanhojen sovellusten käytöstä on artikkelissa Lisäosien ja sovellusten ylläpitoasetukset, tietoturva ja vaatimustenmukaisuus.

Tarvitset seuraavat:

• ChatGPT-työtilan ylläpitäjän tai omistajan oikeudet tai ChatGPT Plus- tai Pro-tili.

• Omaa OAuth-asiakasohjelmaa varten Databricks-tilin ylläpitäjän oikeudet. Työtilan ylläpitäjän oikeudet voivat riittää joihinkin tehtäviin, mutta omat sovellusyhteydet määritetään Databricksin tilinhallintakonsolissa. Sisäänrakennettua OAuth-yhteyttä käytettäessä Databricks-ylläpitäjän on tarkistettava, että ChatGPT-sovellus on saatavilla ja otettu käyttöön työtilassasi.

• Omaa OAuth-asiakasohjelmaa varten Databricksin tilinhallintakonsoli avoinna erillisessä välilehdessä.

• Omaa OAuth-asiakasohjelmaa varten Databricks Genien yhteysnäkymä avoinna ChatGPT:ssä, jotta voit kopioida paluuosoitteen sellaisenaan.

• Päätös sovelluksen tarvitsemista toiminnoista: Genie ja AI/BI-koontinäytöt, laajemmat Databricks-rajapintojen käyttöoikeudet vai vain Databricksin SQL-rajapintoihin rajoittuva sovellus. Pelkkä SQL-käyttöoikeus ei riitä Genien tai koontinäyttöjen toimintoihin.

• Omaa OAuth-asiakasohjelmaa varten turvallinen paikka Databricks-asiakasohjelman salaisuuden käsittelyyn.

• Jos Databricks-tilisi tai -työtilasi rajoittaa pääsyä IP-käyttöoikeusluettelolla, kontekstipohjaisella saapuvan liikenteen hallinnalla, palomuurilla tai muulla verkkokäytännöllä, tarvitset apua Databricks-ylläpitäjältä, joka voi sallia nykyiset ChatGPT-sovellusten lähtevän liikenteen IP-osoitealueet.

Jos käytät omaa OAuth-asiakasohjelmaa, kopioi ChatGPT:ssä näkyvä Paluu-URL sellaisenaan.

Valmistele nämä arvot

• Omaa OAuth-asiakasohjelmaa varten Paluu-URL: kopioi se ChatGPT:n sovelluksen käyttöönottonäkymästä.

• Omaa OAuth-asiakasohjelmaa varten Databricksin OAuth-asiakasohjelman tunnus.

• Omaa OAuth-asiakasohjelmaa varten Databricksin OAuth-asiakasohjelman salaisuus.

• Omaa OAuth-asiakasohjelmaa varten sovelluksen toimintoihin sopivat Databricks-käyttöoikeusalueet. Jos uudessa Genie- tai koontinäyttöyhteydessä näkyvät ai-gateway, dashboards ja offline_access, valmistele nämä käyttöoikeusalueet. KAIKKI rajapinnat (all-apis ja offline_access) on edelleen käytettävissä vanhempana, laajempana vaihtoehtona. Käytä SQL-käyttöoikeusaluetta vain sovellukselle, joka käyttää ainoastaan Databricksin SQL-rajapintoja.

• ChatGPT:n käyttöönotossa pyydetyt Databricks-työtilan tai -tilin kentät.

Sisäänrakennettu OAuth

Varmista ensin, että yllä olevat edellytykset täyttyvät. Käytä tätä tapaa vain, jos sisäänrakennettu OAuth on saatavilla ChatGPT:ssä ja otettu käyttöön Databricks-työtilassasi.

1. Pyydä Databricks-järjestelmänvalvojaa tarkistamaan, että ChatGPT-sovellus on saatavilla tilinhallintakonsolin sovellusintegraatioiden asetuksissa ja otettu käyttöön työtilassasi. Jos ChatGPT-sovellusta ei näy Databricksin tilinhallintakonsolissa, kysy Databricksin asiakasvastaavaltasi, onko ominaisuus saatavilla tilillesi.

2. Vaihda ChatGPT:ssä siihen tiliin tai työtilaan, jossa sovelluksen on tarkoitus olla käytettävissä. Jos teet henkilökohtaisen määrityksen, siirry kohtaan Asetukset > Lisäosat. Jos teet määrityksen työtilalle sen järjestelmänvalvojana tai omistajana, siirry kohtaan Hallintakonsoli > Lisäosat.

3. Valitse Databricks Genie ja sitten Lisää sovellusyhteys.

4. Syötä Työtilan isäntänimi (pakollinen) ilman https://-alkua tai URL-polkua.

   ChatGPT muodostaa työtilakohtaisen Genie MCP -endpointin https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp tämän isäntänimen perusteella. Erillistä aluekohtaista MCP-endpointia ei tarvita.

5. Valitse Jatka, kirjaudu sitten Databricksiin ja tarkista suostumuspyyntö.

Jatka alla oleviin osioihin Yhdistä ja testaa sekä Hallitse käyttöoikeuksia. Tee myös testit jäsenillä, joilla on käyttöoikeus, ja tarkista työtilan käyttöoikeudet.

Mukautettu OAuth-asiakas

Varmista ensin, että edellä mainitut edellytykset täyttyvät. Käytä tätä vaihtoehtoa, jos sisäänrakennettu OAuth ei ole saatavilla tai organisaatiosi edellyttää omaa OAuth-asiakasta. Tee määrityksen jälkeen alla olevien osioiden Yhdistä ja testaa sekä Hallitse käyttöoikeuksia vaiheet.

Aloita mukautetun OAuthin määritys ChatGPT:ssä

1. Vaihda ChatGPT:ssä siihen tiliin tai työtilaan, jossa sovelluksen on tarkoitus olla käytettävissä.

2. Jos teet henkilökohtaisen määrityksen, siirry kohtaan Asetukset > Lisäosat. Jos teet määrityksen työtilalle sen järjestelmänvalvojana tai omistajana, siirry kohtaan Hallintakonsoli > Lisäosat.

3. Valitse Databricks Genie kohdasta Hakemisto.

4. Valitse Lisää sovellusyhteys.

5. Etsi Yhdistä Databricks Genie -valintaikkunasta kentät OAuth-asiakassovelluksen tunnus ja OAuth-asiakassovelluksen salaisuus. Mukautettu asiakassovellus otetaan käyttöön syöttämällä tunnistetiedot näihin näkyviin kenttiin. Erillistä valintaa ei tarvita.

6. Kopioi Paluu-URL ChatGPT:stä. Pidä tämä valintaikkuna avoinna.

Esimerkki paluuosoitteesta:

https://chatgpt.com/connector/oauth/<callback_id>

Älä poista paluutunnusta, lisää loppuun vinoviivaa tai korvaa osoitetta yleisellä ChatGPT-osoitteella. Databricksiin rekisteröidyn URL-osoitteen on vastattava täsmälleen ChatGPT:ssä näkyvää Paluu-URL-osoitetta.

Luo oma OAuth-sovellusyhteys Databricksissä

1. Avaa Databricks-tilisi tilinhallintakonsoli.

2. Avaa vasemmasta sivupalkista Asetukset.

3. Avaa Sovellusyhteydet-välilehti.

4. Valitse Lisää yhteys.

   

5. Anna sovellukselle nimi, esimerkiksi ChatGPT Databricks.

6. Liitä ChatGPT:stä kopioitu paluuosoite sellaisenaan Uudelleenohjaus-URL-osoitteet-kenttään.

7. Valitse Käyttöoikeusalueet-kohdasta sovelluksen tarvitsemat käyttöoikeusalueet.

8. Jos uudessa Genie- tai koontinäyttöyhteydessä näkyvät ChatGPT:ssä ai-gateway, dashboards ja offline_access, salli samat käyttöoikeusalueet Databricksin OAuth-sovelluksessa.

9. KAIKKI rajapinnat on edelleen käytettävissä vanhempana, laajempana vaihtoehtona Databricksin rajapintojen yleiseen käyttöön. Käytä tässä määrityksessä ChatGPT:n käyttöoikeusalueita all-apis ja offline_access ja varmista, että Databricksin OAuth-sovellus sallii molemmat. Käytä uudessa Genie- tai koontinäyttöyhteydessä ensisijaisesti näkyvissä olevia tarkemmin rajattuja käyttöoikeusalueita.

10. Käytä SQL-käyttöoikeusaluetta vain sovellukselle, joka käyttää ainoastaan Databricksin SQL-rajapintoja. Pelkkä SQL-käyttöoikeus ei riitä Genien tai koontinäyttöjen toimintoihin.

11. Varmista, että kaikki ChatGPT:ssä myöhemmin luetellut käyttöoikeusalueet ovat käytössä tässä Databricksin OAuth-sovelluksessa. Databricks sallii automaattisesti käyttöoikeusalueet openid, email, profile ja offline_access käyttöliittymässä luoduille sovelluksille.

12. Säilytä tunnisteiden voimassaoloajoissa (TTL) Databricksin oletusarvot, ellei organisaatiollasi ole niille erillistä käytäntöä: käyttötunnisteelle 60 minuuttia ja päivitystunnisteelle 10080 minuuttia.

13. Ota käyttöön Luo asiakasohjelman salaisuus. ChatGPT tarvitsee tähän menettelyyn luottamuksellisen OAuth-asiakasohjelman.

14. Luo yhteys.

Kopioi tunnistetiedot Databricksistä

1. Kopioi Asiakasohjelman tunnus Yhteys luotu -valintaikkunasta.

2. Kopioi Asiakasohjelman salaisuus heti ja tallenna se turvallisesti.

3. Jos suljet valintaikkunan ennen salaisuuden kopioimista, luo tai uusi OAuth-sovelluksen tunnistetiedot ja käytä uutta salaisuutta.

Databricks näyttää salaisuuden vain kerran. Käsittele sitä tunnistetietona äläkä sisällytä sitä kuvakaappauksiin, tukipyyntöihin, kommentteihin tai keskusteluihin.

Viimeistele mukautetun OAuthin määritys ChatGPT:ssä

1. Palaa Yhdistä Databricks Genie -valintaikkunaan.

2. Syötä Databricks-asiakassovelluksen tunnus OAuth-asiakassovelluksen tunnus -kenttään.

3. Syötä Databricks-asiakassovelluksen salaisuus OAuth-asiakassovelluksen salaisuus -kenttään.

   Näiden tunnistetietojen syöttäminen ottaa käyttöön mukautetun OAuth-asiakassovelluksesi. Erillistä valintaa ei tarvita.

4. Syötä Käyttöoikeusalueet (valinnainen) -kenttään sovelluksesi Databricks-endpointin ja toimintojen edellyttämät käyttöoikeusalueet. Varmista, että ne vastaavat Databricksin OAuth-sovelluksessa käyttöön otettuja käyttöoikeusalueita.

   Jos uudessa Genie- tai koontinäyttöyhteydessä näkyvät ai-gateway, dashboards ja offline_access, säilytä nämä käyttöoikeusalueet. Varmista, että Databricksin OAuth-sovellus sallii samat käyttöoikeusalueet. ai-gateway mahdollistaa työtilakohtaisen Genie MCP -yhteyden, dashboards AI/BI-koontinäyttöjen toiminnot ja offline_access päivitystunnisteiden käytön.

   Vanhempi, laajempi vaihtoehto eli all-apis ja offline_access on edelleen tuettu laajempaan API-käyttöön, mutta sitä ei suositella tälle Genie- tai koontinäyttöyhteydelle. Jos Databricks-sovellus sallii vain all-apis-käyttöoikeusalueen, päivitä sovellus tai luo se uudelleen niin, että se sallii käyttöoikeusalueet ai-gateway, dashboards ja offline_access. Jos tarkasti rajattuja käyttöoikeusalueita ei ole saatavilla, valitse ChatGPT:ssä tarkoituksella käyttöoikeusalueiksi all-apis ja offline_access ja varmista, että Databricks-sovellus sallii molemmat. Älä pyydä ChatGPT:ssä kolmea tarkasti rajattua käyttöoikeusaluetta, jos Databricks-sovellus sallii vain all-apis-käyttöoikeusalueen.

5. Syötä kukin käyttöoikeusalue omalle rivilleen tai erota ne pilkuilla. Kaikkien ChatGPT:ssä lueteltujen käyttöoikeusalueiden on oltava käytössä Databricksin OAuth-sovelluksessa.

6. Syötä Työtilan isäntänimi (pakollinen) ilman https://-alkua tai URL-polkua. Täytä muut määrityksen aikana näkyvät pakolliset Databricks-palveluntarjoajan kentät.

   ChatGPT muodostaa työtilakohtaisen Genie MCP -endpointin https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp tämän isäntänimen perusteella. Erillistä aluekohtaista MCP-endpointia ei tarvita.

7. Valitse Jatka.

ChatGPT pyytää täsmälleen ne käyttöoikeusalueet, jotka on syötetty Käyttöoikeusalueet (valinnainen) -kenttään. Se ei lisää automaattisesti mallipohjan laajempia käyttöoikeusalueita.

Yhdistä ja testaa

Tee seuraavat yhteystestit ja käyttöoikeustarkistukset kummassakin OAuth-vaihtoehdossa.

1. Tarkista sovelluksen tiedot, toiminnot ja todennusasetukset.

2. Jos olet työtilan ylläpitäjä, ota sovellus käyttöön työtilassa ja määritä työtilan käytännön mukaisesti, ketkä voivat käyttää sitä.

3. Aloita yhteyden muodostaminen ChatGPT:ssä testikäyttäjänä, jolla on siihen oikeus, ja kirjaudu sitten Databricksiin.

4. Varmista, että selain avaa oikean Databricks-tilin tai -työtilan.

5. Tarkista pyydetyt käyttöoikeusalueet ja valitse sitten Valtuuta.

   

6. Varmista, että selain palaa ChatGPT:hen ja sovellus näkyy yhdistettynä.

7. Suorita vähäriskinen lukutoiminto, jota yhteys tukee. Jos kyseessä on Genie-yhteys, lähetä Genielle pyyntö tiedoista, joihin testikäyttäjällä on käyttöoikeus. Testaa muita tuettuja toimintoja hakemalla nykyisen käyttäjän tiedot tai tekemällä kysely hyväksyttyyn Databricks SQL -resurssiin. Varmista, että käyttäjällä on tarvittavat Databricks-resurssien käyttöoikeudet. Pelkät OAuth-käyttöoikeusalueet eivät anna pääsyä tietoihin.

8. Jos kirjoitustoiminnot ovat käytössä, testaa niitä selvästi vähäriskisellä Databricks-työnkululla ennen laajempaa käyttöönottoa.

9. Jos sovellus otetaan käyttöön työtilassa, pyydä työtilan jäsentä, jolla on käyttöoikeus mutta ei ylläpitäjän oikeuksia, muodostamaan yhteys ja toistamaan vähäriskinen testi.

Hallinnoi käyttöoikeuksia

Käyttöoikeuksia hallitaan sekä Databricksissä että ChatGPT:ssä.

ChatGPT:ssä työtilan ylläpitäjät hallinnoivat sovelluksen saatavuutta ja sitä, miten jäsenet voivat käyttää sitä. Business-työtiloissa ylläpitäjät määrittävät, onko sovellus käytössä koko työtilassa. Tarkista seuraavat Databricks-sovellusten ylläpitoasetukset kohdasta Työtilan asetukset > Sovellukset tai Hallintakonsoli > Lisäosat > Hallinnoi vanhoja sovelluksia:

• Käyttäjien käyttöoikeudet: määritä, mitkä työtilan roolit voivat käyttää sovellusta tuetuissa Enterprise- ja Edu-työtiloissa.

• Toimintojen hallinta: määritä, mitkä Databricks-toiminnot ovat käytössä.

• Sovelluksen käyttöoikeudet: määritä, milloin ChatGPT pyytää jäseniltä luvan ennen sovelluksen käyttöä.

Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtila-agentit käyttävät rakentajansa määrittämiä agenttikohtaisia asetuksia, jotka määräävät, mitkä sovelluksen toiminnot ovat käytettävissä ja milloin loppukäyttäjiltä pyydetään hyväksyntä niiden suorittamiseen. Lisätietoja agenttien toiminnasta on artikkelissa ChatGPT:n työtila-agentit Enterprise- ja Business-työtiloissa.

Databricksissä ylläpitäjät määrittävät, ketkä käyttäjät voivat valtuuttaa OAuth-sovelluksen ja mitä Databricks-resursseja nämä käyttäjät voivat käyttää. Palveluntarjoajan käyttöoikeudet ovat voimassa myös sen jälkeen, kun sovellus on otettu käyttöön ChatGPT:ssä.

Lisätietoja työtilassa siirtymisestä, sovellusten käyttöoikeuksista ja tilauskohtaisista sovellusasetuksista on artikkelissa Sovellusten ylläpitoasetukset, tietoturva ja vaatimustenmukaisuus.

Databricks-sovelluksen käyttöönoton vianmääritys

• Uudelleenohjaus-URI ei täsmää: Jos käytät omaa OAuth-asiakasohjelmaa, varmista, että Databricksin Uudelleenohjaus-URL-osoitteet-kentän arvo vastaa täsmälleen ChatGPT:ssä näkyvää Paluu-URL-osoitetta, mukaan lukien polku ja paluukutsun tunnus. Älä poista paluukutsun tunnusta, lisää loppuun vinoviivaa tai vaihda tilalle toista ChatGPT:n uudelleenohjausosoitetta.

• Salaisuus puuttuu: Jos käytät omaa OAuth-asiakasohjelmaa, huomaa, että Databricks näyttää salaisuudet vain kerran. Luo uusi asiakasohjelman salaisuus, jos sitä ei kopioitu.

• OAuth-sovellus ei ole heti käytettävissä: Databricksin mukaan OAuth-sovelluksen päivitysten käsittely voi kestää jopa 30 minuuttia.

• Käyttöoikeusalue on riittämätön tai ei täsmää: Jos käytät omaa OAuth-asiakasohjelmaa, vertaa ChatGPT:n Käyttöoikeusalueet (valinnainen) -kenttää Databricksin OAuth-sovelluksen Käyttöoikeusalueet-kenttään. Kaikkien ChatGPT:n pyytämien käyttöoikeusalueiden on oltava siellä käytössä. Varmista, että käyttöoikeusalueet tukevat käyttämääsi endpointia ja toimintoja.

  Jos uudessa Genie- tai koontinäyttöyhteydessä näkyvät ai-gateway, dashboards ja offline_access, säilytä nämä käyttöoikeusalueet ChatGPT:ssä ja varmista, että Databricks-sovellus sallii kaikki kolme. Jos sovellus sallii vain käyttöoikeusalueen all-apis, päivitä se tai luo se uudelleen niin, että se sallii nämä kolme tarkemmin rajattua käyttöoikeusaluetta.

  Jos tarkemmin rajatut käyttöoikeusalueet eivät ole saatavilla, käytä tuettua laajempaa vaihtoehtoa: määritä ChatGPT:ssä käyttöoikeusalueiksi all-apis ja offline_access ja varmista, että Databricks-sovellus sallii molemmat. Sovellus, joka sallii vain käyttöoikeusalueen all-apis, ei vastaa ChatGPT:n pyyntöä, joka sisältää käyttöoikeusalueet ai-gateway, dashboards ja offline_access. Pelkkä SQL-käyttöoikeus sopii vain sovellukselle, joka käyttää ainoastaan Databricksin SQL-rajapintoja. Se ei riitä Genien tai koontinäyttöjen toimintoihin.

• SQL-toiminnot epäonnistuvat: Jos sovellus käyttää vain Databricksin SQL-rajapintoja, tarkista SQL-käyttöoikeusalue, tietovaraston määritykset ja Databricks-käyttöoikeudet.

• Väärä ChatGPT-työtila: Luo ja ota sovellus käyttöön samassa ChatGPT-työtilassa, jossa käyttäjät yhdistävät sen.

• Väärä Databricks-tili tai -työtila: Tarkista Työtilan isäntänimi (pakollinen) -kentän arvo, kirjaudu sitten uudelleen sisään ja varmista, että Databricks avaa oikean tilin tai työtilan.

• Käyttäjät eivät voi muodostaa yhteyttä: Varmista, että käyttäjällä on Databricks-käyttöoikeus ja lupa valtuuttaa OAuth-sovellus. Varmista Business-työtilassa, että sovellus on käytössä koko työtilassa. Varmista tuetuissa Enterprise- ja Edu-työtiloissa myös, että ChatGPT:n Käyttäjien käyttöoikeudet -asetus sallii sovelluksen käytön.

• Databricksin verkkokäytäntö estää sovelluksen: Jos Databricks sallii vain tietyt lähde-IP-osoitteet, Databricks-ylläpitäjän on päivitettävä kyseisen tilin tai työtilan IP-käyttöoikeusluettelot, kontekstipohjaiset saapuvan liikenteen hallinta-asetukset, palomuuri tai muut asiakkaan hallitsemat verkkosäännöt.

  • Salli saapuvat yhteydet nykyisistä ChatGPT-sovellusten lähtevän liikenteen IP-osoitealueista.

  • Määritä nämä sallitut osoitteet Databricksissä tai asiakkaan hallitsemassa verkkokerroksessa. Tämä on erillinen määritys, eikä se liity ChatGPT-työtilan sallittujen IP-osoitteiden luetteloon.

  • Julkaistut osoitealueet voivat muuttua. Automatisoi päivitykset JSON-tiedostosta, jos mahdollista.

  • Älä yritä kiertää verkkoestoa vaihtamalla asiakasohjelman salaisuutta tai muuttamalla OAuth-käyttöoikeusalueita. Tarkista ensin, estääkö Databricks sovelluksen lähde-IP-osoitteet.

Lähteet

• Databricksin dokumentaatio: Todennus käyttäjän ja koneen välisellä OAuthilla

• Databricksin dokumentaatio: OAuth-sovellusyhteyksien hallinta

• Databricksin dokumentaatio: IP-käyttöoikeusluetteloiden hallinta