בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Google Drive ל-Gemini Enterprise. החיבור הזה מאפשר ל-Gemini Enterprise לאחזר מידע ישירות מ-Google Drive. מכיוון שהנתונים לא מועתקים לאינדקס של Gemini Enterprise, אתם לא צריכים לנהל את אחסון הנתונים.
לפני שמתחילים
כדי להכין את סביבת Google Drive לפני שיוצרים את מאגר הנתונים:
אתם צריכים להיכנס למסוף Google Cloud באמצעות אותו חשבון שבו אתם משתמשים במופע של Google Drive שאתם מתכננים לחבר. כדי להתחבר ל-Google Drive, Gemini Enterprise משתמש במספר הלקוח שלכם ב-Google Workspace. לחשבונות Google אישיים (חשבונות של משתמשים פרטיים עם הסיומת
@gmail.com) אין מספר לקוח ואין להם תמיכה.כדי לאכוף את בקרת הגישה למקורות הנתונים ולאבטח את הנתונים ב-Gemini Enterprise, ודאו שהגדרתם את ספק הזהויות.
מוודאים שכל המסמכים נגישים, על ידי העברה שלהם לאחסון שיתופי שבבעלות הדומיין או על ידי הקצאת הבעלות למשתמש בדומיין.
הפעלת הגישה ל-Gemini Enterprise ב-Google Workspace: בGoogle מסוף Admin, אדמין ב-Google Workspace בארגון שבו נמצאים המשתמשים ומיקום אחסון הנתונים של Google Drive צריך להפעיל את ההגדרה אפשר לתת ל-Gemini Enterprise גישה לנתוני Google Workspace. אם ההגדרה הזו מושבתת, החיפושים ב-Google Drive לא מחזירים תוצאות באפליקציית האינטרנט של Gemini Enterprise (ויכולים להחזיר שגיאת
403 Permission Denied: Workspace access for Agentspace disabled by organization admin.ב-API). איך שולטים בגישה של Gemini Enterprise לנתוני Google Workspaceמפעילים את התכונות החכמות: בחשבון Google Workspace, מפעילים את ההגדרות תכונות חכמות ב-Google Workspace ותכונות חכמות במוצרים אחרים שלGoogle . פרטים נוספים זמינים במאמר איך מפעילים או משביתים את התכונות החכמות ב-Google Workspace.
הוספת אפליקציית OAuth לרשימת ההיתרים: מאגר הנתונים של Google Drive משתמש באפליקציית OAuth שמנוהלת על ידי Googleכדי לגשת לנתונים שלכם. אם בארגון שלכם יש הגבלות על הגישה לאפליקציות OAuth, האדמין ב-Google Workspace צריך להוסיף את האפליקציה הזו לרשימת ההיתרים של הארגון. כאן אפשר לקרוא איך מוסיפים לרשימת ההיתרים את אפליקציית OAuth שמנוהלת על ידי Google.
הגדרת גישה בין ארגונים (אם רלוונטי): כברירת מחדל, Gemini Enterprise מאפשר למשתמשים לחפש במאגר נתונים ב-Google Drive רק אם מזהה הלקוח של המשתמש ב-Google Workspace תואם לארגון של מאגר הנתונים ב-Google Drive ולפרויקט ב- Google Cloud . אם המשתמשים או הנתונים ב-Google Drive שייכים לארגון אחר ב-Google Workspace (לדוגמה, אם פרויקט Google Cloud נמצא בדומיין אחד והמשתמשים נכנסים מדומיין נפרד אחד או יותר ב-Google Workspace או מדיירים לבדיקה), צריך לבצע את השלבים הבאים:
- פונים לCloud Customer Care כדי להוסיף את מזהה הלקוח של כל ארגון ב-Google Workspace (לדוגמה,
C01234567) לרשימת ההיתרים של הפרויקט ב- Google Cloud . - מבקשים מהאדמין ב-Google Workspace בכל ארגון ב-Google Workspace להפעיל את ההגדרה אפשר לתת ל-Gemini Enterprise גישה לנתוני Google Workspace במסוף Admin של הארגון Google . לא מספיק להפעיל את ההגדרה הזו רק בארגון של הפרויקט Google Cloud . איך שולטים בגישה של Gemini Enterprise לנתונים ב-Google Workspace
בנוסף, אם המשתמשים צריכים למצוא מסמכים שבבעלות גורמים מחוץ לארגון שלהם, צריך להפעיל את האפשרות הכללת מסמכים מדומיינים שונים באפליקציה. אפשר לבחור באפשרות הזו כשיוצרים את האפליקציה או להפעיל אותה מאוחר יותר בקטע ניהול התכונות של אפליקציית האינטרנט.
- פונים לCloud Customer Care כדי להוסיף את מזהה הלקוח של כל ארגון ב-Google Workspace (לדוגמה,
יצירת מאגר הנתונים ב-Google Drive
כדי ליצור את מאגר הנתונים ב-Google Drive:
במסוף Google Google Cloud , נכנסים לדף Gemini Enterprise.
בוחרים או יוצרים פרויקט ב- Google Cloud .
בתפריט הניווט, לוחצים על מאגרי נתונים.
לוחצים על Create data store.
בקטע מקור, מחפשים את Google Drive ולוחצים על בחירה.
אופציונלי: בקטע Data, מגדירים מסננים שקובעים את היקף התוכן ב-Google Drive שמאגר הנתונים מחפש. כדי להגדיר מסננים באמצעות מסוף Google Cloud או API בארכיטקטורת REST, בוחרים באחת מהאפשרויות הבאות:
המסוף
- בשדה מזהי תיקיות אחסון שיתופי, בשדה מזהי תיקיות או בשניהם, מזינים את המזהים שרוצים לסנן לפיהם.
- בכל שדה, בוחרים באפשרות Include כדי לחפש רק את המזהים שצוינו, או באפשרות Exclude כדי להשמיט אותם מהחיפוש. מגדירים לכל שדה מצב Include או מצב Exclude, אבל לא את שניהם.
- כדי לאתר מזהה של תיקייה או של אחסון שיתופי, פותחים את התיקייה או את האחסון השיתופי ב-Google Drive ומעתיקים את המזהה מכתובת ה-URL. כתובת ה-URL היא בפורמט הזה:
https://drive.google.com/drive/folders/ID. לדוגמה,https://drive.google.com/drive/folders/123456789012345678901.
API בארכיטקטורת REST
כדי ליצור מאגר נתונים עם מסננים, מפעילים את השיטה
setUpDataConnector.רשימות ההכללה מוגדרות בקטע
admin_filterורשימות ההחרגה מוגדרות בקטעadmin_exclusion_filter. לכל סוג מסנן, מאכלסים את הרשימה בקטעadmin_filterאו בקטעadmin_exclusion_filter, אבל לא בשניהם.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \ -d '{ "collectionId": "COLLECTION_ID", "collectionDisplayName": "COLLECTION_DISPLAY_NAME", "dataConnector": { "dataSource": "google_drive", "params": { "FILTER_TYPE": { "FILTER_KEY": [ "FILTER_VALUE_1", "FILTER_VALUE_2" ] } }, "entities": [ { "entityName": "google_drive" } ], "connectorModes": [ "FEDERATED" ] } }'
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט. -
ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:-
usלאזור הגיאוגרפי שכולל מספר אזורים בארה"ב -
euלמספר אזורים באיחוד האירופי -
globalלמיקום הגלובלי
-
-
LOCATION: האזור של מאגר הנתונים:globalאוus. -
COLLECTION_ID: המזהה הייחודי של מאגר הנתונים. -
COLLECTION_DISPLAY_NAME: השם המוצג של מאגר הנתונים. -
FILTER_TYPE: סוג המסנן,admin_filterלהכללה אוadmin_exclusion_filterלהחרגה. צריך לאכלס את הרשימה ב-admin_filterאו ב-admin_exclusion_filter, אבל לא בשניהם. -
FILTER_KEY: הישות ב-Drive שרוצים לסנן לפיה,SharedDriveIdsאוFolderIds. -
FILTER_VALUE_1,FILTER_VALUE_2: מזהי התיקיות או האחסון השיתופי שרוצים לסנן לפיהם.
בקטע פעולות, בוחרים את הפעולות מהרשימה כדי להפעיל אותן במחבר של Google Drive.
כדי לנהל את רשימת הפעולות, עיינו בקטע ניהול פעולות.
לוחצים על Continue.
בקטע Configuration (הגדרה):
- ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
- בשדה שם מחבר הנתונים, נותנים שם למחבר.
- אם בחרתם ב-
usאו ב-euבתור המיקום, הגדירו את הגדרות ההצפנה:- בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
- אם בחרתם באפשרות Cloud KMS key:
- ברשימה Key management type, בוחרים את הסוג המתאים.
- ברשימה Cloud KMS key, בוחרים את המפתח.
אופציונלי: בשדה Tag, מזינים מזהה יציב למאגר הנתונים. המזהה הזה משמש בגרסאות שונות של המחבר, ואי אפשר לשנות אותו אחרי שיוצרים את מאגר הנתונים. לכן, בחרו ערך שלא תצטרכו לשנות בהמשך.
אופציונלי: בקטע מדיניות Sensitive Data Protection, מצרפים מדיניות תוכן קיימת של Sensitive Data Protection כדי לבדוק ולחסום מידע רגיש ש-Gemini Enterprise מאחזר דרך מאגר הנתונים הזה. מידע נוסף זמין במאמר הגנה על מידע אישי רגיש במקורות. אם בארגון שלכם לא נדרשת מדיניות תוכן של Sensitive Data Protection, אתם יכולים לדלג על השלב הזה.
לוחצים על יצירה. Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף Data Stores.
כדי לבדוק את מצב מאגר הנתונים:
- עוברים למחבר ברשימת מאגרי הנתונים ועוקבים אחרי הסטטוס שלו עד שהוא משתנה לפעיל.
- כשהסטטוס של מאגר הנתונים משתנה מבשלבי יצירה לפעיל, אפשר להשתמש במחבר של Google Drive.
אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה ומקשרים אותה למאגר הנתונים ב-Google Drive לפני שמריצים את השאילתה.
הרצת שאילתות
אחרי שנותנים הרשאה ל-Google Drive, כשמזינים שאילתת חיפוש:
Gemini Enterprise שולח את שאילתת החיפוש שלכם אל Google Drive API.
Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות אחרים ומציג אותן.
הודעות שגיאה ופתרון בעיות
בטבלה הבאה מתוארות הודעות שגיאה, כולל קודי שגיאות HTTP והצעות לפתרון בעיות, שאפשר להיתקל בהן במהלך העבודה עם מקור הנתונים הזה של Google .
| קוד שגיאה | הודעת השגיאה | תיאור | פתרון בעיות |
|---|---|---|---|
| 403 אין לך הרשאה | אי אפשר לחפש באמצעות פרטי כניסה של חשבון שירות במאגרי נתונים של Google Workspace. | במנוע החיפוש יש מאגרי נתונים של Google Workspace, ופרטי הכניסה שהועברו הם של חשבון שירות. אי אפשר לחפש במאגרי נתונים של Google Workspace באמצעות פרטי כניסה לחשבון שירות. | מפעילים חיפוש באמצעות פרטי הכניסה של המשתמש, או מסירים את מאגרי הנתונים של Google Workspace מהמנוע. |
| 403 אין לך הרשאה | אי אפשר להשתמש בחשבונות פרטיים במאגרי נתונים של Google Workspace. | החיפוש מתבצע באמצעות פרטי כניסה של חשבון פרטי (@gmail.com), שלא נתמך במאגרי נתונים של Google Workspace. | צריך להסיר את מאגרי הנתונים של Google Workspace מהמנוע או להשתמש בחשבון מנוהל Google . |
| 403 אין לך הרשאה | מספר הלקוח לא תואם למאגר הנתונים | החיפוש מותר רק למשתמשים שמזהה הלקוח שלהם ב-Google Workspace תואם לארגון של מאגר הנתונים של Google Workspace ושל פרויקט Google Cloud , אלא אם מזהה הלקוח של המשתמש ב-Google Workspace נמצא ברשימת ההיתרים של הפרויקט. | אם חוסר ההתאמה לא מכוון, צריך ליצור מחדש את מאגר הנתונים בפרויקט Google Cloud ששייך לאותו ארגון כמו המשתמשים ב-Google Workspace, או להסיר מהאפליקציה את מאגר הנתונים של Google Workspace. אם המשתמשים ומאגר הנתונים של Google Workspace אמורים להיות בארגונים שונים, צריך לפנות לCloud Customer Care כדי להוסיף את מזהה הלקוח של כל משתמש ב-Google Workspace לרשימת ההיתרים של הפרויקט ב- Google Cloud , ולוודא שאדמין ב-Google Workspace בכל ארגון של משתמש מפעיל את הגישה של Gemini Enterprise לנתוני Google Workspace. בנוסף, אם המשתמשים צריכים למצוא מסמכים שבבעלות גורמים מחוץ לארגון, צריך להפעיל את האפשרות הכללת מסמכים מדומיינים אחרים בקטע ניהול התכונות של אפליקציית האינטרנט. |
| 403 אין לך הרשאה | הגישה של Agentspace ל-Workspace הושבתה על ידי מנהל חשבון ארגוני. | אדמין ב-Google Workspace בארגון של המשתמש ב-Google Workspace השבית את הגישה לנתוני Google Workspace ב-Gemini Enterprise. יכול להיות שהשגיאה הזו לא תוצג ישירות באתר Gemini Enterprise, ובמקום זאת, השאילתות לא יחזירו קבצים תואמים ב-Google Drive. | פנו לאדמין ב-Google Workspace של הארגון של המשתמש כדי להפעיל את הגישה. בהגדרות שכוללות כמה ארגונים, צריך להפעיל את ההגדרה הזו במסוף Admin של כל ארגון ב-Google Workspace שהמשתמשים שלו שולחים שאילתות ל-Google Drive. Google |
| 400 ארגומנט לא תקין | הבקשה מכילה ארגומנט לא תקין. | השגיאה הזו מתרחשת אם השם של מחבר הנתונים בבקשה לא עומד בדרישות למתן שמות. מוודאים שהשם של מחבר הנתונים תקין: הוא צריך להיות באורך של 1 עד 63 תווים, להתחיל באות קטנה, להסתיים באות קטנה או בספרה, ולהכיל רק אותיות קטנות, ספרות, מקפים או קווים תחתונים. לדוגמה, השתמשו בשם כמו cymbal-collection-123456789 במקום 123456789-cymbal-collection. |
|
אם אתם נתקלים בבעיות נפוצות בחיפוש כשאתם שולחים שאילתות לנתונים ב-Google Drive, עיינו במאמר בעיות נפוצות בחיפוש.
המאמרים הבאים
- כדי לספק ממשק משתמש לשליחת שאילתות לגבי הנתונים, יוצרים אפליקציה ומקשרים אותה למאגר הנתונים של Google Drive.
- כדי להוסיף או לעדכן מסננים של תיקיות ואחסון שיתופי במאגר הנתונים, קראו את המאמר הוספת מסננים למאגר נתונים ב-Google Drive.
- כדי לראות איך תוצאות החיפוש יופיעו אחרי הגדרת האפליקציה, עיינו בקטע קבלת תוצאות חיפוש.
- כדי להפעיל התראות למאגר הנתונים, עיינו במאמר הגדרת התראות למאגרי נתונים של צד שלישי.
- אם האפליקציה לא הוגדרה בהתחלה לכלול מסמכים מדומיינים שונים, צריך להפעיל את התכונה הכללת מסמכים מדומיינים שונים בהגדרות של ניהול התכונות של אפליקציית האינטרנט. מידע נוסף זמין במאמר ניהול התכונות של אפליקציות אינטרנט.