Ezt az útmutatót akkor használja, ha Ön ChatGPT-munkaterület rendszergazdája, illetve ChatGPT Plus- vagy ChatGPT Pro-felhasználó, és szervezete Databricks OAuth-kliensével állítja be a Databricks Genie-összekötőt.
A Databricks esetében a beállítás nagy része a Databricks Account Console felületén történik. Hozzon létre egy egyéni OAuth-alkalmazáskapcsolatot, regisztrálja a ChatGPT visszahívási URL-jét, másolja ki a létrehozott kliens-hitelesítő adatokat, majd adja meg ezeket az értékeket a ChatGPT-összekötő beállítási folyamatában.
A beállítás célja
Egy Databricks-alkalmazáskapcsolatot hoz létre a ChatGPT-fiókjához vagy -munkaterületéhez. A kapcsolat a következőket használja:
A Databricks Account Console felületén létrehozott Databricks OAuth-alkalmazáskapcsolat.
A Databricks OAuth-kliensazonosítója és kliens-titkos kulcsa.
A ChatGPT-ből pontosan kimásolt visszahívási URL.
Az engedélyezni kívánt összekötőfunkcióknak megfelelő Databricks-hatókörök.
A ChatGPT beállítási folyamata által kért Databricks-szolgáltatói adatok, például a munkaterület gazdagépe, a fiók gazdagépe, a fiókazonosító vagy az adattárház.
Mielőtt elkezdi
A következőkre lesz szüksége:
ChatGPT-munkaterületi rendszergazdai vagy tulajdonosi hozzáférés, illetve ChatGPT Plus- vagy ChatGPT Pro-fiók.
Databricks-fiókszintű rendszergazdai hozzáférés. Bizonyos feladatokhoz elegendő lehet a munkaterületi rendszergazdai hozzáférés, de az egyéni alkalmazáskapcsolatokat a Databricks Account Console felületén kell beállítani.
A Databricks Account Console megnyitva egy külön lapon.
A Databricks Genie kapcsolati képernyője megnyitva a ChatGPT-ben, hogy kimásolhassa a pontos visszahívási URL-t.
Döntés arról, hogy az alkalmazásnak általános Databricks API-hozzáférésre vagy csak Databricks SQL-hozzáférésre van-e szüksége.
Biztonságos hely a Databricks kliens-titkos kulcsának kezeléséhez.
Ha a Databricks-fiók vagy -munkaterület IP-hozzáférési listával, környezetalapú bejövőforgalom-vezérléssel, tűzfallal vagy más hálózati szabályzattal korlátozza a hozzáférést, kérje egy Databricks-rendszergazda segítségét, aki engedélyezheti a ChatGPT-összekötők aktuális kimenő IP-címtartományait.
Megjegyzés: pontosan a ChatGPT-ben megjelenő Visszahívási URL értékét kell kimásolnia.
Előkészítendő értékek
Visszahívási URL: másolja ki a ChatGPT-összekötő beállítási folyamatából.
Databricks OAuth-kliensazonosító.
Databricks OAuth-kliens titkos kulcsa.
Databricks-hozzáférési hatókörök, például ÖSSZES API vagy SQL.
A ChatGPT beállítási folyamata által kért Databricks-munkaterületi vagy -fiókmezők.
Az alkalmazás beállításának megkezdése a ChatGPT-ben
A ChatGPT-ben váltson arra a fiókra vagy munkaterületre, ahol elérhetővé szeretné tenni az alkalmazást.
Munkaterületi rendszergazdaként vagy tulajdonosként nyissa meg a Munkaterület beállításai > Beépülő modulok menüpontot.
Válassza a Databricks Genie lehetőséget a Könyvtárban.
Válassza az Alkalmazáskapcsolat hozzáadása lehetőséget.
A Databricks Genie csatlakoztatása párbeszédpanelen keresse meg az OAuth-kliens szakaszt.
A ChatGPT-ből származó Visszahívási URL. Hagyja nyitva ezt a párbeszédpanelt.
Példa visszahívási URL-re:
https://chatgpt.com/connector/oauth/<callback_id>
Ne távolítsa el a visszahívási azonosítót, ne adjon záró perjelet az URL-hez, és ne cserélje le egy általános ChatGPT URL-re. A Databricksben regisztrált URL-nek pontosan egyeznie kell a ChatGPT-ben megjelenő Visszahívási URL értékével.
Az OAuth-alkalmazáskapcsolat létrehozása a Databricksben
Nyissa meg Databricks-fiókja Databricks Account Console felületét.
A bal oldalsávon nyissa meg a Beállítások menüpontot.
Nyissa meg az Alkalmazáskapcsolatok lapot.
Válassza a Kapcsolat hozzáadása lehetőséget.
Adjon meg egy alkalmazásnevet, például: ChatGPT Databricks Connector.
Az Átirányítási URL-ek mezőbe illessze be a ChatGPT-ből kimásolt pontos visszahívási URL-t.
A Hozzáférési hatókörök alatt válassza ki az alkalmazásnak szükséges hatóköröket.
Az SQL-en túli Databricks API-kat igénylő általános Databricks-alkalmazásokhoz használja az ÖSSZES API lehetőséget.
A kizárólag Databricks SQL API-kra korlátozott alkalmazásokhoz csak az SQL lehetőséget használja.
Győződjön meg arról, hogy a ChatGPT-ben később felsorolt összes hatókör engedélyezve van ebben a Databricks OAuth-alkalmazásban. A Databricks automatikusan engedélyezi az openid, email, profile és offline_access hatókört a felhasználói felületen létrehozott alkalmazásokhoz.
Hagyja a tokenek élettartamát a Databricks alapértelmezett értékein, kivéve, ha szervezete külön szabályzatot alkalmaz: a hozzáférési tokennél 60 perc, a frissítési tokennél 10080 perc.
Kapcsolja be a Kliens-titkos kulcs létrehozása beállítást. Ehhez a folyamathoz a ChatGPT-nek bizalmas OAuth-kliensre van szüksége.
Hozza létre a kapcsolatot.
Hitelesítő adatok másolása a Databricksből
A Kapcsolat létrehozva párbeszédpanelen másolja ki a Kliensazonosítót.
Azonnal másolja ki a Kliens-titkos kulcsot, és tárolja biztonságosan.
Ha a titkos kulcs kimásolása előtt bezárja a párbeszédpanelt, hozzon létre új hitelesítő adatokat az OAuth-alkalmazáshoz, vagy cserélje le a meglévőket, és használja az új titkos kulcsot.
A Databricks csak egyszer jeleníti meg a titkos kulcsot. Kezelje hitelesítő adatként, és ne szerepeltesse képernyőképeken, hibajegyekben, megjegyzésekben vagy csevegésekben.
A beállítás befejezése a ChatGPT-ben
Térjen vissza a Databricks Genie csatlakoztatása párbeszédpanelre.
Adja meg a Databricks kliensazonosítóját az OAuth-kliensazonosító mezőben.
Adja meg a Databricks kliens-titkos kulcsát az OAuth-kliens titkos kulcsa mezőben.
Az Hatókörök (nem kötelező) mezőben tartsa meg az all-apis és az offline_access értéket az általános API-hozzáféréshez.
Soronként egy hatókört adjon meg, vagy vesszővel válassza el a hatóköröket. A ChatGPT-ben felsorolt összes hatókört engedélyezni kell a Databricks OAuth-alkalmazásban.
Adja meg a Munkaterület gazdagépneve (kötelező) értékét a https:// előtag és URL-útvonal nélkül. Töltse ki a beállítási folyamatban megjelenő összes többi kötelező Databricks-szolgáltatói mezőt.
Válassza a Folytatás lehetőséget.
A ChatGPT pontosan a Hatókörök (nem kötelező) mezőben megadott hatóköröket kéri. Nem ad hozzá automatikusan tágabb sablonhatóköröket.
Csatlakoztatás és tesztelés
Tekintse át az összekötő adatait, műveleteit és hitelesítési beállításait.
Ha Ön munkaterületi rendszergazda, engedélyezze az összekötőt a munkaterületen, és a munkaterület szabályzatának megfelelően állítsa be, hogy ki használhatja.
Engedélyezett tesztfelhasználóként indítsa el a csatlakoztatási folyamatot a ChatGPT-ből, majd jelentkezzen be a Databricksbe.
Ellenőrizze, hogy a böngésző a várt Databricks-fiókot vagy -munkaterületet nyitja-e meg.
Tekintse át a kért hatóköröket, majd válassza az Engedélyezés lehetőséget.
Ellenőrizze, hogy a böngésző visszatér-e a ChatGPT-be, és az összekötő csatlakoztatottként jelenik-e meg.
Először hajtson végre egy alacsony kockázatú olvasási műveletet, például kérje le az aktuális felhasználó adatait, vagy kérdezzen le egy jóváhagyott Databricks SQL-erőforrást.
Ha az írási műveletek engedélyezve vannak, a szélesebb körű bevezetés előtt tesztelje őket egy egyértelműen alacsony kockázatú Databricks-munkafolyamattal.
Munkaterületi beállítás esetén kérjen meg egy engedélyezett, nem rendszergazda munkaterületi tagot, hogy csatlakoztassa az összekötőt, és ismételje meg az alacsony kockázatú tesztet.
Hozzáférés kezelése
A hozzáférés-vezérlésben a Databricks és a ChatGPT is szerepet játszik.
A ChatGPT-ben a munkaterületi rendszergazdák kezelik, hogy elérhető-e az alkalmazás, és hogyan használhatják a tagok. Tekintse át a Databricks alkalmazás-rendszergazdai vezérlőit (Munkaterület beállításai > Alkalmazások) a következőkhöz:
Felhasználói hozzáférés: annak beállítása, hogy mely munkaterületi szerepkörök használhatják az összekötőt.
Műveletvezérlés: annak beállítása, hogy mely Databricks-műveletek legyenek engedélyezve.
Alkalmazásengedélyek: annak beállítása, hogy a ChatGPT mikor kérjen engedélyt a tagoktól az összekötő használata előtt.
Ezek az alkalmazásengedélyek a ChatGPT-beszélgetésekre vonatkoznak. A munkaterületi ügynökök az ügynök készítője által meghatározott, ügynökönkénti vezérlők alapján döntik el, hogy mely alkalmazásműveletek érhetők el, és mikor kell jóváhagyást kérni a végfelhasználóktól. Az ügynökök működéséről itt olvashat: ChatGPT munkaterületi ügynökök Enterprise és Business csomaghoz.
A Databricksben a rendszergazdák kezelik, hogy mely felhasználók engedélyezhetik az OAuth-alkalmazást, és mely Databricks-erőforrásokhoz férhetnek hozzá. A szolgáltató engedélyei az alkalmazás ChatGPT-beli engedélyezése után is érvényesek.
A Databricks-összekötő beállításával kapcsolatos problémák elhárítása
Az átirányítási URI nem egyezik: Ellenőrizze, hogy a Databricks Átirányítási URL-ek értéke pontosan egyezik-e a ChatGPT-ben megjelenő Visszahívási URL értékével, beleértve az útvonalat és a visszahívási azonosítót is. Ne távolítsa el a visszahívási azonosítót, ne adjon hozzá záró perjelet, és ne helyettesítse másik ChatGPT átirányítási URL-lel.
Hiányzó titkos kulcs: A Databricks csak egyszer jeleníti meg a titkos kulcsokat. Ha nem másolta ki, hozzon létre új kliens-titkos kulcsot.
Az OAuth-alkalmazás nem érhető el azonnal: A Databricks tájékoztatása szerint az OAuth-alkalmazás frissítéseinek feldolgozása akár 30 percet is igénybe vehet.
Elégtelen vagy nem egyező hatókör: Hasonlítsa össze a ChatGPT Hatókörök (nem kötelező) mezőjét a Databricks OAuth-alkalmazás Hozzáférési hatóköreivel. A ChatGPT által kért összes hatókört engedélyezni kell ott. A nem SQL-alapú API-k esetében ellenőrizze, hogy az all-apis engedélyezve van-e a Databricksben, és továbbra is szerepel-e a ChatGPT hatóköreinek listáján.
Az SQL-műveletek sikertelenek: Ellenőrizze az SQL-hatókört, az adattárház beállításait és a Databricks-engedélyeket.
Nem megfelelő ChatGPT-munkaterület: Ugyanabban a ChatGPT-munkaterületben hozza létre és engedélyezze az összekötőt, ahol a felhasználók csatlakoztatni fogják.
Nem megfelelő Databricks-fiók vagy -munkaterület: Ellenőrizze a Munkaterület gazdagépneve (kötelező) értékét, majd ismételje meg a bejelentkezési folyamatot, és győződjön meg arról, hogy a Databricks a várt fiókot vagy munkaterületet nyitja meg.
A felhasználók nem tudnak csatlakozni: Ellenőrizze, hogy a felhasználó rendelkezik-e Databricks-hozzáféréssel, és jogosult-e az OAuth-alkalmazás engedélyezésére. Azt is ellenőrizze, hogy a felhasználó ChatGPT-beli Felhasználói hozzáférése engedélyezi-e az összekötőt.
A Databricks hálózati szabályzata blokkolja az összekötőt: Ha a Databricks csak meghatározott forrás-IP-címeket engedélyez, egy Databricks-rendszergazdának frissítenie kell az érintett fiók vagy munkaterület IP-hozzáférési listáit, környezetalapú bejövőforgalom-vezérlőit, tűzfalát vagy egyéb, az ügyfél által felügyelt hálózati szabályait.
Engedélyezze a bejövő kapcsolatokat a ChatGPT-összekötők aktuális kimenő IP-címtartományaiból.
Ezt az engedélyezési listát a Databricksben vagy az ügyfél által felügyelt hálózati rétegben állítsa be. Ez elkülönül a ChatGPT-munkaterület IP-címeinek engedélyezési listájától.
A közzétett tartományok változhatnak. Lehetőség szerint automatizálja a frissítéseket a JSON alapján.
Hálózati blokkolás megkerüléséhez ne cserélje le a kliens-titkos kulcsot, és ne módosítsa az OAuth-hatóköröket. Először ellenőrizze, hogy a Databricks elutasítja-e az összekötő forrás-IP-címeit.