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 -liittimen käyttöön sisäänrakennetulla OAuthilla tai organisaationsa omalla OAuth-asiakkaalla.

• 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ä antaa asiakastunnusta tai asiakassalaisuutta. Noudata alla olevan Sisäänrakennettu OAuth -osion ohjeita.

• Mukautettu OAuth-asiakas: Käytä tätä vaihtoehtoa, jos sisäänrakennettu OAuth ei ole saatavilla tai organisaatiosi edellyttää omaa OAuth-asiakasta. Noudata alla olevan Mukautettu OAuth-asiakas -osion ohjeita.

Mitä olet ottamassa käyttöön

Luot Databricks-sovellusyhteyden ChatGPT-tilillesi tai -työtilallesi. Molemmat vaihtoehdot edellyttävät ChatGPT:n pyytämiä Databricks-palveluntarjoajan tietoja ja käyttöoikeuksia resursseihin, joita aiot käyttää. Jos käytät mukautettua OAuth-asiakasta, valmistele myös seuraavat:

• Databricksin OAuth-sovellusyhteys, joka on luotu Databricks-tilisi hallintakonsolissa.

• Databricksin OAuth-asiakastunnus ja -asiakassalaisuus.

• ChatGPT:stä sellaisenaan kopioitu takaisinkutsu-URL.

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

• ChatGPT:n määrityksen aikana pyytämät Databricks-palveluntarjoajan tiedot, kuten työtilan isäntä, tilin isäntä, tilitunnus tai tietovarasto.

Ennen aloittamista

Jos teet määrityksen työtilalle, avaa hallintakonsoli, valitse haluamasi ChatGPT-työtila ja avaa Lisäosat. Avaa edelleen käytettävissä oleva Sovellukset-sivu valitsemalla Hallitse vanhoja sovelluksia. Lisätietoja työtilassa siirtymisestä ja vanhojen sovellusten käytöstä on artikkelissa Lisäosien ja sovellusten hallinta-asetukset, tietoturva ja vaatimustenmukaisuus.

Tarvitset seuraavat:

• ChatGPT-työtilan järjestelmänvalvojan tai omistajan käyttöoikeudet tai ChatGPT Plus- tai Pro-tilin.

• Mukautettua OAuth-asiakassovellusta varten Databricks-tilin järjestelmänvalvojan käyttöoikeudet. Työtilan järjestelmänvalvojan käyttöoikeudet voivat riittää joihinkin tehtäviin, mutta mukautetut sovellusyhteydet määritetään Databricksin tilinhallintakonsolissa. Sisäänrakennettua OAuthia varten Databricks-järjestelmänvalvojan on tarkistettava, että ChatGPT-sovellus on saatavilla ja otettu käyttöön työtilassasi.

• Mukautettua OAuth-asiakassovellusta varten Databricksin tilinhallintakonsolin avattuna erillisellä välilehdellä.

• Mukautettua OAuth-asiakassovellusta varten Databricks Genien yhteysnäkymän avattuna ChatGPT:ssä, jotta voit kopioida tarkan paluuosoitteen.

• Päätöksen sovelluksen tarvitsemista toiminnoista: Genie ja AI/BI-koontinäytöt, laajempi Databricksin API-käyttöoikeus vai Databricksin SQL-rajapintoihin rajattu sovellus. Pelkkä SQL-käyttöoikeus ei riitä Genien tai koontinäyttöjen toimintoihin.

• Mukautettua OAuth-asiakassovellusta varten turvallisen paikan Databricks-asiakassovelluksen salaisuuden käsittelyyn.

• Jos Databricks-tilisi tai -työtilasi rajoittaa pääsyä IP-käyttöoikeusluettelon, kontekstipohjaisen saapuvan liikenteen hallinnan, palomuurin tai muun verkkokäytännön avulla, tarvitset apua Databricks-järjestelmänvalvojalta, joka voi sallia nykyiset ChatGPT-yhdistimien lähtevän liikenteen IP-osoitealueet.

Mukautettua OAuth-asiakassovellusta varten kopioi ChatGPT:ssä näkyvä Paluu-URL täsmälleen sellaisenaan.

Valmistele nämä tiedot

• Mukautettua OAuth-asiakassovellusta varten Paluu-URL: kopioi se ChatGPT-yhdistimen määritysnäkymästä.

• Mukautettua OAuth-asiakassovellusta varten Databricksin OAuth-asiakassovelluksen tunnus.

• Mukautettua OAuth-asiakassovellusta varten Databricksin OAuth-asiakassovelluksen salaisuus.

• Mukautettua OAuth-asiakassovellusta 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 yhdessä offline_access-käyttöoikeusalueen kanssa) on edelleen vanhempi, laajempi vaihtoehto. Käytä SQL-käyttöoikeusaluetta vain sovellukselle, joka on rajattu Databricksin SQL-rajapintoihin.

• ChatGPT:n määrityksen aikana pyydetyt Databricks-työtilan tai -tilin kenttien tiedot.

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 mukautettu OAuth-sovellusyhteys Databricksissä

1. Avaa Databricks-tilisi tilinhallintakonsoli.

2. Avaa vasemmasta sivupalkista Asetukset.

3. Avaa Sovellusyhteydet-välilehti.

4. Valitse Lisää yhteys.

   

5. Syötä sovelluksen nimi, esimerkiksi ChatGPT:n Databricks-yhdistin.

6. Liitä ChatGPT:stä kopioitu paluuosoite täsmälleen sellaisenaan Uudelleenohjauksen URL-osoitteet -kenttään.

7. Valitse sovelluksen tarvitsemat käyttöoikeusalueet kohdassa 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 vanhempi, laajempi vaihtoehto yleiseen Databricksin API-käyttöön. Käytä tässä määrityksessä ChatGPT:ssä käyttöoikeusalueita all-apis ja offline_access ja varmista, että Databricksin OAuth-sovellus sallii molemmat. Suosi uudessa Genie- tai koontinäyttöyhteydessä näkyviä tarkasti rajattuja käyttöoikeusalueita.

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

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

12. Säilytä tunnisteiden voimassaoloaikoina Databricksin oletusarvot, ellei organisaatiollasi ole erillistä käytäntöä: käyttöoikeustunnisteelle 60 minuuttia ja päivitystunnisteelle 10 080 minuuttia.

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

14. Luo yhteys.

Kopioi tunnistetiedot Databricksistä

1. Kopioi Asiakassovelluksen tunnus valintaikkunasta Yhteys luotu.

2. Kopioi Asiakassovelluksen 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öoikeuksien tarkistukset kummassakin OAuth-vaihtoehdossa.

1. Tarkista yhdistimen tiedot, toiminnot ja todennusasetukset.

2. Jos olet työtilan järjestelmänvalvoja, ota yhdistin 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:stä testikäyttäjänä, jolla on käyttö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 yhdistimen tilana näkyy yhdistetty.

7. Suorita vähäriskinen lukutoiminto, joka vastaa yhteyden tukemia toimintoja. Jos kyseessä on Genie-yhteys, lähetä Genie-pyyntö tiedoista, joihin testikäyttäjällä on käyttöoikeus. Muiden tuettujen toimintojen osalta hae nykyisen käyttäjän tiedot tai suorita 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 selvästi vähäriskistä Databricks-työnkulkua ennen laajempaa käyttöönottoa.

9. Jos teet määrityksen työtilalle, pyydä työtilan jäsentä, jolla on käyttöoikeus mutta ei järjestelmänvalvojan oikeuksia, muodostamaan yhteys ja toistamaan vähäriskinen testi.

Hallitse käyttöoikeuksia

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

ChatGPT:ssä työtilan ylläpitäjät hallitsevat sovelluksen saatavuutta ja sitä, miten jäsenet voivat käyttää sitä. Businessissa ylläpitäjät hallitsevat sitä, onko sovellus käytössä koko työtilassa. Tarkista Databricks-sovellusten ylläpitoasetuksista (Työtilan asetukset > Sovellukset tai Ylläpitokonsoli > Laajennukset > Hallitse vanhoja sovelluksia) seuraavat kohdat:

• Käyttäjien käyttöoikeudet: määritä, mitkä työtilan roolit voivat käyttää liitintä 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ä lupaa ennen liittimen käyttöä.

Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtilan agentit käyttävät agentin luojan määrittämiä agenttikohtaisia asetuksia, jotka määräävät, mitkä sovellustoiminnot ovat käytettävissä ja milloin loppukäyttäjiltä pyydetään niihin hyväksyntä. Lisätietoja agenttien toiminnasta on artikkelissa ChatGPT-työtilan agentit Enterprise- ja Business-tilauksissa.

Databricksissä ylläpitäjät hallitsevat sitä, 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 edelleen voimassa, kun sovellus on otettu käyttöön ChatGPT:ssä.

Lisätietoja työtilassa siirtymisestä, sovellusten käyttöoikeuksista ja tilauskohtaisista sovellusten hallintatoiminnoista on artikkelissa Sovellusten ylläpitäjän hallintatoiminnot, tietoturva ja vaatimustenmukaisuus.

Databricks-yhdistimen määrityksen vianmääritys

• Uudelleenohjauksen URI-osoite ei täsmää: Jos käytät mukautettua OAuth-asiakassovellusta, varmista, että Databricksin Uudelleenohjauksen URL-osoitteet -kentän arvo vastaa täsmälleen ChatGPT:ssä näkyvää Paluu-URL-osoitetta, mukaan lukien polku ja paluutunnus. Älä poista paluutunnusta, lisää loppuun vinoviivaa tai korvaa osoitetta toisella ChatGPT:n uudelleenohjausosoitteella.

• Salaisuus puuttuu: Jos käytät mukautettua OAuth-asiakassovellusta, Databricksin salaisuudet näytetään vain kerran. Luo uusi asiakassovelluksen 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 mukautettua OAuth-asiakassovellusta, vertaa ChatGPT:n Käyttöoikeusalueet (valinnainen) -kenttää Databricksin OAuth-sovelluksen Käyttöoikeusalueet-kohtaan. Jokaisen ChatGPT:n pyytämän käyttöoikeusalueen on oltava käytössä siellä. 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 all-apis-käyttöoikeusalueen, päivitä sovellus tai luo se uudelleen niin, että se sallii kolme tarkasti rajattua käyttöoikeusaluetta.

  Jos tarkasti rajattuja käyttöoikeusalueita ei ole saatavilla, käytä tuettua laajempaa vaihtoehtoa: aseta ChatGPT:n käyttöoikeusalueiksi all-apis ja offline_access ja varmista, että Databricks-sovellus sallii molemmat. Sovellus, joka sallii vain all-apis-käyttöoikeusalueen, ei vastaa ChatGPT:n pyyntöä käyttöoikeusalueista ai-gateway, dashboards ja offline_access. Pelkkä SQL-käyttöoikeus sopii vain sovellukselle, joka on rajattu Databricksin SQL-rajapintoihin. Se ei riitä Genien tai koontinäyttöjen toimintoihin.

• SQL-toiminnot epäonnistuvat: Jos sovellus on rajattu Databricksin SQL-rajapintoihin, tarkista SQL-käyttöoikeusalue, tietovaraston määritys ja Databricks-käyttöoikeudet.

• Väärä ChatGPT-työtila: Luo yhdistin ja ota se käyttöön samassa ChatGPT-työtilassa, jossa käyttäjät muodostavat siihen yhteyden.

• 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 Businessissa, että sovellus on otettu käyttöön koko työtilassa. Varmista tuetuissa Enterprise- ja Edu-työtiloissa myös, että ChatGPT:n Käyttäjien käyttöoikeudet -asetus sallii yhdistimen.

• Databricksin verkkokäytäntö estää yhdistimen: Jos Databricks sallii vain tietyt lähde-IP-osoitteet, Databricks-järjestelmänvalvojan on päivitettävä asianmukaiset tilin tai työtilan IP-käyttöoikeusluettelot, kontekstipohjaiset saapuvan liikenteen hallintakeinot, palomuuri tai muut asiakkaan hallinnoimat verkkosäännöt.

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

  • Määritä nämä sallitut osoitealueet Databricksissä tai asiakkaan hallinnoimassa verkkokerroksessa. Tämä on erillinen määritys ChatGPT-työtilan sallittujen IP-osoitteiden luettelosta.

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

  • Älä vaihda asiakassovelluksen salaisuutta tai muuta OAuth-käyttöoikeusalueita verkkoeston kiertämiseksi. Tarkista ensin, hylkääkö Databricks yhdistimen 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