Databricksi rakenduse malli seadistamine ChatGPT-s

Kasuta seda juhendit, kui oled ChatGPT tööjaama administraator või ChatGPT Plusi või Pro kasutaja ja seadistad Databricks Genie rakendust sisseehitatud OAutendi või oma organisatsiooni OAutendi kliendiga.

• Sisseehitatud OAutent: kui see on ChatGPT-s saadaval ja sinu Databricksi tööruumis lubatud, kasuta eelkonfigureeritud ühendust. Sa ei pea looma OAutendi rakendust ega sisestama kliendi ID-d või kliendisaladust. Järgi allpool jaotise „Sisseehitatud OAutent“ juhiseid.

• Kohandatud OAutendi klient: kasuta seda võimalust, kui sisseehitatud OAutent pole saadaval või sinu organisatsioon nõuab oma OAutendi klienti. Järgi allpool jaotise „Kohandatud OAutendi klient“ juhiseid.

Mida sa seadistad

Lood oma ChatGPT konto või tööjaama jaoks Databricksi rakenduse ühenduse. Mõlema võimaluse puhul on vaja ChatGPT-s küsitavaid Databricksi teenusepakkuja andmeid ja õigusi ressurssidele, mida kavatsed kasutada. Kui kasutad kohandatud OAutendi klienti, valmista ette ka järgmine:

• Databricksi kontohalduskonsoolis loodud Databricksi OAutendi rakenduse ühendus.

• Databricksi OAutendi kliendi ID ja kliendisaladus.

• ChatGPT-st kopeeritud täpne tagasikutse URL.

• Databricksi ulatused, mis vastavad rakenduse funktsioonidele, mida soovid lubada.

• Kõik ChatGPT seadistamisel küsitavad Databricksi teenusepakkuja andmed, näiteks tööruumi host, konto host, konto ID või andmeladu.

Enne alustamist

Tööjaama jaoks seadistamiseks ava halduskonsool, vali soovitud ChatGPT tööjaam ja ava jaotis „Pistikprogrammid“. Vali „Halda pärandrakendusi“, et avada alles jäetud rakenduste leht. Tööjaamas navigeerimise ja pärandrakendustele juurdepääsu kohta vaata artiklit Pistikprogrammide ja rakenduste haldusseaded, turvalisus ning nõuetele vastavus.

Sul on vaja järgmist:

• ChatGPT tööjaama administraatori või omaniku õigused või ChatGPT Plusi või Pro konto.

• Kohandatud OAutendi kliendi puhul Databricksi konto administraatori õigused. Mõne ülesande jaoks võivad piisata tööruumi administraatori õigused, kuid kohandatud rakenduste ühendusi seadistatakse Databricksi kontohalduskonsoolis. Sisseehitatud OAutendi puhul peab Databricksi administraator kontrollima, et ChatGPT rakendus oleks sinu tööruumis saadaval ja lubatud.

• Kohandatud OAutendi kliendi puhul eraldi vahekaardil avatud Databricksi kontohalduskonsool.

• Kohandatud OAutendi kliendi puhul ChatGPT-s avatud Databricks Genie ühendamise kuva, et saaksid kopeerida täpse tagasikutse URL-i.

• Otsus selle kohta, milliseid funktsioone rakendus vajab: Genie ja AI/BI töölauad, laiem juurdepääs Databricksi API-dele või piirdumine Databricksi SQL-i API-dega. Ainult SQL-i juurdepääsust ei piisa Genie ega töölaudade toiminguteks.

• Kohandatud OAutendi kliendi puhul turvaline koht Databricksi kliendisaladuse käsitlemiseks.

• Kui sinu Databricksi konto või tööruum piirab juurdepääsu IP-pääsuloendi, kontekstipõhise sisendliikluse piirangu, tulemüüri või muu võrgupoliitika abil, vajad Databricksi administraatori abi, kes saab lubada kehtivad ChatGPT rakenduste väljundliikluse IP-vahemikud.

Kohandatud OAutendi kliendi puhul kopeeri ChatGPT-s kuvatud täpne tagasikutse URL.

Ettevalmistatavad väärtused

• Kohandatud OAutendi kliendi puhul tagasikutse URL: kopeeri see ChatGPT rakenduse seadistuskuvalt.

• Kohandatud OAutendi kliendi puhul Databricksi OAutendi kliendi ID.

• Kohandatud OAutendi kliendi puhul Databricksi OAutendi kliendisaladus.

• Kohandatud OAutendi kliendi puhul rakenduse funktsioonidele vastavad Databricksi juurdepääsuulatused. Kui uue Genie või töölaua ühenduse puhul kuvatakse ai-gateway, dashboards ja offline_access, valmista ette need ulatused. KÕIK API-d (all-apis koos ulatusega offline_access) on endiselt vanem ja laiem alternatiiv. Kasuta ulatust SQL ainult rakenduse puhul, mis piirdub Databricksi SQL-i API-dega.

• Databricksi tööruumi või konto andmed, mida ChatGPT seadistamisel küsitakse.

Sisseehitatud OAutent

Esmalt täida eespool kirjeldatud eeltingimused. Kasuta seda võimalust ainult siis, kui sisseehitatud OAutent on ChatGPT-s saadaval ja sinu Databricksi tööjaamas lubatud.

1. Palu Databricksi administraatoril kontrollida, kas ChatGPT rakendus on kontohalduskonsooli rakenduste integreerimise seadetes saadaval ja sinu tööjaamas lubatud. Kui ChatGPT rakendust sinu Databricksi kontohalduskonsoolis pole, võta ühendust oma Databricksi kliendihalduriga ja küsi, kas see funktsioon on sinu kontol saadaval.

2. Lülitu ChatGPT-s kontole või tööjaama, kus rakendus peaks olema saadaval. Isiklikuks seadistuseks ava Seaded > Pistikprogrammid. Tööjaama seadistamiseks ava tööjaama administraatori või omanikuna Halduskonsool > Pistikprogrammid.

3. Vali Databricks Genie ja seejärel Lisa rakenduse ühendus.

4. Sisesta Tööjaama hostinimi (nõutav) ilma eesliite https:// ja URL-i teeta.

   ChatGPT tuletab selle hostinime põhjal tööjaamasisese Genie MCP lõpp-punkti https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Eraldi piirkondlikku MCP lõpp-punkti pole vaja.

5. Vali Jätka, seejärel logi Databricksi sisse ja vaata nõusolekutaotlus üle.

Jätka allolevate jaotiste „Ühenda ja testi“ ning „Halda juurdepääsu“ juhistega, sealhulgas lubatud liikmete testide ja tööjaama juurdepääsu kontrollidega.

Kohandatud OAutendi klient

Täida esmalt eespool loetletud eeltingimused. Kasuta seda võimalust, kui sisseehitatud OAutent pole saadaval või sinu organisatsioon nõuab oma OAutendi klienti. Pärast seadistamist järgi allpool jaotiste „Ühenda ja testi“ ning „Halda juurdepääsu“ juhiseid.

Alusta kohandatud OAutendi seadistamist ChatGPT-s

1. Lülitu ChatGPT-s kontole või tööjaama, kus rakendus peaks olema saadaval.

2. Isiklikuks seadistuseks ava Seaded > Pistikprogrammid. Tööjaama seadistamiseks ava tööjaama administraatori või omanikuna Halduskonsool > Pistikprogrammid.

3. Vali jaotises Kataloog rakendus Databricks Genie.

4. Vali Lisa rakenduse ühendus.

5. Leia dialoogiaknast Ühenda Databricks Genie väljad OAutendi kliendi ID ja OAutendi kliendisaladus. Identimisteabe sisestamine nendele nähtavatele väljadele käivitab kohandatud kliendi seadistamise; eraldi valikut pole vaja teha.

6. Kopeeri ChatGPT-st Tagasikutse URL. Jäta see dialoogiaken avatuks.

Tagasikutse URL-i näide:

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

Ära eemalda tagasikutse ID-d, lisa lõppu kaldkriipsu ega asenda URL-i üldise ChatGPT URL-iga. Databricksis registreeritud URL peab täpselt vastama ChatGPT-s kuvatud väljale Tagasikutse URL.

Loo Databricksis kohandatud OAutendi rakenduse ühendus

1. Ava oma Databricksi konto kontohalduskonsool.

2. Ava vasakul külgribal Seaded.

3. Ava vahekaart Rakenduste ühendused.

4. Vali Lisa ühendus.

   

5. Sisesta rakenduse nimi, näiteks ChatGPT Databricks.

6. Kleebi väljale Ümbersuunamise URL-id ChatGPT-st kopeeritud täpne tagasikutse URL.

7. Vali jaotises Juurdepääsuulatused rakendusele vajalikud ulatused.

8. Kui uue Genie või töölaua ühenduse puhul kuvatakse ChatGPT-s ai-gateway, dashboards ja offline_access, luba samad ulatused ka Databricksi OAutendi rakenduses.

9. KÕIK API-d on endiselt vanem ja laiem alternatiiv üldiseks juurdepääsuks Databricksi API-dele. Selle konfiguratsiooni puhul kasuta ChatGPT-s ulatusi all-apis ja offline_access ning veendu, et Databricksi OAutendi rakendus lubaks mõlemat. Uue Genie või töölaua ühenduse puhul eelista kuvatavaid täpsemaid ulatusi.

10. Kasuta ulatust SQL ainult rakenduse puhul, mis piirdub Databricksi SQL-i API-dega. Ainult SQL-i juurdepääsust ei piisa Genie ega töölaudade toiminguteks.

11. Veendu, et kõik hiljem ChatGPT-s loetletud ulatused oleksid selles Databricksi OAutendi rakenduses lubatud. Databricks lubab kasutajaliideses loodud rakendustele automaatselt ulatused openid, email, profile ja offline_access.

12. Jäta pääsmike kehtivusajaks (TTL) Databricksi vaikeväärtused, kui sinu organisatsioonil pole selle kohta eraldi reegleid: pääsupääsmikul 60 minutit ja värskenduspääsmikul 10080 minutit.

13. Lülita sisse Genereeri kliendisaladus. ChatGPT vajab selle ühendusviisi jaoks konfidentsiaalset OAutendi klienti.

14. Loo ühendus.

Kopeeri Databricksist identimisteave

1. Kopeeri dialoogis Ühendus loodud kuvatav kliendi ID.

2. Kopeeri kliendisaladus kohe ja salvesta see turvalisse kohta.

3. Kui sulged dialoogi enne saladuse kopeerimist, loo või uuenda OAutendi rakenduse identimisteavet ja kasuta uut saladust.

Databricks kuvab saladust ainult ühe korra. Käsitle seda nagu muud identimisteavet ning ära lisa seda kuvatõmmistele, tugipäringutesse, kommentaaridesse ega vestlustesse.

Lõpeta kohandatud OAutendi seadistamine ChatGPT-s

1. Naase dialoogiaknasse Ühenda Databricks Genie.

2. Sisesta Databricksi kliendi ID väljale OAutendi kliendi ID.

3. Sisesta Databricksi kliendisaladus väljale OAutendi kliendisaladus.

   Nende identimisteabe andmete sisestamisel võetakse kasutusele sinu kohandatud OAutendi klient; eraldi valikut pole vaja teha.

4. Sisesta väljale Ulatused (valikuline) juurdepääsuulatused, mida sinu rakenduse Databricksi lõpp-punkt ja funktsioonid vajavad. Need peavad vastama Databricksi OAutendi rakenduses lubatud ulatustele.

   Uue Genie või töölaua ühenduse puhul, kus kuvatakse ai-gateway, dashboards ja offline_access, jäta need ulatused alles. Veendu, et Databricksi OAutendi rakendus lubaks samu ulatusi. ai-gateway võimaldab tööjaamasisest Genie MCP ühendust, dashboards AI/BI töölaua toiminguid ja offline_access värskendustõendite kasutamist.

   Vanem ja laiema juurdepääsuga variant all-apis koos ulatusega offline_access on endiselt toetatud laiema API-juurdepääsu jaoks, kuid pole selle Genie või töölaua ühenduse puhul eelistatud. Kui Databricksi rakendus lubab ainult ulatust all-apis, värskenda seda või loo see uuesti, et lubada ai-gateway, dashboards ja offline_access. Kui täpsemad ulatused pole saadaval, määra ChatGPT-s teadlikult ulatusteks all-apis ja offline_access ning veendu, et Databricksi rakendus lubaks mõlemat. Ära taotle ChatGPT-s kolme täpsemat ulatust, kui Databricksi rakendus lubab ainult ulatust all-apis.

5. Sisesta iga ulatus eraldi reale või eralda ulatused komadega. Kõik ChatGPT-s loetletud ulatused peavad olema Databricksi OAutendi rakenduses lubatud.

6. Sisesta Tööjaama hostinimi (nõutav) ilma eesliite https:// ja URL-i teeta. Täida ka kõik muud seadistamisel kuvatavad Databricksi teenusepakkuja nõutavad väljad.

   ChatGPT tuletab selle hostinime põhjal tööjaamasisese Genie MCP lõpp-punkti https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Eraldi piirkondlikku MCP lõpp-punkti pole vaja.

7. Vali Jätka.

ChatGPT taotleb täpselt neid ulatusi, mis on sisestatud väljale Ulatused (valikuline). See ei lisa automaatselt malli laiemaid ulatusi.

Ühenda ja testi

Tee järgmised ühendustestid ja juurdepääsukontrollid olenemata sellest, kumba OAutendi võimalust kasutad.

1. Vaata üle rakenduse üksikasjad, toimingud ja autentimisseaded.

2. Kui oled tööjaama administraator, luba rakendus tööjaamas ja määra tööjaama poliitika järgi, kes seda kasutada saab.

3. Alusta ChatGPT-s ühendamist lubatud testkasutajana ja logi seejärel Databricksi sisse.

4. Veendu, et brauser avaks õige Databricksi konto või tööruumi.

5. Vaata taotletavad ulatused üle ja vali seejärel Autoriseeri.

   

6. Kontrolli, et brauser naaseks ChatGPT-sse ja rakendus oleks märgitud ühendatuks.

7. Käivita väikese riskiga lugemistoiming, mis vastab ühenduse funktsioonidele. Genie ühenduse puhul saada Geniele päring andmete kohta, millele testkasutajal on juurdepääsuõigus. Muude toetatud funktsioonide puhul too praeguse kasutaja andmed või tee päring heakskiidetud Databricksi SQL-i ressursile. Veendu, et kasutajal oleksid vajalikud õigused Databricksi ressurssidele; üksnes OAutendi ulatused ei anna andmetele juurdepääsu.

8. Kui kirjutamistoimingud on lubatud, testi enne laiemat kasutuselevõttu kindlasti väikese riskiga Databricksi töövoogu.

9. Tööjaama jaoks seadistamisel palu mõnel lubatud tööjaamaliikmel, kes pole administraator, ühendus luua ja väikese riskiga testi korrata.

Halda juurdepääsu

Juurdepääsu kontrollitakse nii Databricksis kui ka ChatGPT-s.

ChatGPT-s määravad tööjaama administraatorid, kas rakendus on saadaval ja kuidas liikmed seda kasutada saavad. Businessi puhul määravad administraatorid, kas rakendus on lubatud kogu tööjaamas. Vaata üle Databricksi rakenduste haldusseaded (Tööjaama seaded > Rakendused või Halduskonsool > Pistikprogrammid > Halda pärandrakendusi):

• Kasutajate juurdepääs – määra, millised tööjaamarollid saavad rakendust toetatud Enterprise’i ja Edu tööjaamades kasutada.

• Toimingute haldus – määra, millised Databricksi toimingud on lubatud.

• Rakenduse õigused – määra, millal ChatGPT küsib liikmetelt enne rakenduse kasutamist luba.

Need rakenduse õigused kehtivad ChatGPT vestlustes. Tööjaama agendid lähtuvad iga agendi looja määratud seadetest, mis määravad, millised rakenduse toimingud on saadaval ja millal küsitakse lõppkasutajatelt nende heakskiitu. Agentide käitumise kohta vaata artiklit ChatGPT tööjaama agendid Enterprise’i ja Businessi jaoks.

Databricksis määravad administraatorid, millised kasutajad saavad OAutendi rakendust autoriseerida ja millistele Databricksi ressurssidele neil kasutajatel on juurdepääs. Teenusepakkuja õigused kehtivad ka pärast rakenduse lubamist ChatGPT-s.

Tööjaamas navigeerimise, rakendustele juurdepääsu ja paketipõhiste rakenduse haldusseadete kohta vaata artiklit Rakenduste haldusseaded, turvalisus ja nõuetele vastavus.

Databricksi rakenduse seadistamise tõrkeotsing

• Ümbersuunamise URI ei ühti: kui kasutad kohandatud OAutendi klienti, veendu, et Databricksi välja Ümbersuunamise URL-id väärtus ühtiks täpselt ChatGPT-s kuvatud tagasikutse URL-iga, sealhulgas selle tee ja tagasikutse ID-ga. Ära eemalda tagasikutse ID-d, lisa lõppu kaldkriipsu ega asenda URL-i mõne muu ChatGPT ümbersuunamise URL-iga.

• Saladus puudub: kohandatud OAutendi kliendi kasutamisel arvesta, et Databricks kuvab saladusi ainult ühe korra. Kui kliendisaladus jäi kopeerimata, genereeri uus.

• OAutendi rakendus pole kohe saadaval: Databricksi sõnul võib OAutendi rakenduse uuenduste töötlemine võtta kuni 30 minutit.

• Ebapiisav või sobimatu juurdepääsuulatus: kui kasutad kohandatud OAutendi klienti, võrdle ChatGPT välja Ulatused (valikuline) Databricksi OAutendi rakenduse väljaga Juurdepääsuulatused. Kõik ChatGPT taotletavad ulatused peavad seal olema lubatud. Veendu, et ulatused toetaksid sinu kasutatavat lõpp-punkti ja funktsioone.

  Kui uue Genie või töölaua ühenduse puhul kuvatakse ai-gateway, dashboards ja offline_access, jäta need ulatused ChatGPT-s alles ning veendu, et Databricksi rakendus lubaks kõiki kolme. Kui rakendus lubab ainult ulatust all-apis, uuenda seda või loo see uuesti, et lubada kolm täpsemat ulatust.

  Kui täpsemad ulatused pole saadaval, kasuta toetatud laiemat alternatiivi: määra ChatGPT-s ulatusteks all-apis ja offline_access ning veendu, et Databricksi rakendus lubaks mõlemat. Rakendus, mis lubab ainult ulatust all-apis, ei vasta ChatGPT taotlusele ulatuste ai-gateway, dashboards ja offline_access kasutamiseks. Ainult SQL-i juurdepääs sobib vaid Databricksi SQL-i API-dega piirduvale rakendusele; sellest ei piisa Genie ega töölaudade toiminguteks.

• SQL-i toimingud nurjuvad: kui rakendus piirdub Databricksi SQL-i API-dega, kontrolli ulatust SQL, andmelao konfiguratsiooni ja Databricksi õigusi.

• Vale ChatGPT tööjaam: loo ja luba rakendus samas ChatGPT tööjaamas, kus kasutajad selle ühendavad.

• Vale Databricksi konto või tööruum: kontrolli välja Tööruumi hostinimi (nõutav) väärtust, seejärel logi uuesti sisse ja veendu, et Databricks avaks õige konto või tööruumi.

• Kasutajad ei saa ühendust luua: veendu, et kasutajal oleks juurdepääs Databricksile ja õigus OAutendi rakendust autoriseerida. Businessi puhul veendu, et rakendus oleks lubatud kogu tööjaamas. Toetatud Enterprise’i ja Edu tööjaamades veendu ka, et ChatGPT säte Kasutajate juurdepääs lubaks rakendust kasutada.

• Databricksi võrgupoliitika blokeerib rakenduse: kui Databricks lubab ainult kindlaid lähte-IP-aadresse, peab Databricksi administraator uuendama vastava konto või tööruumi IP-pääsuloendeid, kontekstipõhiseid sisendliikluse piiranguid, tulemüüri või muid kliendi hallatavaid võrgureegleid.

  • Luba sissetulevad ühendused kehtivatest ChatGPT rakenduste väljundliikluse IP-vahemikest.

  • Seadista need lubatud vahemikud Databricksis või kliendi hallatavas võrgukihis. See on eraldi ChatGPT tööjaama lubatud IP-aadresside loendist.

  • Avaldatud vahemikud võivad muutuda. Võimaluse korral automatiseeri uuendamine JSON-i alusel.

  • Ära vaheta kliendisaladust ega muuda OAutendi ulatusi võrgublokeeringust möödahiilimiseks. Kontrolli esmalt, kas Databricks lükkab rakenduse lähte-IP-aadressid tagasi.

Viited

• Databricksi dokumentatsioon: autentimine kasutaja ja masina vahelise OAutendiga

• Databricksi dokumentatsioon: OAutendi rakenduse ühenduste haldamine

• Databricksi dokumentatsioon: IP-pääsuloendite haldamine