הערה: חבילת המסמכים הזו מיועדת למהדורות Standard,‏ Plus,‏ תשלום לפי שימוש ו-Frontline של Gemini Enterprise. לעיון במסמכי התיעוד של מהדורת Business, אפשר להיכנס אל מרכז העזרה של Gemini Enterprise – מהדורת Business.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

נותנים את תפקיד העורך של Discovery Engine ‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להעניק את התפקיד הזה:
1. נכנסים לדף IAM במסוף Google Cloud .
  כניסה לדף IAM
2. מאתרים את חשבון המשתמש ולוחצים על עריכה עריכה.
3. מקצים למשתמש את התפקיד Discovery Engine Editor. למידע נוסף, ראו תפקידים והרשאות ב-IAM.
כדי לאכוף את בקרת הגישה למקורות נתונים ולאבטח את הנתונים ב- Google Gemini Enterprise, צריך להגדיר את ספק הזהויות.
כדי להגדיר את מאגר הנתונים של Confluence Cloud, צריך להשתמש במודל החדש של Atlassian לניהול משתמשים באופן מרכזי. אם אתם משתמשים במודל המקורי, אתם צריכים להעביר את ניהול המשתמשים לפני שתמשיכו. למידע נוסף, ראו תפקיד אדמין האתר.
יוצרים אפליקציית OAuth 2.0, מקבלים את מזהה הלקוח ואת הסוד ומגדירים את ההרשאות המינימליות לאפליקציה בהסכמת אדמין של Confluence Cloud.
אופציונלי: כדי לאחזר כתובות אימייל של משתמשים מ-Confluence Cloud, גם אם ההגדרות מגבילות את חשיפת כתובות האימייל, מתקינים את אפליקציית User Identity Accessor for Confluence Cloud עם הרשאות של מנהל אתר ב-Confluence, ואז מגדירים אותה כדי לאחזר כתובות אימייל של משתמשים בצורה מאובטחת. יכול להיות שלא תצטרכו להתקין את האפליקציה הזו אם כתובות האימייל כבר נגישות לציבור.

הערה: חברת Atlassian מעדכנת את רכיבי ממשק המשתמש, וחלק מהרכיבים שמוזכרים במסמך הזה עוברים שינוי שם (לדוגמה, Products משנה את השם ל-Apps). מידע נוסף זמין במאמר שינוי במינוח של Atlassian Administration מ'מוצרים' ל'אפליקציות'.

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

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

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

‫Gemini Enterprise
בוחרים פרויקט קיים או יוצרים פרויקט חדש ב- Google Cloud .
בתפריט הניווט, לוחצים על מאגרי נתונים.
לוחצים על יצירת מאגר נתונים.
בקטע מקור, מחפשים את Confluence Cloud ולוחצים על בחירה.
בקטע נתונים:
1. בקטע מצב מחבר, בוחרים באפשרות העברת נתונים או חיפוש מאוחד כמצב החיבור.
2. לוחצים על Continue.
3. בקטע הגדרות אימות, מגדירים את האימות בהתאם למצב החיבור שנבחר.
  - אם בחרתם באפשרות העברת נתונים:
    1. בוחרים באפשרות פרטי כניסה של לקוחות ב-OAuth 2.0 או אסימון API כשיטת האימות.
    - אם בוחרים באפשרות פרטי כניסה של לקוח OAuth 2.0, מזינים את הפרטים הבאים:
      - מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
      - סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0 שלכם.
      - ‫Instance URI: כתובת ה-URL הבסיסית של מופע Confluence Cloud ( לדוגמה, https://your-domain.atlassian.net).
      - מזהה מופע: מזהה ייחודי של מופע Confluence Cloud.
    - אם בוחרים באפשרות טוקן API, מזינים את הפרטים הבאים:
      - ‫Instance URI: כתובת ה-URL הבסיסית של מופע Confluence Cloud ( לדוגמה, https://your-domain.atlassian.net).
      - חשבון משתמש: שם המשתמש ב-Atlassian שמשויך לאסימון ה-API.
      - טוקן API: טוקן ה-API שנוצר מחשבון Atlassian שלכם.
  - אם בחרתם באפשרות חיפוש מאוחד:
    1. מזינים את הפרטים הבאים:
      - מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
      - סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0 שלכם.
      - ‫Instance URI: כתובת ה-URL הבסיסית של מופע Confluence Cloud ( לדוגמה, https://your-domain.atlassian.net).
    2. לוחצים על Login (כניסה) ומשלימים את הכניסה לחשבון Atlassian.
  מידע נוסף על פרטי הכניסה זמין במאמר בנושא הגדרת Confluence Cloud.
4. לוחצים על Continue.
5. בקטע יעדים, מזינים את כתובת ה-URL של נקודת הקצה של Confluence Cloud.
6. לוחצים על Continue.
7. בקטע Entities to sync (אם בחרתם באפשרות הטמעת נתונים) או Entities to search (אם בחרתם באפשרות Federated search):
  1. בוחרים את כל הישויות הנדרשות.
  - אם בחרתם באפשרות חיפוש מאוחד, ממשיכים לשלב הבא.
  - אם בחרתם באפשרות הטמעת נתונים, מבצעים את הפעולות הבאות:
    1. אופציונלי: כדי לסנכרן פרויקטים ספציפיים, מבצעים את הפעולות הבאות:
      1. לוחצים על סינון.
      2. כדי לסנן ישויות מהאינדקס, בוחרים באפשרות החרגה מהאינדקס. כדי לוודא שהן נכללות באינדקס, בוחרים באפשרות הכללה באינדקס.
      3. מזינים את מקשי הרווח. מקישים על Enter אחרי כל מקש רווח. מקש הרווח הוא הקוד הייחודי בכתובת URL של מרחב ב-Confluence, והוא מופיע אחרי /spaces/. (לדוגמה, ב-https://company.atlassian.net/wiki/spaces/ABC/overview, מקש הרווח הוא ABC).
      4. לוחצים על Save.
    2. כדי להגדיר את תזמון הסנכרון:
      1. ברשימה תדירות הסנכרון, בוחרים את תדירות הסנכרון.
        
        כדי לתזמן סנכרון מלא נפרד של נתוני ישויות וזהויות, מרחיבים את התפריט בקטע סנכרון מלא ובוחרים באפשרות אפשרויות בהתאמה אישית.
      2. ברשימה Incremental sync frequency (תדירות הסנכרון המצטבר), בוחרים את תדירות הסנכרון המצטבר.
    מידע נוסף זמין במאמר בנושא תזמון סנכרון.
לוחצים על Continue.
בקטע פעולות:
- אם בחרתם באפשרות חיפוש מאוחד:
  1. בקטע Select Confluence Cloud actions to enable (בחירת פעולות ב-Confluence Cloud להפעלה), בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.
- אם בחרתם באפשרות העברת נתונים:
  1. בקטע הגדרות אימות, מגדירים את האימות בהתאם למצב החיבור שנבחר.
  2. מזינים את פרטי האימות הבאים:
    - מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
    - סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0 שלכם.
    - ‫Instance URI: כתובת ה-URL הבסיסית של מופע Confluence Cloud ( לדוגמה, https://your-domain.atlassian.net).
    - מזהה מופע: מזהה ייחודי של מופע Confluence Cloud.
    מידע נוסף על פרטי הכניסה זמין במאמר בנושא הגדרת Confluence Cloud.
  3. לוחצים על כניסה ונכנסים ל-Confluence Cloud כדי לאמת את החשבון.
  4. לוחצים על Continue.
  5. בקטע יעדים, מזינים את כתובת ה-URL של נקודת הקצה של Confluence Cloud.
  6. בקטע Select Confluence Cloud actions to enable (בחירת פעולות ב-Confluence Cloud להפעלה), בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.
  הערה: אם מדלגים על הוספת פעולות בשלב הזה, אפשר להוסיף אותן מאוחר יותר. מידע נוסף זמין במאמר בנושא הוספת פעולות.
  
  כדי לראות ולנהל את רשימת הפעולות, אפשר לעיין במאמר בנושא הצגה וניהול של פעולות.
לוחצים על Continue.
אם בתהליך ליצירת מאגר נתונים מופיע הקטע אפשרויות מתקדמות, אפשר לסמן את התיבה הפעלת כתובות IP סטטיות. כך מאפשרים למאגר הנתונים להשתמש בקבוצה קבועה של כתובות IP לתנועה יוצאת, שמתאימה להוספה לרשימת ההיתרים במערכת המקור. מידע נוסף מופיע במאמר בנושא הגדרת יציאה עם כתובת IP סטטית.
בקטע Configuration (הגדרה):
1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
2. בשדה Your data connector name (השם של מחבר הנתונים), מזינים שם למחבר.
3. אם בחרתם במיקום us או eu, צריך להגדיר את הגדרות ההצפנה:
  - אופציונלי: אם לא הגדרתם מפתחות של אזור יחיד, לוחצים על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר בנושא רישום מפתח של אזור יחיד למחברים של צד שלישי.
  - בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
  - אם בחרתם באפשרות מפתח Cloud KMS:
    - ברשימה Key management type (סוג ניהול המפתחות), בוחרים את הסוג המתאים.
    - ברשימה Cloud KMS key בוחרים את המפתח.
  מידע נוסף זמין במאמר בנושא מפתחות הצפנה בניהול הלקוח.
לוחצים על Continue.
בקטע Billing, בוחרים באפשרות General pricing או Configurable pricing. מידע נוסף זמין במאמרים אימות סטטוס החיוב של הפרויקטים ורישיונות.
לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף מאגרי נתונים.

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

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

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

הפעלת סנכרון בזמן אמת להעברת נתונים

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

ישויות ב-Confluence	יצירה	עדכון	מחיקה	שינויים בהרשאות
Spaces
Pages
בלוגים
קבצים מצורפים
תגובות
לוחות לבנים

מפעילים את הסנכרון בזמן אמת 20 דקות אחרי שיוצרים את מאגר הנתונים של Confluence Cloud.

כדי להפעיל סנכרון בזמן אמת למאגר נתונים של Confluence, פועלים לפי השלבים הבאים:

יצירת webhook URL

עוברים לדף Gemini Enterprise ובתפריט הניווט לוחצים על Data Stores (מאגרי נתונים).
בוחרים מאגר נתונים של Confluence.
לוחצים על הצגה/עריכה בשורה סנכרון בזמן אמת.
בתיבת הדו-שיח View and edit realtime sync parameters (הצגה ועריכה של פרמטרים של סנכרון בזמן אמת), מבצעים את הפעולות הבאות:
1. כדי להפעיל את הסנכרון בזמן אמת, לוחצים על המתג הפעלת סנכרון בזמן אמת.
2. בשדה Client secret (סוד לקוח), מזינים ערך placeholder, כמו clientsecret.
3. לוחצים על Save.
אחרי שהסטטוס של סנכרון בזמן אמת משתנה ל-Running, לוחצים על הצגה/עריכה.
בתיבת הדו-שיח View and edit realtime sync parameters (הצגה ועריכה של פרמטרים של סנכרון בזמן אמת), מבצעים את הפעולות הבאות:
1. מעתיקים את Webhook URL.
2. לוחצים על Close.

הרשמה לאירועים באמצעות ה-API

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

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

‫INSTANCE_URL: כתובת האינטרנט הבסיסית של האתר שלכם ב-Atlassian Cloud.
‫USERNAME: שם המשתמש ב-Atlassian Cloud.
‫API_TOKEN: טוקן ה-API שנוצר מחשבון Atlassian. מידע נוסף זמין במאמר בנושא הגדרת אסימון API ב-Confluence
‫SUBSCRIPTION_NAME: שם ייחודי למינוי לאירוע.
‫LISTENER_URL: כתובת ה-Webhook שהועתקה מהמסוף Google Cloud אחרי שהפעלתם את סנכרון בזמן אמת (RTS) במאגר הנתונים.

‫EVENT_TYPE: סוגי האירועים שרוצים להירשם אליהם. אתם יכולים להירשם כדי ליצור, לעדכן ולמחוק אירועים עבור קבצים מצורפים, פוסטים בבלוג, דפים, מרחבים ותגובות.

המשתמש יכול להירשם לאירועים הבאים:

space_created
space_updated
page_created
page_updated
attachment_created
attachment_updated
comment_created
comment_updated
blog_created
blog_updated

דוגמה לפקודה ולתוצאה

curl -X POST \
    https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
    -H "Content-Type: application/json" \
    -u "admin1:######" \
    -d '{
      "name": "Cymbal_DCT",
      "events": [
        "attachment_created",
        "attachment_updated"
      ],
      "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
      "active": true
    }'

{
"name": "Cymbal_DCT",
"url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
"description": " Webhook for Cymbal DCT group to fetch attachments.",
"excludeBody": false,
"filters": {},
"events": [
    "attachment_created",
    "attachment_updated",
],
"enabled": true,
"self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
"lastUpdatedUser": "Cymb_389",
"lastUpdatedDisplayName": "Ariel",
"lastUpdated": 1752095647212
}

קודי שגיאה של API

בטבלה הזו מפורטים קודי שגיאה נפוצים ב-API שמשתמשים נתקלים בהם כשהם יוצרים ווובוקים.

סיווג השגיאה	קוד שגיאה	הודעת השגיאה	פתרון בעיות
`403`	`FORBIDDEN`	למשתמש הנוכחי אין הרשאה להשתמש ב-Confluence.	מוודאים שיש טוקן תקף מחשבון אדמין ונקודת קצה ל-API נכונה.

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

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

ביצוע שאילתה

אחרי שמאשרים את Confluence Cloud ושולחים שאילתת חיפוש ל-Gemini Enterprise:

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

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

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

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

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

כדי לספק ממשק משתמש לשאילתות על נתוני Confluence Cloud, יוצרים אפליקציה ומקשרים אותה למאגר הנתונים של Confluence Cloud.
כדי לראות ולנהל את רשימת הפעולות, אפשר לעיין במאמר בנושא הצגה וניהול של פעולות.
כדי לראות תצוגה מקדימה של תוצאות החיפוש אחרי הגדרת האפליקציה, אפשר לעיין במאמר קבלת תוצאות חיפוש.
כדי להפעיל התראות למאגר הנתונים, אפשר לעיין במאמר הגדרת התראות למאגרי נתונים של צד שלישי.