OpenAI
הדף הזה תורגם באופן אוטומטי. לצפייה במאמר המקורי באנגלית.

הגדרת תבנית אפליקציית Databricks ב-ChatGPT

למדו איך מנהלי workspace ב-ChatGPT ומשתמשי ChatGPT Plus או Pro יכולים לחבר את Databricks באמצעות לקוח ה-OAuth של הארגון שלהם.

עודכן: 8 days ago

מדריך זה מיועד למנהלי workspace ב-ChatGPT ולמשתמשי ChatGPT Plus או Pro שמגדירים את אפליקציית Databricks Genie באמצעות OAuth מובנה או לקוח OAuth של הארגון.

  • OAuth מובנה: כשהאפשרות זמינה ב-ChatGPT ומופעלת בסביבת העבודה שלכם ב-Databricks, השתמשו בחיבור שהוגדר מראש. אין צורך ליצור אפליקציית OAuth או להזין מזהה לקוח או סוד לקוח. פעלו לפי ההוראות בסעיף ״OAuth מובנה״ בהמשך.

  • לקוח OAuth מותאם אישית: בחרו במסלול זה אם OAuth מובנה אינו זמין או אם הארגון שלכם דורש שימוש בלקוח OAuth משלו. פעלו לפי ההוראות בסעיף ״לקוח OAuth מותאם אישית״ בהמשך.

מה מגדירים

בתהליך זה תיצרו חיבור לאפליקציית Databricks עבור החשבון או ה-workspace שלכם ב-ChatGPT. בשני המסלולים נדרשים פרטי ספק Databricks המבוקשים ב-ChatGPT והרשאות למשאבים שבהם אתם מתכננים להשתמש. אם אתם משתמשים בלקוח OAuth מותאם אישית, הכינו גם:

  • חיבור לאפליקציית OAuth של Databricks שנוצר במסוף החשבון שלכם ב-Databricks.

  • מזהה לקוח וסוד לקוח של OAuth ב-Databricks.

  • כתובת ה-URL המדויקת לחזרה שהועתקה מ-ChatGPT.

  • היקפי הרשאה של Databricks שתואמים ליכולות האפליקציה שברצונכם להפעיל.

  • כל פרטי ספק Databricks המבוקשים בתהליך ההגדרה ב-ChatGPT, כגון מארח סביבת העבודה, מארח החשבון, מזהה החשבון או מחסן הנתונים.

לפני שמתחילים

להגדרה עבור workspace, פתחו את מסוף הניהול, בחרו ב-workspace הרצוי ב-ChatGPT ופתחו את ״תוספים״. בחרו באפשרות ״ניהול אפליקציות מדור קודם״ כדי לפתוח את דף האפליקציות הישן שנשמר. למידע על ניווט ב-workspace וגישה לאפליקציות מדור קודם, ראו בקרות ניהול, אבטחה ותאימות לתוספים ולאפליקציות.

נדרשים לכם:

  • הרשאות מנהל או בעלים של workspace ב-ChatGPT, או חשבון ChatGPT Plus או Pro.

  • ללקוח OAuth מותאם אישית, הרשאות מנהל חשבון ב-Databricks. הרשאות מנהל סביבת עבודה עשויות להספיק לחלק מהמשימות, אך חיבורי אפליקציות מותאמים אישית מוגדרים דרך מסוף החשבון של Databricks. לשימוש ב-OAuth מובנה, מנהל Databricks חייב לבדוק שאפליקציית ChatGPT זמינה ומופעלת בסביבת העבודה שלכם.

  • ללקוח OAuth מותאם אישית, מסוף החשבון של Databricks פתוח בכרטיסייה נפרדת.

  • ללקוח OAuth מותאם אישית, מסך החיבור ל-Databricks Genie פתוח ב-ChatGPT כדי שתוכלו להעתיק את כתובת ה-URL המדויקת לחזרה.

  • החלטה לגבי היכולות שהאפליקציה צריכה: Genie ולוחות מחוונים של בינה מלאכותית ובינה עסקית, גישה רחבה יותר ל-API של Databricks, או אפליקציה שמוגבלת לממשקי ה-API של Databricks SQL. גישה ל-SQL בלבד אינה מספיקה לפעולות ב-Genie או בלוחות מחוונים.

  • ללקוח OAuth מותאם אישית, מקום מאובטח לטיפול בסוד הלקוח של Databricks.

  • אם החשבון או סביבת העבודה שלכם ב-Databricks מגבילים גישה באמצעות רשימת גישה לפי IP, בקרת תעבורה נכנסת מבוססת הקשר, חומת אש או מדיניות רשת אחרת, נדרשת עזרה ממנהל Databricks שיוכל לאפשר גישה מטווחי כתובות ה-IP היוצאות של אפליקציות ChatGPT העדכניים.

ללקוח OAuth מותאם אישית, העתיקו במדויק את כתובת ה-URL לחזרה שמוצגת ב-ChatGPT.

ערכים שיש להכין

  • ללקוח OAuth מותאם אישית, כתובת URL לחזרה: העתיקו אותה מתהליך הגדרת האפליקציה ב-ChatGPT.

  • ללקוח OAuth מותאם אישית, מזהה לקוח ה-OAuth של Databricks.

  • ללקוח OAuth מותאם אישית, סוד לקוח ה-OAuth של Databricks.

  • ללקוח OAuth מותאם אישית, היקפי הרשאות גישה ב-Databricks שמתאימים ליכולות האפליקציה. בחיבור חדש ל-Genie או ללוחות מחוונים שמציג את ai-gateway,‏ dashboards ו-offline_access, הכינו את היקפי ההרשאה האלה. כל ממשקי ה-API (all-apis יחד עם offline_access) היא עדיין החלופה הוותיקה והרחבה יותר. השתמשו ב-SQL רק עבור אפליקציה שמוגבלת לממשקי ה-API של Databricks SQL.

  • שדות סביבת העבודה או החשבון ב-Databricks המבוקשים בתהליך ההגדרה ב-ChatGPT.

OAuth מובנה

תחילה ודאו שכל הדרישות המוקדמות שלעיל מתקיימות. השתמשו במסלול זה רק אם OAuth מובנה זמין ב-ChatGPT ומופעל בסביבת העבודה שלכם ב-Databricks.

  1. בקשו ממנהל Databricks לבדוק שאפליקציית ChatGPT זמינה בהגדרות שילובי האפליקציות במסוף החשבון, ושהיא מופעלת בסביבת העבודה שלכם. אם אפליקציית ChatGPT אינה מופיעה במסוף החשבון שלכם ב-Databricks, פנו לנציג החשבון שלכם ב-Databricks כדי לברר אם התכונה זמינה לחשבון שלכם.

  2. ב-ChatGPT, עברו לחשבון או ל-workspace שבהם האפליקציה אמורה להיות זמינה. להגדרה אישית, עברו אל הגדרות > תוספים. להגדרה עבור workspace, עברו אל מסוף הניהול > תוספים כמנהלים או כבעלים של ה-workspace.

  3. בחרו באפשרות Databricks Genie, ואז בחרו באפשרות הוספת חיבור לאפליקציה.

  4. הזינו את שם המארח של סביבת העבודה (חובה) ללא https:// או נתיב URL.

    ChatGPT משתמש בשם המארח הזה כדי לקבוע את ה-endpoint של Genie MCP המקומי לסביבת העבודה: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. אין צורך ב-endpoint אזורי נפרד של MCP.

  5. בחרו באפשרות המשך, ואז התחברו ל-Databricks ובדקו את בקשת ההסכמה.

המשיכו לסעיפים ״חיבור ובדיקה״ ו״ניהול הגישה״ בהמשך, כולל הבדיקות עבור חברים מורשים ובדיקות הגישה ל-workspace.

לקוח OAuth מותאם אישית

תחילה ודאו שכל הדרישות המוקדמות שלעיל מתקיימות. השתמשו במסלול זה אם OAuth מובנה אינו זמין או אם הארגון שלכם דורש שימוש בלקוח OAuth משלו. לאחר ההגדרה, השלימו את השלבים בסעיפים ״חיבור ובדיקה״ ו״ניהול הגישה״ בהמשך.

תחילת הגדרת OAuth מותאם אישית ב-ChatGPT

  1. ב-ChatGPT, עברו לחשבון או ל-workspace שבהם האפליקציה אמורה להיות זמינה.

  2. להגדרה אישית, עברו אל הגדרות > תוספים. להגדרה עבור workspace, עברו אל מסוף הניהול > תוספים כמנהלים או כבעלים של ה-workspace.

  3. בחרו באפשרות Databricks Genie בספרייה.

  4. בחרו באפשרות הוספת חיבור לאפליקציה.

  5. בתיבת הדו-שיח חיבור Databricks Genie, מצאו את השדות מזהה לקוח OAuth וסוד לקוח OAuth. הזנת פרטי הזיהוי בשדות המוצגים היא הדרך להגדרת לקוח מותאם אישית; אין צורך בבחירה נפרדת.

  6. העתיקו את כתובת ה-URL לחזרה מ-ChatGPT. השאירו את תיבת הדו-שיח פתוחה.

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

כתובת URL לחזרה לדוגמה:

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

אין להסיר את מזהה החזרה, להוסיף לוכסן בסוף או להחליף את הכתובת בכתובת URL כללית של ChatGPT. כתובת ה-URL הרשומה ב-Databricks חייבת להתאים בדיוק לכתובת ה-URL לחזרה שמוצגת ב-ChatGPT.

יצירת חיבור לאפליקציית OAuth מותאמת אישית ב-Databricks

  1. פתחו את מסוף החשבון של Databricks עבור חשבון ה-Databricks שלכם.

  2. בסרגל הצד השמאלי, פתחו את הגדרות.

  3. פתחו את הכרטיסייה חיבורי אפליקציות.

  4. בחרו באפשרות הוספת חיבור.

    Databricks Account Console Settings page showing the App connections tab and Add connection button.

  5. הזינו שם לאפליקציה, למשל ChatGPT Databricks.

  6. בשדה כתובות URL להפניה מחדש, הדביקו את כתובת ה-URL המדויקת לחזרה שהועתקה מ-ChatGPT.

  7. תחת היקפי הרשאות גישה, בחרו את היקפי ההרשאה שהאפליקציה צריכה.

  8. בחיבור חדש ל-Genie או ללוחות מחוונים שמציג ב-ChatGPT את ai-gateway,‏ dashboards ו-offline_access, אפשרו את אותם היקפי הרשאה באפליקציית ה-OAuth של Databricks.

  9. כל ממשקי ה-API היא עדיין החלופה הוותיקה והרחבה יותר לגישה כללית ל-API של Databricks. בתצורה זו, השתמשו ב-all-apis וב-offline_access ב-ChatGPT, וודאו שאפליקציית ה-OAuth של Databricks מאפשרת את שניהם. בחיבור חדש ל-Genie או ללוחות מחוונים, העדיפו את היקפי ההרשאה הפרטניים המוצגים.

  10. השתמשו ב-SQL רק עבור אפליקציה שמוגבלת לממשקי ה-API של Databricks SQL. גישה ל-SQL בלבד אינה מספיקה לפעולות ב-Genie או בלוחות מחוונים.

  11. ודאו שכל היקף הרשאה שיופיע בהמשך ב-ChatGPT מופעל באפליקציית ה-OAuth הזו של Databricks. Databricks מאפשר אוטומטית את openid, email, profile ו-offline_access לאפליקציות שנוצרו בממשק המשתמש.

  12. השאירו את משכי התוקף של האסימונים בערכי ברירת המחדל של Databricks, אלא אם לארגון שלכם יש מדיניות ספציפית: 60 דקות לאסימון הגישה ו-10080 דקות לאסימון הרענון.

  13. הפעילו את האפשרות יצירת סוד לקוח. לתהליך זה נדרש ב-ChatGPT לקוח OAuth מסוג חסוי.

  14. צרו את החיבור.

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

העתקת פרטי הזיהוי מ-Databricks

  1. בתיבת הדו-שיח החיבור נוצר, העתיקו את מזהה הלקוח.

  2. העתיקו מיד את סוד הלקוח ושמרו אותו באופן מאובטח.

  3. אם סגרתם את תיבת הדו-שיח לפני שהעתקתם את הסוד, צרו או החליפו את פרטי הזיהוי של אפליקציית ה-OAuth והשתמשו בסוד החדש.

Databricks מציג את הסוד פעם אחת בלבד. התייחסו אליו כאל פרט זיהוי רגיש, ואל תכללו אותו בצילומי מסך, בפניות תמיכה, בתגובות או בצ'אטים.

השלמת הגדרת OAuth מותאם אישית ב-ChatGPT

  1. חזרו לתיבת הדו-שיח חיבור Databricks Genie.

  2. הזינו את מזהה הלקוח של Databricks בשדה מזהה לקוח OAuth.

  3. הזינו את סוד הלקוח של Databricks בשדה סוד לקוח OAuth.

    הזנת פרטי הזיהוי האלה מפעילה את השימוש בלקוח ה-OAuth המותאם אישית שלכם; אין צורך בבחירה נפרדת.

  4. בשדה היקפי הרשאה (אופציונלי), הזינו את היקפי ההרשאה הדרושים ל-endpoint של Databricks וליכולות שבהם האפליקציה משתמשת. ודאו שהם תואמים להיקפי ההרשאה המופעלים באפליקציית ה-OAuth של Databricks.

    בחיבור חדש ל-Genie או ללוחות מחוונים שמציג את ai-gateway,‏ dashboards ו-offline_access, השאירו את היקפי ההרשאה האלה. ודאו שאפליקציית ה-OAuth של Databricks מאפשרת את אותם היקפי הרשאה. ai-gateway מאפשר חיבור Genie MCP מקומי לסביבת העבודה, dashboards מאפשר פעולות בלוחות מחוונים של בינה מלאכותית ובינה עסקית, ו-offline_access מאפשר שימוש באסימוני רענון.

    החלופה הוותיקה והרחבה יותר, all-apis ו-offline_access, עדיין נתמכת לצורך גישת API רחבה יותר, אך אינה האפשרות המועדפת לחיבור זה ל-Genie או ללוחות מחוונים. אם אפליקציית Databricks מאפשרת רק all-apis, עדכנו או צרו אותה מחדש כדי לאפשר את ai-gateway,‏ dashboards ו-offline_access. אם היקפי הרשאה פרטניים אינם זמינים, הגדירו במפורש ב-ChatGPT את all-apis ו-offline_access, וודאו שאפליקציית Databricks מאפשרת את שניהם. אל תבקשו את שלושת היקפי ההרשאה הפרטניים ב-ChatGPT כשאפליקציית Databricks מאפשרת רק all-apis.

  5. הזינו כל היקף הרשאה בשורה נפרדת, או הפרידו ביניהם בפסיקים. כל היקף הרשאה שמופיע ב-ChatGPT חייב להיות מופעל באפליקציית ה-OAuth של Databricks.

  6. הזינו את שם המארח של סביבת העבודה (חובה) ללא https:// או נתיב URL. מלאו את כל שדות החובה הנוספים של ספק Databricks שמופיעים בתהליך ההגדרה.

    ChatGPT משתמש בשם המארח הזה כדי לקבוע את ה-endpoint של Genie MCP המקומי לסביבת העבודה: https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp. אין צורך ב-endpoint אזורי נפרד של MCP.

  7. בחרו באפשרות המשך.

ChatGPT מבקש בדיוק את היקפי ההרשאה שהוזנו בשדה היקפי הרשאה (אופציונלי). הוא אינו מוסיף אוטומטית היקפי הרשאה רחבים יותר מהתבנית.

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

חיבור ובדיקה

בכל אחד ממסלולי ה-OAuth, השלימו את בדיקות החיבור והגישה הבאות.

  1. בדקו את פרטי האפליקציה, את הפעולות ואת הגדרות האימות.

  2. אם אתם מנהלי workspace, הפעילו את האפליקציה עבור ה-workspace והגדירו מי יכול להשתמש בה בהתאם למדיניות שלו.

  3. התחילו את תהליך החיבור מתוך ChatGPT כמשתמש בדיקה מורשה, ואז התחברו ל-Databricks.

  4. ודאו שהדפדפן פותח את החשבון או סביבת העבודה הצפויים ב-Databricks.

  5. בדקו את היקפי ההרשאה המבוקשים, ואז בחרו באפשרות אישור גישה.

    Databricks permission request for a mock ChatGPT Databricks Connector showing requested access and the Authorize button.

  6. ודאו שהדפדפן חוזר ל-ChatGPT ושהאפליקציה מוצגת כמחוברת.

  7. הריצו פעולת קריאה בסיכון נמוך שתואמת ליכולות החיבור. בחיבור ל-Genie, שלחו בקשה ל-Genie לגבי נתונים שמשתמש הבדיקה מורשה לגשת אליהם. לבדיקת יכולות נתמכות אחרות, שלפו מידע על המשתמש הנוכחי או הריצו שאילתה על משאב מאושר של Databricks SQL. ודאו שלמשתמש יש את ההרשאות הנדרשות למשאבי Databricks; היקפי הרשאת OAuth לבדם אינם מעניקים גישה לנתונים.

  8. אם פעולות כתיבה מופעלות, בדקו אותן בתהליך עבודה ב-Databricks שרמת הסיכון בו נמוכה בבירור, לפני פריסה רחבה יותר.

  9. בהגדרה עבור workspace, בקשו מחבר מורשה ב-workspace שאינו מנהל להתחבר ולחזור על הבדיקה בסיכון נמוך.

ניהול הגישה

בקרת הגישה מתבצעת גם ב-Databricks וגם ב-ChatGPT.

ב-ChatGPT, מנהלי ה-workspace קובעים אם האפליקציה זמינה וכיצד חברים יכולים להשתמש בה. ב-Business, מנהלים קובעים אם האפליקציה מופעלת בכל ה-workspace. בדקו את בקרות הניהול של אפליקציות Databricks (הגדרות workspace > אפליקציות או מסוף הניהול > תוספים > ניהול אפליקציות מדור קודם) עבור:

  • גישת משתמשים, להגדרת התפקידים ב-workspace שרשאים להשתמש באפליקציה בסביבות workspace נתמכות של Enterprise ו-Edu.

  • בקרת פעולות, להגדרת פעולות Databricks שמופעלות.

  • הרשאות אפליקציה, להגדרת המקרים שבהם ChatGPT מבקש אישור מחברים לפני השימוש באפליקציה.

הרשאות האפליקציה האלה חלות על שיחות ב-ChatGPT. סוכני workspace משתמשים בבקרות שיוצר הסוכן מגדיר לכל סוכן בנפרד, כדי לקבוע אילו פעולות באפליקציה זמינות ומתי משתמשי הקצה מתבקשים לאשר אותן. למידע על התנהגות סוכנים, ראו: סוכני workspace ב-ChatGPT עבור Enterprise ו-Business.

ב-Databricks, מנהלים קובעים אילו משתמשים יכולים לאשר גישה לאפליקציית ה-OAuth ולאילו משאבי Databricks אותם משתמשים יכולים לגשת. הרשאות הספק ממשיכות לחול גם לאחר הפעלת האפליקציה ב-ChatGPT.

למידע על ניווט ב-workspace, גישה לאפליקציות ובקרות אפליקציה לפי תוכנית, ראו: בקרות ניהול, אבטחה ותאימות באפליקציות.

פתרון בעיות בהגדרת אפליקציית Databricks

  • אי-התאמה ב-URI להפניה מחדש: אם אתם משתמשים בלקוח OAuth מותאם אישית, ודאו שהערך בשדה כתובות URL להפניה מחדש ב-Databricks תואם בדיוק לכתובת URL לחזרה שמוצגת ב-ChatGPT, כולל הנתיב ומזהה החזרה. אין להסיר את מזהה החזרה, להוסיף לוכסן בסוף או להחליף את הכתובת בכתובת URL אחרת להפניה מחדש של ChatGPT.

  • סוד חסר: אם אתם משתמשים בלקוח OAuth מותאם אישית, שימו לב שסודות ב-Databricks מוצגים פעם אחת בלבד. צרו סוד לקוח חדש אם הוא לא הועתק.

  • אפליקציית OAuth אינה זמינה מיד: לפי Databricks, עיבוד עדכונים לאפליקציות OAuth עשוי להימשך עד 30 דקות.

  • היקף הרשאה לא מספיק או לא תואם: אם אתם משתמשים בלקוח OAuth מותאם אישית, השוו בין היקפי הרשאה (אופציונלי) ב-ChatGPT לבין היקפי הרשאות גישה באפליקציית ה-OAuth של Databricks. כל היקף הרשאה ש-ChatGPT מבקש חייב להיות מופעל שם. ודאו שהיקפי ההרשאה תומכים ב-endpoint וביכולות שבהם אתם משתמשים.

    בחיבור חדש ל-Genie או ללוחות מחוונים שמציג את ai-gateway,‏ dashboards ו-offline_access, השאירו את היקפי ההרשאה האלה ב-ChatGPT וודאו שאפליקציית Databricks מאפשרת את שלושתם. אם האפליקציה מאפשרת רק all-apis, עדכנו או צרו אותה מחדש כדי לאפשר את שלושת היקפי ההרשאה הפרטניים.

    אם היקפי הרשאה פרטניים אינם זמינים, השתמשו בחלופה הרחבה יותר שנתמכת: הגדירו ב-ChatGPT את all-apis ו-offline_access, וודאו שאפליקציית Databricks מאפשרת את שניהם. אפליקציה שמאפשרת רק all-apis אינה תואמת לבקשה של ChatGPT לקבלת ai-gateway,‏ dashboards ו-offline_access. גישה ל-SQL בלבד מתאימה רק לאפליקציה שמוגבלת לממשקי ה-API של Databricks SQL; היא אינה מספיקה לפעולות ב-Genie או בלוחות מחוונים.

  • פעולות SQL נכשלות: באפליקציה שמוגבלת לממשקי ה-API של Databricks SQL, בדקו את היקף ההרשאה SQL, את הגדרות מחסן הנתונים ואת ההרשאות ב-Databricks.

  • workspace שגוי ב-ChatGPT: צרו והפעילו את האפליקציה באותו workspace ב-ChatGPT שבו המשתמשים יחברו אותה.

  • חשבון או סביבת עבודה שגויים ב-Databricks: בדקו את הערך בשדה שם המארח של סביבת העבודה (חובה), ואז חזרו על תהליך ההתחברות וודאו ש-Databricks פותח את החשבון או סביבת העבודה הצפויים.

  • משתמשים אינם יכולים להתחבר: ודאו שלמשתמש יש גישה ל-Databricks ושהוא מורשה לאשר גישה לאפליקציית ה-OAuth. ב-Business, ודאו שהאפליקציה מופעלת בכל ה-workspace. בסביבות workspace נתמכות של Enterprise ו-Edu, ודאו גם שהגדרת גישת משתמשים ב-ChatGPT מאפשרת שימוש באפליקציה.

  • מדיניות הרשת של Databricks חוסמת את האפליקציה: אם Databricks מאפשר גישה רק מכתובות IP מסוימות של המקור, מנהל Databricks חייב לעדכן את רשימות הגישה לפי IP של החשבון או סביבת העבודה הרלוונטיים, את בקרות התעבורה הנכנסת מבוססות ההקשר, את חומת האש או כללי רשת אחרים שבשליטת הלקוח.

    • אפשרו חיבורים נכנסים מטווחי כתובות ה-IP היוצאות של אפליקציות ChatGPT העדכניים.

    • הגדירו את רשימת ההיתרים הזו ב-Databricks או בשכבת הרשת שבשליטת הלקוח. רשימה זו נפרדת מרשימת כתובות ה-IP המותרות של ה-workspace ב-ChatGPT.

    • הטווחים המתפרסמים עשויים להשתנות. במידת האפשר, הגדירו עדכונים אוטומטיים מקובץ ה-JSON.

    • אל תחליפו את סוד הלקוח ואל תשנו את היקפי הרשאת ה-OAuth כדי לעקוף חסימת רשת. תחילה בדקו אם Databricks דוחה את כתובות ה-IP שמהן האפליקציה מתחברת.

מקורות

האם המאמר הזה היה מועיל?