הגדרת מאגר נתונים של Gmail

בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Gmail ל-Gemini Enterprise.

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

  • נכנסים למסוף Google Cloud באמצעות אותו חשבון שבו משתמשים במופע Google Workspace שרוצים לקשר. חיפוש מבוסס-Vertex AI משתמש במספר הלקוח שלכם ב-Google Workspace כדי להתחבר ל-Gmail.

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

  • לפני שמוסיפים פעולות למאגר הנתונים של Gmail, Google Cloud אדמין צריך קודם להשלים את השלבים שבקטע הגדרת אימות והרשאות ל-Gmail כדי להגדיר אימות OAuth 2.0, לקבל את מזהה הלקוח ואת סוד הלקוח ולהגדיר הרשאות מינימליות.

יצירת מאגר נתונים של Gmail

כדי ליצור את מאגר הנתונים של Gmail, פועלים לפי השלבים הבאים:

  1. במסוף Google Google Cloud , עוברים לדף Gemini Enterprise.

    ‫Gemini Enterprise

  2. בוחרים פרויקט קיים או יוצרים פרויקט חדש ב- Google Cloud .

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

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

  5. בשדה מקור, מחפשים את Gmail ולוחצים על בחירה.

  6. בקטע פעולות:

    1. מזינים את מזהה הלקוח ואת סוד הלקוח שהתקבלו מאפליקציית OAuth 2.0, ואז לוחצים על אימות הרשאה.

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

    2. אופציונלי: מרחיבים את ההגדרות המתקדמות ומזינים את שם השירות, שהוא שם המשאב של השירות שיצרתם בספריית השירותים. חובה למלא את השדה הזה כשמופעל VPC Service Controls.

    3. בוחרים את הפעולות מהרשימה כדי להפעיל אותן עבור מחבר Gmail.

    במאמר ניהול פעולות מוסבר איך לנהל את רשימת הפעולות.

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

  8. בקטע Configuration (הגדרה):

    1. ברשימה מספר אזורים, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה שם מחבר הנתונים, מזינים שם למחבר.
    3. אם בחרתם במיקום us או eu, צריך להגדיר את הגדרות ההצפנה:
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות מפתח Cloud KMS:
        • ברשימה Key management type, בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key בוחרים את המפתח.
      מידע נוסף זמין במאמר בנושא מפתחות הצפנה בניהול הלקוח.

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

  10. בקטע Billing, בוחרים באפשרות General pricing או Configurable pricing. מידע נוסף זמין במאמרים אימות סטטוס החיוב של הפרויקטים ורישיונות.

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

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

אחרי שיוצרים את מאגר הנתונים, צריך ליצור אפליקציה ולקשר אותה למאגר הנתונים של Gmail לפני שמריצים את השאילתה.

הרצת שאילתה

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

אחרי שנותנים הרשאה ל-Gmail ושולחים שאילתת חיפוש ל-Gemini Enterprise:

  • ‫Gemini Enterprise שולח את שאילתת החיפוש שלכם ישירות אל Gmail API.
  • ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

הודעות שגיאה ופתרון בעיות

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

קוד שגיאה הודעת השגיאה תיאור פתרון בעיות
‫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 Workspace אמורים להיות בארגונים שונים.
‫403 (ההרשאה נדחתה) מנהל חשבון ארגוני השבית את הגישה למרחב של הסוכן ב-Workspace. אדמין ב-Google Workspace השבית את הגישה של Gemini Enterprise לנתוני Google Workspace. כדי לקבל גישה, צריך לפנות לאדמין ב-Google Workspace.

המאמרים הבאים