Käytä tätä opasta, jos olet ChatGPT-työtilan järjestelmänvalvoja tai ChatGPT Plus- tai ChatGPT Pro -käyttäjä ja määrität Databricks Genie -yhdistintä organisaatiosi Databricks OAuth -asiakasohjelmalla.
Databricksin määritykset tehdään pääosin Databricks-tilikonsolissa. Luo mukautettu OAuth-sovellusyhteys, rekisteröi ChatGPT:n takaisinkutsu-URL, kopioi luodut asiakasohjelman tunnistetiedot ja syötä arvot ChatGPT-yhdistimen määrityksissä.
Mitä olet määrittämässä
Olet luomassa Databricks-sovellusyhteyttä ChatGPT-tilillesi tai -työtilallesi. Yhteys käyttää seuraavia tietoja:
Databricks-tilikonsolissa luotu Databricks OAuth -sovellusyhteys.
Databricks OAuth -asiakasohjelman tunnus ja salaisuus.
ChatGPT:stä tarkalleen kopioitu takaisinkutsu-URL.
Databricks-käyttöalueet, jotka vastaavat käyttöön otettavia yhdistimen ominaisuuksia.
ChatGPT:n määrityksissä pyydettävät Databricks-palveluntarjoajan tiedot, kuten työtilan isäntä, tilin isäntä, tilitunnus tai varasto.
Ennen aloittamista
Tarvitset seuraavat:
ChatGPT-työtilan järjestelmänvalvojan tai omistajan käyttöoikeudet tai ChatGPT Plus- tai ChatGPT Pro -tili.
Databricks-tilin järjestelmänvalvojan käyttöoikeudet. Työtilan järjestelmänvalvojan käyttöoikeudet saattavat riittää joihinkin tehtäviin, mutta mukautetut sovellusyhteydet määritetään Databricks-tilikonsolissa.
Databricks-tilikonsoli avattuna erilliseen välilehteen.
Databricks Genie -yhteysnäkymä avattuna ChatGPT:ssä, jotta voit kopioida takaisinkutsu-URL:n tarkalleen.
Päätös siitä, tarvitseeko sovellus yleisen Databricks API -käyttöoikeuden vai vain Databricks SQL -käyttöoikeuden.
Turvallinen paikka Databricks-asiakasohjelman salaisuuden käsittelyyn.
Jos Databricks-tilisi tai -työtilasi rajoittaa käyttöä IP-käyttöluettelolla, kontekstipohjaisella saapuvan liikenteen hallinnalla, palomuurilla tai muulla verkkokäytännöllä, tarvitset Databricks-järjestelmänvalvojan apua nykyisten ChatGPT-yhdistimen lähtevän liikenteen IP-alueiden sallimiseen.
Huomautus: kopioi täsmälleen ChatGPT:ssä näkyvä Takaisinkutsu-URL.
Valmisteltavat arvot
Takaisinkutsu-URL: kopioi tämä ChatGPT-yhdistimen määrityksistä.
Databricks OAuth -asiakasohjelman tunnus.
Databricks OAuth -asiakasohjelman salaisuus.
Databricks-käyttöalueet, kuten ALL APIs tai SQL.
ChatGPT:n määrityksissä pyydettävät Databricks-työtilan tai -tilin kentät.
Aloita sovelluksen määritys ChatGPT:ssä
Siirry ChatGPT:ssä tilille tai työtilaan, jossa sovelluksen tulee olla käytettävissä.
Siirry työtilan järjestelmänvalvojana tai omistajana kohtaan Työtilan asetukset > Laajennukset.
Valitse Hakemistosta Databricks Genie.
Valitse Lisää sovellusyhteys.
Etsi OAuth-asiakasohjelman osio Yhdistä Databricks Genie -valintaikkunasta.
ChatGPT:n Takaisinkutsu-URL. Pidä tämä valintaikkuna avoinna.
Esimerkki takaisinkutsu-URL:stä:
https://chatgpt.com/connector/oauth/<callback_id>
Älä poista takaisinkutsutunnusta, lisää loppuun vinoviivaa tai korvaa URL-osoitetta yleisellä ChatGPT-URL-osoitteella. Databricksiin rekisteröidyn URL-osoitteen on vastattava täsmälleen ChatGPT:ssä näkyvää Takaisinkutsu-URL-osoitetta.
Luo OAuth-sovellusyhteys Databricksissä
Avaa Databricks-tilisi Databricks-tilikonsoli.
Avaa vasemmasta sivupalkista Asetukset.
Avaa Sovellusyhteydet-välilehti.
Valitse Lisää yhteys.
Anna sovellukselle nimi, kuten ChatGPT Databricks Connector.
Liitä ChatGPT:stä tarkalleen kopioitu takaisinkutsu-URL kohtaan Uudelleenohjaus-URL-osoitteet.
Valitse sovelluksen tarvitsemat käyttöalueet kohdasta Käyttöalueet.
Käytä ALL APIs -vaihtoehtoa yleisessä Databricks-sovelluksessa, joka tarvitsee muitakin Databricks API -rajapintoja kuin SQL:n.
Käytä vain SQL-vaihtoehtoa sovelluksessa, joka on rajattu Databricks SQL -rajapintoihin.
Varmista, että kaikki myöhemmin ChatGPT:ssä lueteltavat käyttöalueet on otettu käyttöön tässä Databricks OAuth -sovelluksessa. Databricks sallii käyttöliittymässä luoduille sovelluksille automaattisesti käyttöalueet openid, email, profile ja offline_access.
Säilytä tokenien elinajat Databricksin oletusarvoissa, ellei organisaatiollasi ole erillistä käytäntöä: käyttöoikeustokenille 60 minuuttia ja päivitystokenille 10 080 minuuttia.
Ota Luo asiakasohjelman salaisuus käyttöön. ChatGPT tarvitsee tätä työnkulkua varten luottamuksellisen OAuth-asiakasohjelman.
Luo yhteys.
Kopioi tunnistetiedot Databricksistä
Kopioi Yhteys luotu -valintaikkunasta Asiakasohjelman tunnus.
Kopioi Asiakasohjelman salaisuus heti ja säilytä se turvallisesti.
Jos suljet valintaikkunan ennen salaisuuden kopioimista, luo tai vaihda 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 määritys ChatGPT:ssä
Palaa Yhdistä Databricks Genie -valintaikkunaan.
Syötä Databricks-asiakasohjelman tunnus OAuth-asiakasohjelman tunnus -kenttään.
Syötä Databricks-asiakasohjelman salaisuus OAuth-asiakasohjelman salaisuus -kenttään.
Säilytä yleistä API-käyttöä varten arvot all-apis ja offline_access kohdassa Käyttöalueet (valinnainen).
Syötä yksi käyttöalue kullekin riville tai erota käyttöalueet pilkuilla. Jokainen ChatGPT:ssä lueteltu käyttöalue on otettava käyttöön Databricks OAuth -sovelluksessa.
Syötä Työtilan isäntänimi (pakollinen) ilman https://-etuliitettä tai URL-polkua. Täytä muut määrityksissä näkyvät pakolliset Databricks-palveluntarjoajan kentät.
Valitse Jatka.
ChatGPT pyytää täsmälleen kohdassa Käyttöalueet (valinnainen) annettuja käyttöalueita. Se ei lisää automaattisesti laajempia mallipohjan käyttöalueita.
Yhdistä ja testaa
Tarkista yhdistimen tiedot, toiminnot ja todennusasetukset.
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ä.
Aloita yhdistäminen ChatGPT:stä sallittuna testikäyttäjänä ja kirjaudu sitten Databricksiin.
Varmista, että selaimeen avautuu oikea Databricks-tili tai -työtila.
Tarkista pyydetyt käyttöalueet ja valitse sitten Valtuuta.
Varmista, että selain palaa ChatGPT:hen ja yhdistin näkyy yhdistettynä.
Suorita ensin vähäriskinen lukutoiminto, kuten nykyisen käyttäjän tietojen haku 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.
Jos määrität työtilaa, pyydä sallittua työtilan jäsentä, joka ei ole järjestelmänvalvoja, muodostamaan yhteys ja toistamaan vähäriskinen testi.
Hallitse käyttöoikeuksia
Sekä Databricks että ChatGPT osallistuvat käyttöoikeuksien hallintaan.
ChatGPT:ssä työtilan järjestelmänvalvojat hallitsevat sovelluksen saatavuutta ja sitä, miten jäsenet voivat käyttää sitä. Tarkista Databricks-sovellusten järjestelmänvalvojan hallintatoiminnot (Työtilan asetukset > Sovellukset) seuraavien osalta:
Käyttäjien käyttöoikeudet: määritä, mitkä työtilaroolit voivat käyttää yhdistintä.
Toimintojen hallinta: määritä, mitkä Databricks-toiminnot ovat käytössä.
Sovelluksen käyttöoikeudet: määritä, milloin ChatGPT pyytää jäseniltä luvan ennen yhdistimen käyttöä.
Nämä sovelluksen käyttöoikeudet koskevat ChatGPT-keskusteluja. Työtilan agentit määrittävät agentin rakentajan asettamilla agenttikohtaisilla hallintatoiminnoilla, mitkä sovellustoiminnot ovat käytettävissä ja milloin loppukäyttäjiltä pyydetään niiden hyväksyntää. Lisätietoja agenttien toiminnasta: ChatGPT:n työtila-agentit Enterprise- ja Business-versioissa.
Databricksissä järjestelmänvalvojat hallitsevat, ketkä käyttäjät voivat valtuuttaa OAuth-sovelluksen ja mihin Databricks-resursseihin heillä on käyttöoikeus. Palveluntarjoajan käyttöoikeudet ovat voimassa myös sen jälkeen, kun sovellus on otettu käyttöön ChatGPT:ssä.
Databricks-yhdistimen määritysongelmien vianmääritys
Uudelleenohjaus-URI ei täsmää: varmista, että Databricksin Uudelleenohjaus-URL-osoitteet-arvo vastaa täsmälleen ChatGPT:ssä näkyvää Takaisinkutsu-URL-osoitetta, mukaan lukien sen polku ja takaisinkutsutunnus. Älä poista takaisinkutsutunnusta, lisää loppuun vinoviivaa tai käytä toista ChatGPT:n uudelleenohjaus-URL-osoitetta.
Salaisuus puuttuu: 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.
Riittämätön tai virheellinen käyttöalue: vertaa ChatGPT:n Käyttöalueet (valinnainen) -kohtaa Databricks OAuth -sovelluksen Käyttöalueet-kohtaan. Jokaisen ChatGPT:n pyytämän käyttöalueen on oltava siellä käytössä. Varmista muiden kuin SQL-rajapintojen osalta, että all-apis on käytössä Databricksissä ja säilyy ChatGPT:n käyttöalueluettelossa.
SQL-toiminnot epäonnistuvat: tarkista SQL-käyttöalue, varaston määritykset ja Databricks-käyttöoikeudet.
Väärä ChatGPT-työtila: luo ja ota yhdistin 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) -arvo, toista kirjautuminen 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 myös, että käyttäjän ChatGPT:n Käyttäjien käyttöoikeudet sallivat yhdistimen käytön.
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öluettelot, kontekstipohjaiset saapuvan liikenteen hallintatoiminnot, palomuuri tai muut asiakkaan hallitsemat verkkosäännöt.
Salli saapuvat yhteydet nykyisiltä ChatGPT-yhdistimen lähtevän liikenteen IP-alueilta.
Määritä tämä sallittujen luettelo Databricksissä tai asiakkaan hallitsemassa verkkokerroksessa. Se on erillinen ChatGPT-työtilan sallittujen IP-osoitteiden luettelosta.
Julkaistut alueet voivat muuttua. Automatisoi päivitykset JSON-tiedostosta aina kun mahdollista.
Älä vaihda asiakasohjelman salaisuutta tai muuta OAuth-käyttöalueita verkkorajoituksen kiertämiseksi. Varmista ensin, hylkääkö Databricks yhdistimen lähde-IP-osoitteet.