הגדרת מאגר נתונים ב-GitHub

בדף הזה מוסבר איך ליצור מאגר מידע ולקשר את GitHub ל-Gemini Enterprise.

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

לפני שמגדירים את החיבור ל-GitHub, צריך לוודא שיש לכם את הדברים הבאים:

  • נותנים את תפקיד העורך של Discovery Engine ‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להעניק את התפקיד הזה:

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

      כניסה לדף IAM

    2. מאתרים את חשבון המשתמש ולוחצים על עריכה עריכה.
    3. מקצים למשתמש את התפקיד Discovery Engine Editor. למידע נוסף, ראו תפקידים והרשאות ב-IAM.

  • נכנסים לחשבון ב-GitHub ומקבלים פרטי אימות.

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

יצירת מאגר נתונים ב-GitHub

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

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

    ‫Gemini Enterprise

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

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

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

  5. בקטע Source, מחפשים את GitHub ולוחצים על Select.

  6. בקטע נתונים:

    1. בקטע הגדרות אימות, מזינים את הפרטים הבאים:

      • מזהה לקוח: מזהה הלקוח ב-OAuth של האפליקציה.
      • סוד הלקוח: הסוד של לקוח OAuth לאפליקציה.

      מידע נוסף על פרטי הכניסה זמין במאמר בנושא הגדרת GitHub.

    2. לוחצים על Log in (כניסה) ומשלימים את הכניסה ל-GitHub ואת תהליך ההרשאה.

    3. בקטע Advanced options (אפשרויות מתקדמות), מזינים את שם הארגון ב-GitHub בשדה Organization Name (שם הארגון). הפעולה הזו נדרשת כדי להגדיר את היקף החיפוש והפעולות.

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

    5. בקטע Entities to search (ישויות לחיפוש), בוחרים את כל הישויות הנדרשות.

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

  8. בקטע Actions, באפשרות Select GitHub actions to enable, בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.

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

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

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

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

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

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

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

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

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

טיפול בנתונים והרצת שאילתות

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

ביצוע שאילתה

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

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

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

כשמשתמשים בחיפוש מאוחד של צד שלישי, חלים הכללים הבאים לטיפול בנתונים:

  • מחרוזת השאילתה נשלחת למערכת הבק-אנד של צד שלישי לחיפוש (GitHub API).
  • הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
  • אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
  • אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.

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