Connect Box

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

בדף הזה מוסבר איך לקשר את Box ל-Gemini Enterprise. המחבר תומך גם בהטמעת נתונים וגם בחיפוש מאוחד. אפשר לעיין בקטע שמתאים לגישה שבה אתם מתכננים להשתמש:

• תיבת חיבור (הטמעת נתונים)
• חיבור של חיפוש מאוחד ל-Box

תיבת חיבור (הטמעת נתונים)

כדי לסנכרן נתונים מ-Box עם Gemini Enterprise, צריך לבצע את השלבים הבאים.

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

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

לפני שמגדירים את החיבור:

1. צריכה להיות לכם הרשאת אדמין במופע של Box, עם אימות דו-שלבי מופעל. אפשר לבצע את כל הוראות ההגדרה רק מחשבון האדמין.

2. מגדירים בקרת גישה למקור הנתונים. מידע על הגדרת בקרת גישה זמין במאמר בנושא שימוש בבקרת גישה למקורות נתונים.

3. במאמר הגדרה באמצעות JWT במסמכי התיעוד של Box מופיע סקירה כללית של ההגדרה, עם צילומי מסך.

יצירת אפליקציית Box

1. נכנסים למסוף המפתחים של Box באמצעות חשבון האדמין.
2. לוחצים על יצירת אפליקציה לפלטפורמה.
3. בוחרים באפשרות סוג האפליקציה בתור אפליקציה בהתאמה אישית.
4. מזינים את שם האפליקציה.
5. מגדירים את המאפיינים הבאים:
   1. מטרה: שילוב
   2. קטגוריות: AI
   3. מערכת חיצונית: Google Cloud Gemini Enterprise

6. בוחרים באפשרות שיטת אימות בתור אימות שרת (עם JWT).

   

   בוחרים באפשרות Server authentication (with JWT) (אימות שרת (עם JWT)).

7. לוחצים על יצירת אפליקציה.

הגדרת אפליקציית Box

1. ב-Box Developer Console, בוחרים באפשרות Platform app (אפליקציית פלטפורמה) ועוברים לכרטיסייה Configuration (הגדרה).

2. בקטע רמת הגישה לאפליקציה, בוחרים באפשרות גישה לאפליקציה + גישה לארגון.

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

3. בקטע Application scopes, בוחרים בהיקפים הבאים:

   1. ההרשאה Read all files and folders stored in Box (קריאת כל הקבצים והתיקיות שמאוחסנים ב-Box) נדרשת כדי לאחזר הערות ומשימות ולצפות בתצוגה מקדימה של קבצים, אבל היא לא מספיקה כדי להוריד קבצים.

   2. ההרשאה Write all files and folders stored in Box (כתיבה של כל הקבצים והתיקיות שמאוחסנים ב-Box) נדרשת להורדת קבצים, ובחירה בה מעניקה באופן אוטומטי גישה להרשאה Read all files (קריאה של כל הקבצים). למרות שההיקף של ההרשאה רחב ומאפשר טכנית ליצור ולשנות קבצים, היא משמשת אך ורק להורדת קבצים.

   3. כדי לאחזר את רשימת המשתמשים, שמאפשרת לאחזר קבצים, הערות ומשימות מחשבונות משתמשים פרטיים, צריך את ההרשאה ניהול משתמשים.

   4. נדרשת גם ההרשאה ניהול קבוצות כדי לאחזר את רשימת הקבוצות והחברים שלהן. זה חשוב מאוד לבקרת גישה, כי צריך לזהות את החברים בקבוצות ב-Box כדי לשתף איתן פריטים.

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

4. בקטע תכונות מתקדמות, בוחרים באפשרות Make API calls using the as-user header.

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

   

   מגדירים את אפליקציית Box.

5. בקטע הוספה וניהול של מפתחות ציבוריים, לוחצים על יצירת זוג מפתחות ציבורי/פרטי.

   1. המפתח הציבורי מועלה אוטומטית למסוף עם מזהה. המזהה הזה משמש ליצירת חיבור.
   2. אתם יכולים להוריד קובץ תצורה עם המפתח הפרטי וסיסמת הגישה. חשוב לשמור את הקובץ הזה לשימוש עתידי.

   3. אופציונלי: כדי ליצור מפתח משלכם, אפשר לעיין במדריך להגדרת צמד מפתחות של Box.

      

      ניהול המפתחות.

6. לוחצים על שמירת השינויים.

איך נותנים הרשאה לאפליקציית Box

1. ב-Box Developer Console, בוחרים באפשרות Platform app (אפליקציית פלטפורמה) ואז עוברים לכרטיסייה Authorization (הרשאה).
2. לוחצים על בדיקה ושליחה.

3. בתיבת הדו-שיח Review app authorization submission (בדיקת בקשת הרשאה לאפליקציה), לוחצים על Submit (שליחה).

   

   מאשרים את הרשאת הגישה לאפליקציית Box.

   אם בקשת ההרשאה נשלחת בהצלחה, מוצגת הודעת האישור הבאה:

   

   בקשת ההרשאה נשלחה בהצלחה.

4. נכנסים למנהל האפליקציות בפלטפורמת האדמין של Box באמצעות חשבון האדמין.

5. בוחרים את אפליקציית הפלטפורמה שהגדרתם.

6. לוחצים על סמל האפשרויות הנוספות (...) בשורה המתאימה.

7. בוחרים באפשרות הרשאת גישה לאפליקציה מהתפריט הנפתח.

8. בתיבת הדו-שיח אישור האפליקציה, לוחצים על אישור כדי להשלים את תהליך האישור.

   

   לוחצים על 'הרשאה'.

כדאי להכין את פרטי האימות הבאים של Box:

• ‫Enterprise ID: משיגים אותו מהכרטיסייה General settings (הגדרות כלליות).

  

  איך מקבלים את מזהה ה-Enterprise

• מזהה לקוח וסוד לקוח: מקבלים אותם מהכרטיסייה Configuration (הגדרה) בקטע OAuth 2.0 credentials (פרטי כניסה ל-OAuth 2.0).

  

  מקבלים את הגדרות הלקוח.

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

  

  הוספה וניהול של מפתחות ציבוריים.

יצירת מחבר Box

המסוף

כדי להשתמש במסוף Google Cloud כדי לסנכרן נתונים מ-Box אל Gemini Enterprise, צריך לבצע את השלבים הבאים:

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   ‫Gemini Enterprise

2. בתפריט הניווט, לוחצים על מאגרי נתונים.

3. לוחצים על יצירת מאגר נתונים.

4. בדף בחירת מקור נתונים, גוללים או מחפשים את Box כדי לקשר את מקור הצד השלישי.

5. מזינים את פרטי האימות בהגדרות האימות. בשדה Private key, מעתיקים ומדביקים את ערך המפתח הפרטי הבא.

    -----BEGIN ENCRYPTED PRIVATE KEY-----\nMIIFLTBXBgkqhkiG9w0BBQ0wSjApBgkqhkiGK7wbIkVf2jW\n-----END ENCRYPTED PRIVATE KEY-----\n
   

6. בוחרים את הישויות שרוצים לסנכרן ולוחצים על המשך.

7. בוחרים את תדירות הסנכרון של סנכרון מלא ואת תדירות הסנכרון המצטבר של סנכרון מצטבר של נתונים. מידע נוסף זמין במאמר בנושא תזמון סנכרון.

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

   

   הגדרת תזמונים נפרדים לסנכרון מלא של ישויות ולסנכרון מלא של זהויות.

8. בוחרים אזור למאגר הנתונים.

9. מזינים שם למאגר הנתונים.

10. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף מאגרי נתונים.

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

    בהתאם לגודל הנתונים, ההטמעה יכולה להימשך דקות או שעות.

השלבים הבאים

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

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

• כדי להפעיל התראות למאגר הנתונים, אפשר לעיין במאמר הגדרת התראות למאגרי נתונים של צד שלישי.

חיבור חיפוש מאוחד ל-Box

כדי לחפש בחשבון Box באמצעות חיפוש מאוחד, פועלים לפי השלבים הבאים.

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

מידע על איחוד נתונים

באיחוד נתונים, Gemini Enterprise מאחזר ישירות מידע ממקורות נתונים של צד שלישי באמצעות ממשקי API, במקום להעתיק את הנתונים ל-Gemini Enterprise. באמצעות הגישה הזו, תוכלו לגשת למקורות נתונים חיצוניים באופן מיידי, בלי לחכות להטמעה.

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

לפני שיוצרים מאגר נתונים של Box ב-Gemini Enterprise, צריך לרשום אפליקציית OAuth 2.0 ב-Box Developer Console.

כדי לרשום את האפליקציה:

1. נכנסים למסוף המפתחים של Box באמצעות חשבון האדמין.

2. לוחצים על Create Platform App.

   

   יצירת אפליקציה חדשה לפלטפורמה.

3. לוחצים על אפליקציה בהתאמה אישית.

4. ממלאים את שדות החובה.

   

   צריך לספק פרטים על האפליקציה.

5. בוחרים באפשרות אימות משתמש (OAuth 2.0).

   

   בוחרים את שיטת האימות.

6. לוחצים על יצירת אפליקציה.

7. מעתיקים את מזהה הלקוח ואת הסוד של הלקוח. הם נדרשים כדי ליצור מאגר נתונים של חיפוש מאוחד עם Box ב-Gemini Enterprise.

   

   רושמים את פרטי הכניסה של OAuth 2.0.

8. בקטע OAuth 2.0 Redirect URIs, מוסיפים את כתובות ה-URI הבאות להפניה אוטומטית:

   • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html
   • https://vertexaisearch.cloud.google.com/oauth-redirect

   

   צריך לספק את מזהי ה-URI להפניה אוטומטית.

9. בוחרים את היקפי האפליקציה הבאים:

   • קריאת כל הקבצים והתיקיות שמאוחסנים ב-Box
   • כתיבה של כל הקבצים והתיקיות שמאוחסנים ב-Box

   

   בוחרים את ההיקפים הנדרשים.

10. לוחצים על שמירת השינויים.

יצירת מחבר לחיפוש מאוחד באמצעות Box

המסוף

כדי לבצע חיפוש מאוחד ב-Box מ-Gemini Enterprise, צריך לפעול לפי השלבים הבאים במסוף Google Cloud :

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   ‫Gemini Enterprise

2. בתפריט הניווט, לוחצים על מאגרי נתונים.

3. לוחצים על יצירת מאגר נתונים.

4. בדף בחירת מקור נתונים, גוללים או מחפשים את Box Federated כדי לקשר את המקור מצד שלישי.

   

   מחפשים Box Federated

5. בקטע הגדרות אימות:

   1. מזינים את מזהה הלקוח ואת הסוד של הלקוח.
   2. לוחצים על אימות.

   3. לוחצים על Continue.

      

      מזינים את פרטי האימות

6. בוחרים אזור למקור הנתונים.

7. מזינים שם למקור הנתונים.

   

   הגדרת מחבר הנתונים

8. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף מאגרי נתונים.

אחרי שיוצרים את מאגר הנתונים, עוברים לדף Data Stores (מאגרי נתונים) ולוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. אם מצב המחבר משתנה מיצירה לפעיל, מחבר החיפוש המאוחד מוכן לשימוש.

הרשאת משתמש

אחרי שיוצרים מאגר נתונים של חיפוש מאוחד, הוא מופיע ברשימה של מקורות הנתונים בחלונית לניהול מקורות. אם לא אישרתם בעבר את Gemini Enterprise, לא תוכלו לבחור את מקור הנתונים. במקום זאת, מופיע לידו לחצן אישור.

כדי להתחיל את תהליך ההרשאה:

1. לוחצים על Authorize. תופנו לשרת ההרשאות של Box.

   

   לוחצים על Authorize (אישור)

2. נכנסים לחשבון Box.

3. לוחצים על הענקת גישה. אחרי שתעניקו גישה, תועברו חזרה אל Gemini Enterprise כדי להשלים את תהליך ההרשאה.

   ‫Gemini Enterprise מקבל את access_token ומשתמש בו כדי לגשת לחיפוש של צד שלישי.

ביצוע שאילתה

כשמזינים שאילתת חיפוש:

• אם החיפוש המאוחד ב-Box מורשה, Gemini Enterprise שולח את השאילתה ל-Box API.
• ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות אחרים ומציג אותן.

טיפול בנתונים

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

אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו (ולא לתנאים של Google Cloud).

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