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

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

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

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

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

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

      כניסה לדף IAM

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

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

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

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

כדי ליצור מאגר נתונים ב-GitHub:

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

    Gemini Enterprise

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

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

  4. ‫Create data store.

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

  6. בקטע נתונים > הגדרות אימות:

    1. מזינים את פרטי הכניסה של הלקוח:

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

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

    2. אם המשתמשים נכנסים דרך ספק זהויות (IdP), כמו GitHub Enterprise Managed Users‏ (EMU), צריך להזין את פרטי הכניסה של GitHub SSO. אחרת, משאירים את השדות האלה ריקים.

      • היקף ה-SSO של GitHub: מרחב השמות של GitHub ששולט בכניסה. אם ספק הזהויות מוגדר ברמת הארגון, בוחרים באפשרות enterprises. אם ה-IdP מוגדר ברמת הארגון, בוחרים באפשרות orgs.

      • ‫GitHub SSO Slug: ה-slug של הארגון או המיזם ב-GitHub, לדוגמה octocorp לכתובת ה-URL של המיזם https://github.com/enterprises/octocorp. צריך להזין רק את החלק האחרון של כתובת ה-URL, ולא את הכתובת המלאה.

    3. לוחצים על Verify Auth (אימות ההרשאה) ומשלימים את אימות ההרשאה של GitHub.

  7. בקטע נתונים> אפשרויות מתקדמות:

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

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

  8. בקטע נתונים > ישויות לחיפוש:

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

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

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

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

      כדי לנהל את רשימת הפעולות, עיינו במאמר ניהול פעולות.

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

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

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

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

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

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

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

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

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

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

הרצת שאילתות

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

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

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

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

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

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