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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

הגדרת מאגר נתונים של 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 עם הרשאות Site administrator ב-Confluence, ואז להגדיר אותה כדי לאחזר כתובות אימייל של משתמשים בצורה מאובטחת. יכול להיות שלא תצטרכו להתקין את האפליקציה הזו אם כתובות האימייל כבר נגישות לציבור.

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

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

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

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

‫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 token, מזינים את הפרטים הבאים:
      - ‫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. לוחצים על כניסה ומשלימים את הכניסה לחשבון 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.
בקטע Configuration (הגדרה):
1. ברשימה מספר אזורים, בוחרים את המיקום של מחבר הנתונים.
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 ובתפריט הניווט לוחצים על מאגרי נתונים.
בוחרים מאגר נתונים של 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.
במאמר הצגה וניהול של פעולות מוסבר איך לראות את רשימת הפעולות ולנהל אותה.
כדי לראות תצוגה מקדימה של תוצאות החיפוש אחרי הגדרת האפליקציה, אפשר לעיין במאמר בנושא קבלת תוצאות חיפוש.
כדי להפעיל התראות למאגר הנתונים, אפשר לעיין במאמר הגדרת התראות למאגרי נתונים של צד שלישי.