Käytä tätä opasta, jos olet ChatGPT-työtilan ylläpitäjä ja otat Databricks-sovellusmallia käyttöön organisaatiollesi. Malli ei ole lopullinen sovellus, jota jäsenet käyttävät. Se on määrityskulku, joka luo työtilakohtaisen luonnossovelluksen, kun olet antanut vaaditut Databricks-määritykset.
Databricksin osalta suurin osa määrityksistä tehdään Databricks Account Consolessa. Luo mukautettu OAuth-sovellusyhteys, rekisteröi ChatGPT:n callback-URL, kopioi luodut asiakastunnistetiedot ja liitä sitten nämä arvot ChatGPT:n mallin määrityskulkuun. Kun ChatGPT on luonut luonnossovelluksen, voit julkaista sen ja hallita sitä kuten muita työtilan sovelluksia.
Mitä olet määrittämässä
Olet luomassa työtilakohtaista Databricks-sovellusta ChatGPT:ssä. Sovellus käyttää:
Databricks OAuth -sovellusyhteyttä, joka on luotu Databricks Account Consolessa.
Databricks OAuth -asiakastunnusta ja asiakassalaisuutta.
Täsmällistä ChatGPT:stä kopioitua callback-URL-osoitetta.
Databricksin käyttöalueita, jotka vastaavat käyttöön otettavia yhdistimen ominaisuuksia.
Kaikkia ChatGPT:n määrityskulun pyytämiä Databricks-palveluntarjoajan tietoja, kuten työtilan isäntää, tilin isäntää, tilitunnusta tai warehousea.
Ennen aloittamista
Tarvitset:
ChatGPT-työtilan ylläpitäjän tai omistajan käyttöoikeudet.
Databricks-tilin ylläpitäjän käyttöoikeudet. Työtilan ylläpitäjän käyttöoikeudet voivat riittää joihinkin tehtäviin, mutta mukautetut sovellusyhteydet määritetään Databricks Account Consolessa.
Databricks Account Console avattuna erillisessä välilehdessä.
Databricks-sovellusmallin määritysnäyttö avattuna ChatGPT:ssä, jotta voit kopioida täsmällisen callback-URL-osoitteen.
Päätös siitä, tarvitseeko sovellus yleisen Databricks API -käyttöoikeuden vai vain Databricks SQL -käyttöoikeuden.
Turvallinen paikka Databricksin asiakassalaisuuden käsittelyyn.
Älä keksi callback-URL-osoitetta itse. Kopioi täsmälleen ChatGPT:ssä näkyvä callback-URL.
Valmisteltavat arvot
Callback-URL: kopioi tämä ChatGPT:n mallin määrityskulusta.
Databricks OAuth -asiakastunnus.
Databricks OAuth -asiakassalaisuus.
Databricksin käyttöalueet, kuten ALL APIs tai SQL.
Databricksin työtila- tai tilikentät, joita ChatGPT:n määrityskulku pyytää.
Julkaise ja hallitse sovellusta ChatGPT:ssä
Luonnossovelluksen luominen ei automaattisesti tee siitä jäsenten käytettävissä olevaa. Kun olet tarkistanut luonnoksen:
Julkaise luonnossovellus.
Varmista, että sovellus näkyy kohdassa Työtilan asetukset > Sovellukset > Käytössä.
Määritä Käyttäjien käyttöoikeudet rooleille, joiden tulisi käyttää sitä.
Tarkista Toimintojen hallinta sovelluksen tarjoamien Databricks-toimintojen osalta.
Tarkista Sovelluksen käyttöoikeudet ja valitse, milloin ChatGPT kysyy jäseniltä ennen sovelluksen käyttöä.
Pyydä sallittua testikäyttäjää avaamaan Sovellukset ChatGPT:ssä ja vahvistamaan, että sovellus näkyy.
Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtilan agentit käyttävät agentin rakentajan määrittämiä agenttikohtaisia hallinta-asetuksia sen määrittämiseen, mitkä sovellustoiminnot ovat käytettävissä ja milloin loppukäyttäjiltä pyydetään hyväksyntää. Katso agentin toimintaa koskevat tiedot: ChatGPT:n työtilan agentit Enterprise- ja Business-versioille.
Aloita mallin määritys ChatGPT:ssä
Siirry ChatGPT:ssä työtilaan, jossa sovelluksen tulisi olla käytettävissä.
Avaa Työtilan asetukset > Sovellukset.
Valitse Hakemisto.
Hae Databricksia.
Valitse Databricks-sovellusmalli ja aloita määritys.
Anna selkeä sovelluksen nimi ja kuvaus, kuten Databricks tai Databricks - Data Platform.
Kopioi OAuth-asiakasosiossa callback-URL ChatGPT:stä. Pidä tämä välilehti auki.
Esimerkki callback-URL-osoitteesta: https://chatgpt.com/connector/oauth/<callback_id>
Älä poista callback-tunnusta, lisää lopputason kauttaviivaa tai korvaa sitä yleisellä ChatGPT-URL-osoitteella.
Luo OAuth-sovellusyhteys Databricksissä
Avaa Databricks-tilisi Databricks Account Console.
Avaa vasemmasta sivupalkista Asetukset.
Avaa Sovellusyhteydet-välilehti.
Valitse Lisää yhteys.
Anna sovelluksen nimi, kuten ChatGPT Databricks Connector.
Liitä kohtaan Uudelleenohjaus-URL-osoitteet täsmällinen ChatGPT:stä kopioitu callback-URL.
Valitse kohdassa Käyttöalueet sovelluksen tarvitsemat käyttöalueet.
Käytä ALL APIs -vaihtoehtoa yleiselle Databricks-sovellukselle, joka tarvitsee Databricks API -rajapintoja SQL:n lisäksi.
Käytä SQL-vaihtoehtoa vain sovellukselle, joka on rajoitettu Databricks SQL API -rajapintoihin.
Jätä tokenien TTL-arvot Databricksin oletuksiin, ellei organisaatiollasi ole erityistä käytäntöä.
Ota Luo asiakassalaisuus käyttöön. ChatGPT tarvitsee tätä kulkua varten luottamuksellisen OAuth-asiakkaan.
Luo yhteys.
Kopioi tunnistetiedot Databricksistä
Kopioi Asiakastunnus Yhteys luotu -valintaikkunassa.
Kopioi Asiakassalaisuus heti ja tallenna se turvallisesti.
Jos suljet valintaikkunan ennen salaisuuden kopiointia, luo tai kierrätä OAuth-sovelluksen tunnistetiedot ja käytä uutta salaisuutta.
Databricks näyttää salaisuuden vain kerran. Käsittele sitä tunnistetietona äläkä sisällytä sitä näyttökuviin, tukipyyntöihin, kommentteihin tai chatteihin.
Viimeistele määritys ChatGPT:ssä
Palaa ChatGPT-mallin määritysvälilehteen.
Liitä Databricksin asiakastunnus OAuth-asiakastunnuksen kenttään.
Liitä Databricksin asiakassalaisuus OAuth-asiakassalaisuuden kenttään.
Jätä Käyttöalueet muuttamatta, ellet tarkoituksella halua ohittaa mallin oletuksia.
Täytä kaikki määrityskulun vaatimat Databricks-palveluntarjoajan kentät, kuten työtilan isäntä, tilin isäntä, tilitunnus, warehouse tai muut Databricks-kohtaiset arvot.
Luo luonnossovellus.
Testaa sovellusta käyttäjänä
Käynnistä yhdistämiskulku ChatGPT:stä sallittuna testikäyttäjänä.
Varmista, että selain avaa odotetun Databricks-tilin tai -työtilan.
Hyväksy pyydetyt käyttöalueet.
Varmista, että selain palaa ChatGPT:hen ja sovellus näkyy yhdistettynä.
Suorita ensin vähäriskinen lukutoiminto, kuten nykyisen käyttäjän tietojen noutaminen tai hyväksytyn Databricks SQL -resurssin kysely.
Jos kirjoitustoiminnot ovat käytössä, testaa selvästi vähäriskisellä Databricks-työnkululla ennen laajempaa käyttöönottoa.
Käyttöoikeuksien hallinta
Sekä Databricks että ChatGPT vaikuttavat käyttöoikeuksien hallintaan.
ChatGPT:ssä työtilan ylläpitäjät hallitsevat, onko julkaistu sovellus käytettävissä, mitkä työtilan roolit voivat käyttää sitä, mitkä toiminnot ovat käytössä ja milloin ChatGPT kysyy käyttäjiltä ennen sovelluksen käyttöä.
Databricksissä ylläpitäjät hallitsevat, mitkä käyttäjät voivat valtuuttaa OAuth-sovelluksen ja mihin Databricks-resursseihin nämä käyttäjät pääsevät. Palveluntarjoajan käyttöoikeudet ovat edelleen voimassa, kun sovellus on otettu käyttöön ChatGPT:ssä.
Vianmääritys
Uudelleenohjaus-URI ei täsmää: varmista, että Databricksin uudelleenohjaus-URL vastaa täsmälleen ChatGPT:ssä näkyvää callback-URL-osoitetta, mukaan lukien polku ja callback-tunnus.
Salaisuus puuttuu: Databricks-salaisuudet näytetään vain kerran. Luo uusi asiakassalaisuus, jos sitä ei kopioitu.
OAuth-sovellus ei ole heti käytettävissä: Databricksin mukaan OAuth-sovelluspäivitysten käsittely voi kestää jopa 30 minuuttia.
Riittämätön käyttöalue: jos ChatGPT voi todentaa mutta Databricks API -kutsut epäonnistuvat, varmista, että Databricks-sovelluksella on ALL APIs, kun sovellus tarvitsee muita kuin SQL API -rajapintoja.
SQL-toiminnot epäonnistuvat: varmista SQL-käyttöalue, warehouse-määritys ja Databricksin käyttöoikeudet.
Väärä työtila: luo ja julkaise sovellus samassa ChatGPT-työtilassa, jossa käyttäjät yhdistävät sen.
Käyttäjät eivät voi yhdistää: varmista, että käyttäjällä on Databricks-käyttöoikeus ja oikeus valtuuttaa OAuth-sovellus.