בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Confluence Cloud ל-Gemini Enterprise.
לפני שמתחילים
לפני שמגדירים את החיבור המאוגד ל-Confluence Cloud, צריך לוודא את הדברים הבאים:
מקצים את התפקיד Discovery Engine Editor (
roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להקצות את התפקיד הזה:- נכנסים לדף IAM במסוף Google Cloud .
- מוצאים את חשבון המשתמש ולוחצים על עריכה .
- מקצים למשתמש את התפקיד
Discovery Engine Editor. מידע נוסף זמין במאמר תפקידים והרשאות ב-IAM.
כדי לאכוף את בקרת הגישה למקורות נתונים ולאבטח את הנתונים ב- Google Gemini Enterprise, צריך להגדיר את ספק הזהויות.
כדי להגדיר את מאגר הנתונים של Confluence Cloud, צריך להשתמש במודל החדש והמרכזי של Atlassian לניהול משתמשים. אם אתם משתמשים במודל המקורי, אתם צריכים להעביר את ניהול המשתמשים לפני שתמשיכו. מידע נוסף זמין במאמר תפקיד מנהל האתר.
יוצרים אפליקציית OAuth 2.0, מקבלים את מזהה הלקוח והסוד ומגדירים את הרשאות האפליקציה המינימליות בהסכמת אדמין ב-Confluence Cloud.
אופציונלי: כדי לאחזר כתובות אימייל של משתמשים מ-Confluence Cloud, גם כשההגדרות מגבילות את החשיפה של כתובות האימייל, מתקינים את אפליקציית הענן User Identity Accessor for Confluence Cloud עם הרשאות אדמין באתר של Confluence, ואז מגדירים אותה לאחזר באופן מאובטח כתובות אימייל של משתמשים. אם כתובות האימייל כבר נגישות לכולם, יכול להיות שלא תצטרכו להתקין את האפליקציה הזו.
יצירת מאגר נתונים ב-Confluence Cloud
כדי ליצור מאגר נתונים של Confluence Cloud:
במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
בוחרים פרויקט ב- Google Cloud או יוצרים פרויקט חדש.
בתפריט הניווט, לוחצים על מאגרי נתונים.
Create data store.
בקטע Source, מחפשים את Confluence Cloud ולוחצים על Select.
בקטע נתונים:
- בקטע מצב מחבר, בוחרים באפשרות הטמעת נתונים או חיפוש מאוחד כמצב החיבור.
לוחצים על Continue.
בקטע Authentication settings, מגדירים את האימות בהתאם למצב החיבור שנבחר.
אם בחרתם באפשרות הטמעת נתונים:
- בוחרים את שיטת האימות: פרטי כניסה של לקוח 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). - User account: שם המשתמש ב-Atlassian שמשויך לאסימון ה-API.
- טוקן API: טוקן ה-API שנוצר מחשבון Atlassian שלכם.
- Instance URI: כתובת ה-URL הבסיסית של המכונה שלכם ב-Confluence Cloud ( לדוגמה,
אם בחרתם באפשרות חיפוש מאוחד:
ממלאים את הפרטים הבאים:
- מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
- סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0.
- Instance URI: כתובת ה-URL הבסיסית של המכונה שלכם ב-Confluence Cloud ( לדוגמה,
https://your-domain.atlassian.net).
לוחצים על Login (כניסה) ונכנסים לחשבון Atlassian.
מידע נוסף על פרטי הכניסה זמין במאמר הגדרת Confluence Cloud.
לוחצים על Continue.
בקטע יעדים, מזינים את כתובת ה-URL של נקודת הקצה של Confluence Cloud.
לוחצים על Continue.
בקטע ישויות לסנכרון (אם בחרתם באפשרות הטמעת נתונים) או ישויות לחיפוש (אם בחרתם באפשרות חיפוש מאוחד):
- בוחרים את כל הישויות הנדרשות.
- אם בחרתם באפשרות חיפוש מאוחד, המשיכו לשלב הבא.
אם בחרתם באפשרות הטמעת נתונים, בצעו את הפעולות הבאות:
אופציונלי: כדי לסנכרן פרויקטים ספציפיים, מבצעים את הפעולות הבאות:
- לוחצים על סינון.
- כדי לסנן ישויות מהאינדקס, בוחרים באפשרות החרגה מהאינדקס. כדי לוודא שהן נכללות באינדקס, בוחרים באפשרות הכללה באינדקס.
- מזינים את מפתחות המרחב. לוחצים על Enter אחרי כל מקש רווח. מפתח המרחב הוא הקוד הייחודי בכתובת ה-URL של המרחב ב-Confluence, שמופיע אחרי
/spaces/. (לדוגמה, ב-https://company.atlassian.net/wiki/spaces/ABC/overview, מקש הרווח הואABC.) - לוחצים על Save.
כדי להגדיר את לוח הזמנים של הסנכרון:
ברשימה תדירות הסנכרון, בוחרים את תדירות הסנכרון.
- כדי לתזמן סנכרונים מלאים נפרדים של נתוני ישויות וזהויות, מרחיבים את התפריט בקטע סנכרון מלא ובוחרים באפשרות אפשרויות בהתאמה אישית.
ברשימה תדירות הסנכרון המצטבר, בוחרים את תדירות הסנכרון המצטבר.
מידע נוסף זמין במאמר לוחות זמנים לסנכרון.
לוחצים על Continue.
בקטע פעולות:
- אם בחרתם באפשרות חיפוש מאוחד:
- בקטע Select Confluence Cloud actions to enable, בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.
אם בחרתם באפשרות הטמעת נתונים:
- בקטע Authentication settings, מגדירים את האימות בהתאם למצב החיבור שנבחר.
מזינים את פרטי האימות הבאים:
- מזהה לקוח: המזהה של אפליקציית OAuth 2.0.
- סוד לקוח: המפתח הסודי שמשויך לאפליקציית OAuth 2.0.
- Instance URI: כתובת ה-URL הבסיסית של המכונה שלכם ב-Confluence Cloud ( לדוגמה,
https://your-domain.atlassian.net). - מזהה המכונה: מזהה ייחודי של המכונה ב-Confluence Cloud.
מידע נוסף על פרטי הכניסה זמין במאמר הגדרת Confluence Cloud.
לוחצים על Login (כניסה) ונכנסים ל-Confluence Cloud כדי לאמת את החשבון.
לוחצים על Continue.
בקטע יעדים, מזינים את כתובת ה-URL של נקודת הקצה של Confluence Cloud.
בקטע Select Confluence Cloud actions to enable, בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במאגר הנתונים.
כדי לראות ולנהל את רשימת הפעולות, עיינו במאמר הצגה וניהול של פעולות.
- אם בחרתם באפשרות חיפוש מאוחד:
לוחצים על Continue.
אם בתהליך היצירה של מאגר הנתונים מופיע הקטע Advanced options, אתם יכולים לסמן בו את התיבה Enable Static IP Addresses. כך מאגר הנתונים משתמש בקבוצה קבועה של כתובות IP לתנועה יוצאת, שמתאימות להוספה לרשימת ההיתרים במערכת המקור. מידע נוסף זמין במאמר הגדרת תעבורת נתונים יוצאת עם כתובת IP סטטית.
בקטע Configuration (הגדרה):
- ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
- בשדה השם של מחבר הנתונים, נותנים שם למחבר.
- אם בחרתם באפשרות
usאוeuבתור המיקום, מגדירים את הגדרות ההצפנה:- אופציונלי: אם לא הגדרתם מפתחות לאזור יחיד, לחצו על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר רישום מפתח לאזור יחיד למחברים של צד שלישי.
- בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
- אם בחרתם באפשרות Cloud KMS key:
- ברשימה Key management type, בוחרים את הסוג המתאים.
- ברשימה Cloud KMS key, בוחרים את המפתח.
לוחצים על Continue.
בקטע חיוב, בוחרים באפשרות תמחור כללי או תמחור שניתן להגדרה. מידע נוסף זמין במאמרים אימות סטטוס החיוב של פרויקטים ורישיונות.
לוחצים על יצירה. Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף Data Stores.
בדף Data Stores, לוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. אחרי שהסטטוס של מאגר הנתונים משתנה מ-Creating (בשלבי יצירה) ל-Active (פעיל), מאגר הנתונים של Confluence Cloud מוכן לשימוש.
במאגר נתונים להטמעה שנוצר באמצעות Confluence Cloud, המצב של מאגר הנתונים משתנה מ-Creating (בשלבי יצירה) ל-Running (פועל) כשהסנכרון מתחיל. אחרי שההטמעה מסתיימת, הסטטוס משתנה ל-Active (פעיל), מה שמציין שמאגר הנתונים מוגדר באופן מלא. בהתאם לנפח הנתונים, יכול להיות שתהליך ההטמעה יימשך כמה שעות.
אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה, מקשרים אותה למאגר הנתונים של Confluence Cloud ונותנים ל-Gemini Enterprise הרשאה לגשת ל-Confluence Cloud לפני שמריצים שאילתות.
הפעלת סנכרון בזמן אמת להטמעת נתונים
סנכרון בזמן אמת מסנכרן רק ישויות של מסמכים ולא מסנכרן נתונים שקשורים לישויות של זהויות. בטבלה הבאה מפורטים אירועי המסמכים שנתמכים בסנכרון בזמן אמת.
| ישויות ב-Confluence | יצירה | עדכון | מחיקה | שינויים בהרשאות |
|---|---|---|---|---|
| Spaces | ||||
| Pages | ||||
| בלוגים | ||||
| קבצים מצורפים | ||||
| תגובות | ||||
| לוחות מחיקים |
מפעילים את הסנכרון בזמן אמת 20 דקות אחרי שיוצרים את מאגר הנתונים של Confluence Cloud.
כדי להפעיל סנכרון בזמן אמת במאגר נתונים של Confluence:
יצירת webhook URL
- עוברים לדף Gemini Enterprise ובתפריט הניווט לוחצים על מאגרי נתונים.
- בוחרים מאגר נתונים של Confluence.
- לוחצים על הצגה/עריכה בשורה סנכרון בזמן אמת.
- בתיבת הדו-שיח הצגה ועריכה של פרמטרים לסנכרון בזמן אמת, מבצעים את הפעולות הבאות:
- כדי להפעיל את הסנכרון בזמן אמת, לוחצים על המתג הפעלת סנכרון בזמן אמת.
- בשדה סוד לקוח, מזינים ערך זמני לשמירת מקום (פלייסהולדר), כמו
clientsecret. - לוחצים על Save.
- אחרי שהסטטוס של סנכרון בזמן אמת משתנה ל-
Running, לוחצים על הצגה/עריכה. - בתיבת הדו-שיח הצגה ועריכה של פרמטרים לסנכרון בזמן אמת, מבצעים את הפעולות הבאות:
- מעתיקים את כתובת ה-URL של ה-webhook.
- לוחצים על 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_createdspace_updatedpage_createdpage_updatedattachment_createdattachment_updatedcomment_createdcomment_updatedblog_createdblog_updated
קודי שגיאה ב-API
בטבלה הזו מפורטים קודי שגיאה נפוצים של API שמשתמשים נתקלים בהם כשהם יוצרים תגובות לפעילות webhook.
| סוג השגיאה | קוד שגיאה | הודעת השגיאה | פתרון בעיות |
|---|---|---|---|
403 |
FORBIDDEN |
למשתמש הנוכחי אין הרשאה להשתמש ב-Confluence. | צריך לוודא שהטוקן תקין ושהוא מחשבון אדמין, ושהנקודת הקצה ל-API נכונה. |
טיפול בנתונים והרצת שאילתות
בקטע הזה מוסבר איך Gemini Enterprise מנהל את השאילתה שלכם ומהן ההשלכות על הפרטיות כשמשתמשים במאגר הנתונים המשותף.
הרצת שאילתות
אחרי שנותנים ל-Confluence Cloud הרשאה ושולחים שאילתת חיפוש ל-Gemini Enterprise:
- Gemini Enterprise שולח את שאילתת החיפוש ישירות ל-API של Atlassian.
- Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.
טיפול בנתונים
כשמשתמשים בחיפוש מאוחד של צד שלישי, חלים הכללים הבאים לטיפול בנתונים:
- מחרוזת השאילתה נשלחת למערכת הבק-אנד של צד שלישי לחיפוש (Atlassian API).
- הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
- אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
- אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.
המאמרים הבאים
- כדי לספק ממשק משתמש לשליחת שאילתות לנתונים ב-Confluence Cloud, יוצרים אפליקציה ומחברים אותה למאגר הנתונים של Confluence Cloud.
- כדי לראות ולנהל את רשימת הפעולות, עיינו במאמר הצגה וניהול של פעולות.
- כדי לראות איך תוצאות החיפוש ייראו אחרי הגדרת האפליקציה, עיינו בקטע קבלת תוצאות חיפוש.
- כדי להפעיל התראות למאגר הנתונים, קראו את המאמר הגדרת התראות למאגרי נתונים של צד שלישי.