Setja upp Databricks-forritssniðmátið í ChatGPT

Kynntu þér hvernig stjórnendur ChatGPT-vinnusvæða og notendur ChatGPT Plus eða ChatGPT Pro geta tengt Databricks með OAuth-biðlara fyrirtækisins.

Þessar leiðbeiningar eru fyrir stjórnendur ChatGPT-vinnusvæða og notendur ChatGPT Plus eða Pro sem eru að setja upp Databricks Genie-forritið með innbyggðu OAuth eða OAuth-biðlara fyrirtækisins.

Innbyggt OAuth: Notaðu forstilltu tenginguna ef hún er í boði í ChatGPT og virkjuð fyrir Databricks-vinnusvæðið þitt. Þú þarft ekki að búa til OAuth-forrit eða slá inn auðkenni eða leynilykil biðlara. Fylgdu leiðbeiningunum í kaflanum Innbyggt OAuth hér að neðan.
Sérsniðinn OAuth-biðlari: Farðu þessa leið ef innbyggt OAuth er ekki í boði eða fyrirtækið þitt krefst þess að nota eigin OAuth-biðlara. Fylgdu leiðbeiningunum í kaflanum Sérsniðinn OAuth-biðlari hér að neðan.

Það sem þú ert að setja upp

Þú ert að búa til tengingu við Databricks-forrit fyrir ChatGPT-reikninginn þinn eða vinnusvæðið. Báðar leiðir krefjast þeirra tengiupplýsinga fyrir Databricks sem beðið er um í ChatGPT og heimilda fyrir tilföngunum sem þú ætlar að nota. Ef þú notar sérsniðinn OAuth-biðlara skaltu einnig hafa eftirfarandi tilbúið:

Tengingu við Databricks OAuth-forrit sem er búin til í reikningsstjórnborði Databricks.
Auðkenni og leynilykil Databricks OAuth-biðlarans.
Nákvæma endurkallsslóð, afritaða úr ChatGPT.
Databricks-aðgangssvið sem samsvara þeirri virkni forritsins sem þú vilt virkja.
Allar tengiupplýsingar fyrir Databricks sem beðið er um við uppsetningu í ChatGPT, svo sem hýsil vinnusvæðis, hýsil reiknings, reikningsauðkenni eða gagnavöruhús.

Áður en þú byrjar

Til að setja upp tengingu á vinnusvæði skaltu opna stjórnborðið, velja rétt ChatGPT-vinnusvæði og opna Viðbætur. Veldu Stjórna eldri forritum til að opna eldri forritasíðuna, sem er enn aðgengileg. Upplýsingar um að rata um vinnusvæðið og fá aðgang að eldri forritum er að finna í Stjórnandastillingar, öryggi og reglufylgni fyrir viðbætur og forrit.

Þú þarft:

Stjórnanda- eða eigandaaðgang að ChatGPT-vinnusvæði eða ChatGPT Plus- eða Pro-reikning.
Stjórnandaaðgang að Databricks-reikningi ef þú notar sérsniðinn OAuth-biðlara. Stjórnandaaðgangur að vinnusvæði getur dugað fyrir sum verkefni, en sérsniðnar forritatengingar eru stilltar í reikningsstjórnborði Databricks. Fyrir innbyggt OAuth þarf Databricks-stjórnandi að ganga úr skugga um að ChatGPT-forritið sé í boði og virkjað fyrir vinnusvæðið þitt.
Reikningsstjórnborð Databricks opið á sérstökum flipa ef þú notar sérsniðinn OAuth-biðlara.
Tengiskjá Databricks Genie opinn í ChatGPT ef þú notar sérsniðinn OAuth-biðlara, svo þú getir afritað nákvæma endurkallsslóð.
Að ákveða hvaða virkni forritið þarf: Genie og AI/BI-mælaborð, víðtækari aðgang að Databricks-forritaskilum eða takmörkun við Databricks SQL-forritaskil. Aðgangur eingöngu að SQL nægir ekki fyrir aðgerðir í Genie eða á mælaborðum.
Öruggan stað til að meðhöndla leynilykil Databricks-biðlarans ef þú notar sérsniðinn OAuth-biðlara.
Ef Databricks-reikningurinn þinn eða vinnusvæðið takmarkar aðgang með IP-aðgangslista, samhengisháðri stýringu á innkomandi tengingum, eldvegg eða öðrum netreglum þarftu aðstoð Databricks-stjórnanda sem getur leyft gildandi IP-tölubil fyrir útleiðandi tengingar ChatGPT-forrita.

Ef þú notar sérsniðinn OAuth-biðlara skaltu afrita nákvæmlega gildið í Endurkallsslóð sem birtist í ChatGPT.

Gildi sem þarf að hafa tilbúin

Fyrir sérsniðinn OAuth-biðlara, Endurkallsslóð: afritaðu hana úr uppsetningarferli forritsins í ChatGPT.
Auðkenni Databricks OAuth-biðlarans ef þú notar sérsniðinn OAuth-biðlara.
Leynilykill Databricks OAuth-biðlarans ef þú notar sérsniðinn OAuth-biðlara.
Databricks-aðgangssvið sem hæfa virkni forritsins ef þú notar sérsniðinn OAuth-biðlara. Fyrir nýja tengingu við Genie eða mælaborð sem sýnir ai-gateway, dashboards og offline_access skaltu undirbúa þessi aðgangssvið. ÖLL forritaskil (all-apis með offline_access) er áfram eldri, víðtækari valkosturinn. Notaðu SQL aðeins fyrir forrit sem er takmarkað við Databricks SQL-forritaskil.
Upplýsingar um Databricks-vinnusvæði eða -reikning sem beðið er um við uppsetningu í ChatGPT.

Innbyggt OAuth

Uppfylltu fyrst forsendurnar hér að ofan. Notaðu þessa leið aðeins ef innbyggt OAuth er tiltækt í ChatGPT og virkt fyrir Databricks-vinnusvæðið þitt.

Biddu Databricks-stjórnanda að athuga hvort ChatGPT-forritið sé tiltækt í stillingum fyrir samþættingu forrita í stjórnborði reikningsins og virkt fyrir vinnusvæðið þitt. Ef ChatGPT-forritið er ekki skráð í stjórnborði Databricks-reikningsins þíns skaltu hafa samband við viðskiptatengil þinn hjá Databricks og spyrja hvort eiginleikinn sé tiltækur fyrir reikninginn.
Í ChatGPT skaltu skipta yfir á reikninginn eða vinnusvæðið þar sem forritið á að vera tiltækt. Farðu í Stillingar > Viðbætur fyrir persónulega uppsetningu eða, sem stjórnandi eða eigandi vinnusvæðis, í Stjórnborð stjórnanda > Viðbætur til að setja upp fyrir vinnusvæði.
Veldu Databricks Genie og síðan Bæta við forritstengingu.
Sláðu inn Hýsilheiti vinnusvæðis (áskilið) án https:// eða slóðarhluta.
ChatGPT notar þetta hýsilheiti til að ákvarða Genie MCP-endapunktinn innan vinnusvæðisins, https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Ekki þarf sérstakan svæðisbundinn MCP-endapunkt.
Veldu Halda áfram, skráðu þig síðan inn í Databricks og farðu yfir beiðnina um samþykki.

Haltu áfram með kaflana Tengdu og prófaðu og Stjórnaðu aðgangi hér að neðan, þar á meðal prófanir með meðlimum sem hafa heimild og athuganir á aðgangi að vinnusvæðinu.

Sérsniðinn OAuth-biðlari

Uppfylltu fyrst forkröfurnar hér að ofan. Notaðu þessa leið ef innbyggt OAuth er ekki tiltækt eða fyrirtækið þitt krefst þess að nota eigin OAuth-biðlara. Að uppsetningu lokinni skaltu fylgja leiðbeiningunum í köflunum Tengja og prófa og Stjórna aðgangi hér að neðan.

Byrjaðu sérsniðna OAuth-uppsetningu í ChatGPT

Í ChatGPT skaltu skipta yfir á reikninginn eða vinnusvæðið þar sem forritið á að vera tiltækt.
Farðu í Stillingar > Viðbætur fyrir persónulega uppsetningu eða, sem stjórnandi eða eigandi vinnusvæðis, í Stjórnborð stjórnanda > Viðbætur til að setja upp fyrir vinnusvæði.
Veldu Databricks Genie í Forritaskrá.
Veldu Bæta við forritstengingu.
Finndu reitina Auðkenni OAuth-biðlara og Leynilykill OAuth-biðlara í glugganum Tengja Databricks Genie. Til að nota sérsniðinn biðlara slærðu aðgangsupplýsingar inn í þessa sýnilegu reiti; ekki þarf að velja hann sérstaklega.
Afritaðu Endurkallsslóð úr ChatGPT. Hafðu þennan glugga opinn.

ChatGPT Connect Databricks Genie dialog showing the callback URL field and OAuth client settings.

Dæmi um endurkallsslóð:

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

Ekki fjarlægja endurkallsauðkennið, bæta skástriki við endann eða skipta slóðinni út fyrir almenna ChatGPT-slóð. Slóðin sem er skráð í Databricks verður að samsvara nákvæmlega Endurkallsslóð sem birtist í ChatGPT.

Búa til sérsniðna OAuth-forritatengingu í Databricks

Opnaðu reikningsstjórnborð Databricks fyrir Databricks-reikninginn þinn.
Opnaðu Stillingar í hliðarstikunni vinstra megin.
Opnaðu flipann Forritatengingar.
Veldu Bæta við tengingu.
Sláðu inn heiti forrits, til dæmis ChatGPT Databricks.
Í Endurbeiningarslóðir skaltu líma nákvæma endurkallsslóð sem þú afritaðir úr ChatGPT.
Undir Aðgangssvið skaltu velja þau aðgangssvið sem forritið þarf.
Fyrir nýja tengingu við Genie eða mælaborð sem sýnir ai-gateway, dashboards og offline_access í ChatGPT skaltu heimila sömu aðgangssvið í Databricks OAuth-forritinu.
ÖLL forritaskil er áfram eldri, víðtækari valkosturinn fyrir almennan aðgang að Databricks-forritaskilum. Fyrir þessa uppsetningu skaltu nota all-apis og offline_access í ChatGPT og tryggja að Databricks OAuth-forritið heimili bæði. Veldu frekar afmörkuðu aðgangssviðin sem birtast fyrir nýja tengingu við Genie eða mælaborð.
Notaðu SQL aðeins fyrir forrit sem er takmarkað við Databricks SQL-forritaskil. Aðgangur eingöngu að SQL nægir ekki fyrir aðgerðir í Genie eða á mælaborðum.
Gakktu úr skugga um að öll aðgangssvið sem síðar eru skráð í ChatGPT séu virkjuð í þessu Databricks OAuth-forriti. Databricks heimilar sjálfkrafa openid, email, profile og offline_access fyrir forrit sem eru búin til í notendaviðmótinu.
Haltu sjálfgefnum gildistíma tákna í Databricks nema fyrirtækið þitt hafi sérstakar reglur: 60 mínútur fyrir aðgangstáknið og 10080 mínútur fyrir endurnýjunartáknið.
Kveiktu á Búa til leynilykil biðlara. ChatGPT þarf OAuth-biðlara sem getur varðveitt leynilegar auðkenningarupplýsingar fyrir þetta ferli.
Búðu til tenginguna.

Databricks OAuth connection settings showing redacted client ID and redirect URL, access scopes, and the client-secret option.

Afrita auðkenningarupplýsingar úr Databricks

Í glugganum Tenging búin til skaltu afrita Auðkenni biðlara.
Afritaðu Leynilykil biðlara strax og geymdu hann á öruggum stað.
Ef þú lokar glugganum áður en þú afritar leynilykilinn skaltu búa til eða endurnýja auðkenningarupplýsingar OAuth-forritsins og nota nýja leynilykilinn.

Databricks sýnir leynilykilinn aðeins einu sinni. Meðhöndlaðu hann sem auðkenningarupplýsingar og láttu hann ekki sjást á skjámyndum, í þjónustubeiðnum, athugasemdum eða spjalli.

Ljúktu við sérsniðna OAuth-uppsetningu í ChatGPT

Farðu aftur í gluggann Tengja Databricks Genie.
Sláðu inn auðkenni Databricks-biðlarans í Auðkenni OAuth-biðlara.
Sláðu inn leynilykil Databricks-biðlarans í Leynilykill OAuth-biðlara.
Þegar þú slærð inn þessar aðgangsupplýsingar er sérsniðni OAuth-biðlarinn þinn notaður; ekki þarf að velja hann sérstaklega.
Í Aðgangssvið (valfrjálst) skaltu slá inn þau aðgangssvið sem Databricks-endapunktur og virkni forritsins krefjast. Láttu þau samsvara aðgangssviðunum sem eru virk í Databricks OAuth-forritinu.
Fyrir nýja tengingu við Genie eða mælaborð sem sýnir ai-gateway, dashboards og offline_access skaltu halda þeim aðgangssviðum. Gakktu úr skugga um að Databricks OAuth-forritið leyfi sömu aðgangssvið. ai-gateway virkjar Genie MCP-tenginguna innan vinnusvæðisins, dashboards virkjar aðgerðir á AI/BI-mælaborðum og offline_access virkjar endurnýjunarteikn.
Eldri og víðtækari valkosturinn, all-apis og offline_access, er enn studdur fyrir víðtækari API-aðgang en er ekki ráðlagður fyrir þessa tengingu við Genie eða mælaborð. Ef Databricks-forritið leyfir aðeins all-apis skaltu uppfæra það eða búa það til aftur svo það leyfi ai-gateway, dashboards og offline_access. Ef afmörkuð aðgangssvið eru ekki tiltæk skaltu velja sérstaklega all-apis og offline_access í ChatGPT og tryggja að Databricks-forritið leyfi hvort tveggja. Ekki biðja um afmörkuðu aðgangssviðin þrjú í ChatGPT ef Databricks-forritið leyfir aðeins all-apis.
Sláðu inn eitt aðgangssvið í hverja línu eða aðskildu þau með kommum. Öll aðgangssvið sem skráð eru í ChatGPT verða að vera virk í Databricks OAuth-forritinu.
Sláðu inn Hýsilheiti vinnusvæðis (áskilið) án https:// eða slóðarhluta. Fylltu út aðra áskilda reiti fyrir Databricks-þjónustuveituna sem birtast í uppsetningarferlinu.
ChatGPT notar þetta hýsilheiti til að ákvarða Genie MCP-endapunktinn innan vinnusvæðisins, https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. Ekki þarf sérstakan svæðisbundinn MCP-endapunkt.
Veldu Halda áfram.

ChatGPT biður nákvæmlega um þau aðgangssvið sem slegin eru inn í Aðgangssvið (valfrjálst). Það bætir ekki sjálfkrafa við víðtækari aðgangssviðum úr sniðmáti.

ChatGPT Connect Databricks Genie dialog showing a mock workspace hostname, mock client ID, masked secret, and scopes.

Tengja og prófa

Framkvæmdu eftirfarandi tengiprófanir og aðgangsathuganir, óháð því hvaða OAuth-leið þú velur.

Farðu yfir upplýsingar um forritið, aðgerðir þess og auðkenningarstillingar.
Ef þú ert stjórnandi vinnusvæðis skaltu virkja forritið fyrir vinnusvæðið og stilla hverjir mega nota það í samræmi við reglur vinnusvæðisins.
Hefðu tengingarferlið í ChatGPT sem prófunarnotandi með tilskildar heimildir og skráðu þig síðan inn í Databricks.
Staðfestu að vafrinn opni réttan Databricks-reikning eða -vinnusvæði.
Farðu yfir umbeðin aðgangssvið og veldu síðan Veita heimild.
Staðfestu að vafrinn fari aftur í ChatGPT og að forritið sé merkt sem tengt.
Keyrðu lesaðgerð sem hefur litla áhættu í för með sér og samsvarar virkni tengingarinnar. Fyrir Genie-tengingu skaltu senda Genie-beiðni um gögn sem prófunarnotandinn hefur aðgangsheimild að. Til að prófa aðra studda virkni skaltu sækja upplýsingar um núverandi notanda eða senda fyrirspurn í samþykkt Databricks SQL-tilfang. Gakktu úr skugga um að notandinn hafi tilskildar heimildir fyrir Databricks-tilföngunum; OAuth-aðgangssvið veita ekki ein og sér aðgang að gögnum.
Ef skrifaðgerðir eru virkjaðar skaltu prófa Databricks-vinnuferli sem felur augljóslega í sér litla áhættu áður en notkun er útvíkkuð.
Við uppsetningu á vinnusvæði skaltu biðja meðlim sem hefur notkunarheimild en er ekki stjórnandi að tengjast og endurtaka áhættulitlu prófunina.

Stjórna aðgangi

Bæði Databricks og ChatGPT koma að aðgangsstýringu.

Í ChatGPT stjórna stjórnendur vinnusvæða því hvort forritið sé tiltækt og hvernig meðlimir geta notað það. Í Business stjórna stjórnendur því hvort forritið sé virkjað á öllu vinnusvæðinu. Farðu yfir eftirfarandi stjórnandastillingar Databricks-forritanna (Stillingar vinnusvæðis > Forrit eða Stjórnborð > Viðbætur > Stjórna eldri forritum):

Notandaaðgangur, til að stilla hvaða hlutverk á vinnusvæði mega nota forritið á Enterprise- og Edu-vinnusvæðum sem styðja það.
Aðgerðastýring, til að stilla hvaða Databricks-aðgerðir eru virkjaðar.
Forritsheimildir, til að stilla hvenær ChatGPT biður meðlimi um leyfi áður en það notar forritið.

Þessar forritsheimildir gilda um samtöl í ChatGPT. Fulltrúar á vinnusvæði nota sérstakar stillingar fyrir hvern fulltrúa sem höfundur hans skilgreinir. Þær ákvarða hvaða forritsaðgerðir eru tiltækar og hvenær notendur eru beðnir um að samþykkja þær. Um hegðun fulltrúa, sjá: Fulltrúar á ChatGPT-vinnusvæði fyrir Enterprise og Business.

Í Databricks stjórna stjórnendur því hvaða notendur mega veita OAuth-forritinu heimild og hvaða Databricks-tilföng þeir hafa aðgang að. Heimildir hjá þjónustuveitunni gilda áfram eftir að forritið hefur verið virkjað í ChatGPT.

Upplýsingar um að rata um vinnusvæðið, aðgang að forritum og forritastillingar eftir áskriftarleið er að finna í: Stjórnandastillingar, öryggi og reglufylgni í forritum.

Úrræðaleit við uppsetningu Databricks-forritsins

Ósamræmi í URI-endurbeiningu: Ef þú notar sérsniðinn OAuth-biðlara skaltu ganga úr skugga um að gildið í Endurbeiningarslóðir í Databricks samsvari nákvæmlega Endurkallsslóð sem birtist í ChatGPT, þar á meðal slóðinni og auðkenni endurkalls. Ekki fjarlægja auðkenni endurkalls, bæta skástriki við endann eða skipta slóðinni út fyrir aðra ChatGPT-endurbeiningarslóð.
Leynilykil vantar: Ef þú notar sérsniðinn OAuth-biðlara skaltu hafa í huga að Databricks-leynilyklar eru aðeins sýndir einu sinni. Búðu til nýjan leynilykil biðlara ef hann var ekki afritaður.
OAuth-forrit ekki tiltækt strax: Samkvæmt Databricks getur tekið allt að 30 mínútur að vinna úr uppfærslum á OAuth-forritum.
Ófullnægjandi aðgangssvið eða ósamræmi milli þeirra: Ef þú notar sérsniðinn OAuth-biðlara skaltu bera saman Aðgangssvið (valfrjálst) í ChatGPT og Aðgangssvið í Databricks OAuth-forritinu. Öll aðgangssvið sem ChatGPT biður um verða að vera virkjuð þar. Gakktu úr skugga um að aðgangssviðin styðji endapunktinn og virknina sem þú notar.
Fyrir nýja tengingu við Genie eða mælaborð sem sýnir ai-gateway, dashboards og offline_access skaltu halda þessum aðgangssviðum í ChatGPT og tryggja að Databricks-forritið heimili þau öll þrjú. Ef forritið heimilar aðeins all-apis skaltu uppfæra það eða búa það til aftur svo það heimili þessi þrjú afmörkuðu aðgangssvið.
Ef afmörkuð aðgangssvið eru ekki í boði skaltu nota víðtækari kostinn sem er studdur: stilltu ChatGPT á all-apis og offline_access og tryggðu að Databricks-forritið heimili bæði. Forrit sem heimilar aðeins all-apis uppfyllir ekki beiðni frá ChatGPT um ai-gateway, dashboards og offline_access. Aðgangur eingöngu að SQL hentar aðeins forriti sem er takmarkað við Databricks SQL-forritaskil; hann nægir ekki fyrir aðgerðir í Genie eða á mælaborðum.
SQL-aðgerðir mistakast: Fyrir forrit sem er takmarkað við Databricks SQL-forritaskil skaltu athuga SQL-aðgangssviðið, stillingar gagnavöruhúss og heimildir í Databricks.
Rangt ChatGPT-vinnusvæði: Búðu til og virkjaðu forritið á sama ChatGPT-vinnusvæði og notendur munu tengja það á.
Rangur Databricks-reikningur eða -vinnusvæði: Athugaðu gildið í Hýsilheiti vinnusvæðis (áskilið), endurtaktu síðan innskráninguna og staðfestu að Databricks opni réttan reikning eða vinnusvæði.
Notendur geta ekki tengst: Gakktu úr skugga um að notandinn hafi aðgang að Databricks og megi veita OAuth-forritinu heimild. Í Business skaltu staðfesta að forritið sé virkjað á öllu vinnusvæðinu. Á Enterprise- og Edu-vinnusvæðum sem styðja það skaltu einnig staðfesta að Notandaaðgangur í ChatGPT heimili notkun forritsins.
Netreglur Databricks loka á forritið: Ef Databricks leyfir aðeins tilteknar uppruna-IP-tölur þarf Databricks-stjórnandi að uppfæra viðeigandi IP-aðgangslista reiknings eða vinnusvæðis, samhengisháða stýringu á innkomandi tengingum, eldvegg eða aðrar netreglur sem viðskiptavinurinn stýrir.
- Leyfðu innkomandi tengingar frá gildandi IP-tölubilum fyrir útleiðandi tengingar ChatGPT-forrita.
- Stilltu þennan leyfislista í Databricks eða á netlaginu sem viðskiptavinurinn stýrir. Hann er aðskilinn frá IP-leyfislista ChatGPT-vinnusvæðisins.
- Birt IP-tölubil geta breyst. Gerðu uppfærslur úr JSON-skránni sjálfvirkar þegar það er hægt.
- Ekki endurnýja leynilykil biðlara eða breyta OAuth-aðgangssviðum til að komast fram hjá netlokun. Athugaðu fyrst hvort Databricks sé að hafna uppruna-IP-tölum forritsins.