Ezt az útmutatót akkor használja, ha Ön ChatGPT-munkaterület-adminisztrátor, és a Databricks alkalmazássablont állítja be a szervezete számára. A sablon nem az a végleges alkalmazás, amelyet a tagok használnak. Ez egy beállítási folyamat, amely a szükséges Databricks-konfiguráció megadása után munkaterület-specifikus vázlatalkalmazást hoz létre.
A Databricks esetében a beállítás nagy része a Databricks Account Console felületén történik. Létrehoz egy egyéni OAuth-alkalmazáskapcsolatot, regisztrálja a ChatGPT visszahívási URL-címét, kimásolja a létrehozott ügyfél-hitelesítő adatokat, majd beilleszti ezeket az értékeket a ChatGPT sablonbeállítási folyamatába. Miután a ChatGPT létrehozta a vázlatalkalmazást, közzéteheti, és a többi munkaterületi alkalmazáshoz hasonlóan kezelheti.
Mit állít be
Egy munkaterület-specifikus Databricks alkalmazást hoz létre a ChatGPT-ben. Az alkalmazás a következőket használja:
A Databricks Account Console felületén létrehozott Databricks OAuth-alkalmazáskapcsolat.
A Databricks OAuth-ügyfélazonosítója és ügyféltitka.
A ChatGPT-ből kimásolt pontos visszahívási URL-cím.
Az engedélyezni kívánt összekötői képességeknek megfelelő Databricks-hatókörök.
A ChatGPT beállítási folyamata által kért bármely Databricks-szolgáltatói adat, például a munkaterület gazdagépe, a fiók gazdagépe, a fiókazonosító vagy a warehouse.
Mielőtt elkezdené
Szüksége lesz a következőkre:
ChatGPT-munkaterületi adminisztrátori vagy tulajdonosi hozzáférés.
Databricks-fiókadminisztrátori hozzáférés. Bizonyos feladatokhoz elegendő lehet a munkaterületi adminisztrátori hozzáférés, de az egyéni alkalmazáskapcsolatok konfigurálása a Databricks Account Console felületéről történik.
A Databricks Account Console külön lapon megnyitva.
A Databricks alkalmazássablon beállítási képernyője megnyitva a ChatGPT-ben, hogy ki tudja másolni a pontos visszahívási URL-címet.
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 ügyféltitok kezeléséhez.
Ne találjon ki visszahívási URL-címet. Másolja ki a ChatGPT-ben megjelenő pontos visszahívási URL-címet.
Előkészítendő értékek
Visszahívási URL: másolja ki ezt a ChatGPT sablonbeállítási folyamatából.
Databricks OAuth-ügyfélazonosító.
Databricks OAuth-ügyféltitok.
Databricks hozzáférési hatókörök, például ALL APIs vagy SQL.
A ChatGPT beállítási folyamata által kért Databricks-munkaterületi vagy -fiókmezők.
Az alkalmazás közzététele és kezelése a ChatGPT-ben
A vázlatalkalmazás létrehozása nem teszi automatikusan elérhetővé az alkalmazást a tagok számára. A vázlat áttekintése után:
Tegye közzé a vázlatalkalmazást.
Ellenőrizze, hogy az alkalmazás megjelenik-e itt: Munkaterület beállításai > Alkalmazások > Engedélyezve.
Konfigurálja a Felhasználói hozzáférés beállítást azokhoz a szerepkörökhöz, amelyeknek használniuk kell az alkalmazást.
Tekintse át a Műveletvezérlés beállítást az alkalmazás által elérhetővé tett Databricks-műveletekhez.
Tekintse át az Alkalmazásengedélyek beállítást annak kiválasztásához, hogy a ChatGPT mikor kérdezze meg a tagokat az alkalmazás használata előtt.
Kérjen meg egy engedélyezett tesztfelhasználót, hogy nyissa meg az Alkalmazásokat a ChatGPT-ben, és ellenőrizze, hogy az alkalmazás megjelenik-e.
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 beállított ügynökönkénti vezérlőket használják annak meghatározására, hogy mely alkalmazásműveletek érhetők el, és mikor kell a végfelhasználóktól jóváhagyást kérni. Az ügynök viselkedéséről lásd: ChatGPT munkaterületi ügynökök Enterprise és Business csomaghoz.
A sablon beállításának elindítása a ChatGPT-ben
A ChatGPT-ben váltson arra a munkaterületre, ahol az alkalmazásnak elérhetőnek kell lennie.
Nyissa meg a Munkaterület beállításai > Alkalmazások menüpontot.
Válassza a Könyvtár lehetőséget.
Keressen rá a Databricksre.
Válassza ki a Databricks alkalmazássablont, és indítsa el a beállítást.
Adjon meg egy egyértelmű alkalmazásnevet és leírást, például Databricks vagy Databricks – Adatplatform.
Az OAuth-ügyfél szakaszban másolja ki a visszahívási URL-címet a ChatGPT-ből. Tartsa nyitva ezt a lapot.
Példa visszahívási URL-címre: https://chatgpt.com/connector/oauth/<callback_id>
Ne távolítsa el a visszahívási azonosítót, ne adjon hozzá záró perjelet, és ne cserélje le egy általános ChatGPT URL-címre.
Az OAuth-alkalmazáskapcsolat létrehozása a Databricksben
Nyissa meg a Databricks Account Console felületet a Databricks-fiókjához.
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-címet.
A Hozzáférési hatókörök alatt válassza ki az alkalmazás számára szükséges hatóköröket.
Használja az ALL APIs beállítást egy általános Databricks alkalmazáshoz, amelynek az SQL-en túl Databricks API-kra is szüksége van.
Csak SQL-t használjon olyan alkalmazáshoz, amely Databricks SQL API-kra korlátozódik.
Hagyja a token TTL-eket a Databricks alapértelmezésein, hacsak a szervezetének nincs konkrét szabályzata.
Engedélyezze az Ügyféltitok létrehozása beállítást. A ChatGPT-nek ehhez a folyamathoz bizalmas OAuth-ügyfélre 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 az Ügyfélazonosítót.
Azonnal másolja ki az Ügyféltitkot, és tárolja biztonságosan.
Ha a titok kimásolása előtt bezárja a párbeszédpanelt, hozza létre vagy forgassa újra az OAuth-alkalmazás hitelesítő adatait, és használja az új titkot.
A Databricks csak egyszer jeleníti meg a titkot. Kezelje hitelesítő adatként, és ne szerepeltesse képernyőképeken, jegyekben, megjegyzésekben vagy csevegésekben.
A beállítás befejezése a ChatGPT-ben
Térjen vissza a ChatGPT sablonbeállítási lapjára.
Illessze be a Databricks ügyfélazonosítóját az OAuth-ügyfélazonosító mezőbe.
Illessze be a Databricks ügyféltitkát az OAuth-ügyféltitok mezőbe.
Hagyja változatlanul a hatóköröket, hacsak nem szándékosan kell felülbírálnia a sablon alapértelmezéseit.
Töltse ki a beállítási folyamat által megkövetelt Databricks-szolgáltatói mezőket, például a munkaterület gazdagépét, a fiók gazdagépét, a fiókazonosítót, a warehouse-t vagy más Databricks-specifikus értékeket.
Hozza létre a vázlatalkalmazást.
Az alkalmazás tesztelése felhasználóként
Indítsa el a csatlakozási folyamatot a ChatGPT-ből engedélyezett tesztfelhasználóként.
Ellenőrizze, hogy a böngésző a várt Databricks-fiókot vagy -munkaterületet nyitja-e meg.
Hagyja jóvá a kért hatóköröket.
Ellenőrizze, hogy a böngésző visszatér-e a ChatGPT-hez, és az alkalmazás csatlakoztatottként jelenik-e meg.
Először futtasson egy alacsony kockázatú olvasási műveletet, például a jelenlegi felhasználói adatok lekérését vagy egy jóváhagyott Databricks SQL-erőforrás lekérdezését.
Ha az írási műveletek engedélyezve vannak, a szélesebb körű bevezetés előtt teszteljen egy egyértelműen alacsony kockázatú Databricks-munkafolyamattal.
Hozzáférés kezelése
A Databricks és a ChatGPT egyaránt hozzájárul a hozzáférés-vezérléshez.
A ChatGPT-ben a munkaterületi adminisztrátorok kezelik, hogy a közzétett alkalmazás elérhető-e, mely munkaterületi szerepkörök használhatják, mely műveletek vannak engedélyezve, és mikor kérdezze meg a ChatGPT a felhasználókat az alkalmazás használata előtt.
A Databricksben az adminisztrátorok kezelik, hogy mely felhasználók engedélyezhetik az OAuth-alkalmazást, és hogy ezek a felhasználók mely Databricks-erőforrásokhoz férhetnek hozzá. A szolgáltatói engedélyek az alkalmazás ChatGPT-ben való engedélyezése után is érvényesek.
Hibaelhárítás
Átirányítási URI eltérése: ellenőrizze, hogy a Databricks átirányítási URL-címe pontosan megegyezik-e a ChatGPT-ben látható visszahívási URL-címmel, beleértve az elérési utat és a visszahívási azonosítót is.
Hiányzó titok: a Databricks-titkok egyszer jelennek meg. Hozzon létre új ügyféltitkot, ha nem másolta ki.
Az OAuth-alkalmazás nem érhető el azonnal: a Databricks szerint az OAuth-alkalmazásfrissítések feldolgozása akár 30 percet is igénybe vehet.
Nem elegendő hatókör: ha a ChatGPT képes hitelesíteni, de a Databricks API-hívások sikertelenek, ellenőrizze, hogy a Databricks alkalmazás rendelkezik-e ALL APIs hozzáféréssel, amikor az alkalmazásnak nem SQL API-kra van szüksége.
Az SQL-műveletek sikertelenek: ellenőrizze az SQL-hatókört, a warehouse-konfigurációt és a Databricks-engedélyeket.
Rossz munkaterület: ugyanabban a ChatGPT-munkaterületen hozza létre és tegye közzé az alkalmazást, ahol a felhasználók csatlakoztatni fogják.
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.