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 konnektorit 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 kontole või tööjaamale Databricksi rakenduse ühenduse. Mõlema võimaluse puhul on vaja ChatGPT-s küsitud Databricksi teenusepakkuja andmeid ja õigusi ressurssidele, mida kavatsed kasutada. Kui kasutad kohandatud OAutendi klienti, pane valmis ka:

• Databricksi kontohalduskonsoolis loodud Databricksi OAutendi rakenduse ühendus.

• Databricksi OAutendi kliendi ID ja kliendisaladus.

• ChatGPT-st kopeeritud täpne tagasikutse URL.

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

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

Enne alustamist

Tööjaama 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 leiad teavet artiklist Pistikprogrammide ja rakenduste haldusfunktsioonid, turvalisus ja nõuetele vastavus.

Sul on vaja järgmist:

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

• Kohandatud OAutendi kliendi puhul Databricksi konto administraatori õigused. Mõne ülesande jaoks võib piisata tööjaama administraatori õigustest, kuid kohandatud rakenduseühendusi seadistatakse Databricksi kontohalduskonsoolis. Sisseehitatud OAutendi puhul peab Databricksi administraator kontrollima, kas ChatGPT rakendus on sinu tööjaamas saadaval ja lubatud.

• Kohandatud OAutendi kliendi puhul eraldi vahekaardil avatud Databricksi kontohalduskonsool.

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

• Otsus, milliseid funktsioone rakendus vajab: Genie ja AI/BI töölauad, laiem juurdepääs Databricksi API-dele või ainult Databricks SQL-i API-de kasutamine. Ainult SQL-juurdepääsust ei piisa Genie või töölaua toiminguteks.

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

• Kui sinu Databricksi konto või tööjaam piirab juurdepääsu IP-pääsuloendi, kontekstipõhise sissetuleva liikluse pääsureegli, tulemüüri või muu võrgupoliitikaga, on vaja abi Databricksi administraatorilt, kes saab lubada kehtivad ChatGPT konnektorite väljuva liikluse IP-vahemikud.

Kohandatud OAutendi kliendi puhul kopeeri täpselt ChatGPT-s kuvatud Tagasikutse URL.

Ettevalmistatavad väärtused

• Kohandatud OAutendi kliendi puhul Tagasikutse URL: kopeeri see ChatGPT konnektori 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. Uue Genie või töölaua ühenduse puhul, kus kuvatakse ai-gateway, dashboards ja offline_access, valmista ette need ulatused. Kõik API-d (all-apis koos ulatusega offline_access) jääb vanemaks ja laiema juurdepääsuga variandiks. Kasuta ulatust SQL ainult rakenduse puhul, mis kasutab vaid Databricks SQL-i API-sid.

• Databricksi tööjaama või konto väljade väärtused, 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 Databricksi konnektor.

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

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

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

9. Kõik API-d jääb vanemaks ja laiema juurdepääsuga variandiks üldise Databricksi API-juurdepääsu jaoks. Selle seadistuse 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 kuvatud täpsemaid ulatusi.

10. Kasuta ulatust SQL ainult rakenduse puhul, mis kasutab vaid Databricks SQL-i API-sid. Ainult SQL-juurdepääsust ei piisa Genie või töölaua 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. Kui sinu organisatsioonil pole eraldi poliitikat, jäta tõendite kehtivusajaks Databricksi vaikeväärtused: pääsutõendi puhul 60 minutit ja värskendustõendi puhul 10080 minutit.

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

14. Loo ühendus.

Kopeeri identimisteave Databricksist

1. Kopeeri dialoogiaknas Ühendus loodud välja Kliendi ID väärtus.

2. Kopeeri kohe välja Kliendisaladus väärtus ja salvesta see turvaliselt.

3. Kui sulged dialoogiakna enne kliendisaladuse kopeerimist, loo või vaheta OAutendi rakenduse identimisteave ja kasuta uut kliendisaladust.

Databricks kuvab kliendisaladuse ainult üks kord. Käsitle seda identimisteabena ning ära lisa seda kuvatõmmistele, tugipiletitesse, 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 valitud OAutendi seadistusviisist.

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

2. Kui oled tööjaama administraator, luba konnektor 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ööjaama.

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

   

6. Veendu, et brauser naaseks ChatGPT-sse ja konnektor kuvataks ühendatuna.

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

8. Kui kirjutamistoimingud on lubatud, testi neid enne laiemat kasutuselevõttu Databricksi töövooga, mille risk on selgelt väike.

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

Halda juurdepääsu

Juurdepääsu reguleerivad nii Databricks kui ka ChatGPT.

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

• Kasutajate juurdepääs: määra, milliste tööjaamarollidega kasutajad saavad toetatud Enterprise’i ja Edu tööjaamades konnektorit kasutada.

• Toimingute juhtimine: määra, millised Databricksi toimingud on lubatud.

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

Need rakenduse õigused kehtivad ChatGPT vestlustes. Tööjaama agentide puhul määravad saadaolevad rakenduse toimingud ja lõppkasutajalt heakskiidu küsimise aja agendi looja seatud agendipõhised reeglid. Agentide käitumise kohta loe artiklist 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 liikumise, rakendustele juurdepääsu ja paketipõhiste rakenduse haldusseadete kohta loe artiklist Rakenduste haldusfunktsioonid, turvalisus ja vastavusnõuded.

Databricksi konnektori seadistamise tõrkeotsing

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

• Kliendisaladus puudub: kohandatud OAutendi kliendi kasutamisel arvesta, et Databricksi kliendisaladusi kuvatakse ainult üks kord. Kui kliendisaladus jäi kopeerimata, genereeri uus.

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

• Ebapiisav või sobimatu ulatus: 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 olema seal lubatud. Veendu, et ulatused toetaksid kasutatavat lõpp-punkti ja funktsioone.

  Uue Genie või töölaua ühenduse puhul, kus 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, värskenda seda või loo see uuesti, et lubada kolm täpsemat ulatust.

  Kui täpsemad ulatused pole saadaval, kasuta toetatud laiema juurdepääsuga varianti: 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 saada ulatused ai-gateway, dashboards ja offline_access. Ainult SQL-juurdepääs sobib üksnes rakendusele, mis kasutab vaid Databricks SQL-i API-sid; sellest ei piisa Genie või töölaua toiminguteks.

• SQL-toimingud nurjuvad: ainult Databricks SQL-i API-sid kasutava rakenduse puhul kontrolli ulatust SQL, andmelao konfiguratsiooni ja Databricksi õigusi.

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

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

• Kasutajad ei saa ühendust luua: veendu, et kasutajal oleks juurdepääs Databricksile ja õigus anda OAutendi rakendusele volitus. 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 konnektorit kasutada.

• Databricksi võrgupoliitika blokeerib konnektori: kui Databricks lubab ühendusi ainult kindlatelt lähte-IP-aadressidelt, peab Databricksi administraator värskendama vastava konto või tööjaama IP-pääsuloendeid, kontekstipõhiseid sissetuleva liikluse pääsureegleid, tulemüüri või muid kliendi hallatavaid võrgureegleid.

  • Luba sissetulevad ühendused kehtivatest ChatGPT konnektorite väljuva liikluse IP-vahemikest.

  • Seadista see lubatud aadresside loend 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 loendi värskendamine JSON-i põhjal.

  • Ära vaheta kliendisaladust ega muuda OAutendi ulatusi võrgublokeeringust möödahiilimiseks. Esmalt kontrolli, kas Databricks keeldub ühendustest konnektori lähte-IP-aadressidelt.

Viited

• Databricksi dokumentatsioon: autentimine kasutaja ja masina vahelise OAutendiga

• Databricksi dokumentatsioon: OAutendi rakenduse ühenduste haldamine

• Databricksi dokumentatsioon: IP-pääsuloendite haldamine