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

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

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

לפני שמגדירים את מאגר הנתונים של Zendesk, צריך לוודא את הדברים הבאים:

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

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

      כניסה לדף IAM

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

  2. יוצרים לקוח OAuth ומקבלים את פרטי הכניסה הבאים:

    • מזהה לקוח

    • סוד לקוח

  3. מגדירים את ההרשאות הנדרשות ב-Zendesk לאפליקציית OAuth.

  4. מוודאים שהגישה לטוקן מופעלת בהגדרות של Zendesk API.

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

כדי ליצור את מאגר הנתונים של Zendesk:

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

    Gemini Enterprise

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

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

  4. לוחצים על Create data store.

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

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

    1. בקטע Authentication settings, מזינים את הפרטים הבאים: * Instance URI: מזינים את ה-URI של המכונה ב-Zendesk (לדוגמה, https://[subdomain].zendesk.com). * Client ID: המזהה הייחודי של האפליקציה שרשומה ב-Zendesk. ‫* סוד לקוח: המפתח הסודי שנוצר במהלך תהליך הרישום של אפליקציית OAuth 2.0 ב-Zendesk.

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

    2. לוחצים על Login (כניסה) ומשלימים את תהליך הכניסה ל-Zendesk.

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

    4. בקטע יעדים:

      1. שרת proxy: מזינים את שם המארח או את כתובת ה-IP של שרת proxy שדרכו תנותב תנועת ה-HTTP, כולל המארח והיציאה.
      2. כתובת ה-URL לתמיכה של Zendesk: מזינים את כתובת ה-URL של המכונה, כולל https://, שהיא כתובת ה-URL לתמיכה של Zendesk.
      3. לוחצים על Continue.
    5. אופציונלי: בקטע אפשרויות מתקדמות:

      1. הפעלת כתובות IP סטטיות: רישום של קבוצה מצומצמת של כתובות IP סטטיות שיתווספו לרשימת ההיתרים של המערכת. הפעלות הסנכרון ייכשלו עד שכתובות ה-IP האלה יתווספו לרשימת ההיתרים. מידע נוסף זמין במאמר הגדרת תעבורת נתונים יוצאת עם כתובת IP סטטית.
      2. מספר מקסימלי של בקשות API לדקה: המספר המקסימלי של בקשות API לדקה שאפשר לשלוח למכונה של Zendesk בכל הפעלה של המחבר.
      3. לוחצים על Continue.
    6. בקטע ישויות לחיפוש, בוחרים את כל הישויות שרוצים לחפש בהן מהרשימה. צריך לבחור לפחות ישות אחת.

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

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

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

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

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

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

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

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

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

אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה, מקשרים אותה למאגר הנתונים של Zendesk ונותנים הרשאה ל-Gemini Enterprise ב-Zendesk לפני שמריצים שאילתות.

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

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

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

הרצת שאילתות

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

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

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

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

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

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