קבוצות הקשר מאפשרות לכם לבסס סוכני AI באמצעות מאגרים מוגבלים של מידע סמנטי והפניות לנכסי נתונים. מידע נוסף על אופן הפעולה של הקונטיינרים האלה זמין במאמר סקירה כללית על קבוצות הקשרים.
לפני שמריצים משימת העשרה, צריך להגדיר קבוצת הקשר. משימות העשרה הן סוכנים אוטונומיים שמנתחים באופן רציף את הסכימות והמסמכים של מערכי הנתונים, כדי ליצור הצעות למטא-נתונים של נכסי הנתונים.
אפשר להגדיר קבוצת הקשר כמכל (container) נפרד או כחלק מהגדרה של משימת העשרה. מידע נוסף על יצירת קבוצת הקשר במהלך הגדרת משימה זמין במאמר יצירת משימות העשרה.
לפני שמתחילים
לפני שאתם מנהלים קבוצות של הקשרים, ודאו שיש לכם את התפקידים הנדרשים ב-IAM.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות לניהול קבוצות הקשר, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:
- כדי ליצור קבוצות הקשר: אדמין של Dataplex Catalog (
roles/dataplex.catalogAdmin) או בעלים של קבוצת רשומות ב-Dataplex (roles/dataplex.entryGroupOwner). התפקידים האלה כוללים את ההרשאהdataplex.entryGroups.setIamPolicy, שנדרשת כדי להעניק לכם באופן אוטומטי הרשאות בעלים במהלך היצירה של קבוצת ההקשר. - כדי לערוך או למחוק קבוצות של הקשרים: אדמין של Dataplex Catalog (
roles/dataplex.catalogAdmin) או עריכה של Dataplex Catalog (roles/dataplex.catalogEditor).
יצירת קבוצת הקשרים
כדי ליצור קבוצת הקשר ריקה שבה יאוחסנו המטא-נתונים המועשרים:
Knowledge Studio
נכנסים לדף Knowledge Studio במסוף Google Cloud .
בחלונית הניווט הימנית, לוחצים על קבוצות הקשר.
בדף קבוצות הקשר, לוחצים על יצירה.
בחלונית Create context set, מזינים שם בשדה השם המוצג ומזהה בשדה Context set ID.
אופציונלי: מזינים תיאור, בוחרים מיקום ומוסיפים תוויות.
לוחצים על Save.
סוגי מטא-נתונים
נכנסים לדף Metadata types במסוף Google Cloud .
לוחצים על קבוצות של רשומות > קבוצת הקשר.
בדף Metadata types, לוחצים על Create.
בחלונית Create context set, מזינים שם בשדה השם המוצג ומזהה בשדה Context set ID.
אופציונלי: מזינים תיאור, בוחרים מיקום ומוסיפים תוויות.
לוחצים על Save.
אחרי שיוצרים את קבוצת ההקשר, אפשר לבחור אותה כיעד למשימות ההעשרה. הפעלת ההעשרה מאכלסת את הקונטיינר הזה במושגים, בשיוכים הסמנטיים ובנוסחאות של המטא-נתונים שה-AI הציע.
הצגת קבוצות ההקשרים
כדי לראות את קבוצות ההקשר הקיימות:
Knowledge Studio
נכנסים לדף Knowledge Studio במסוף Google Cloud .
בחלונית הניווט הימנית, לוחצים על קבוצות הקשר.
כדי לראות את הפרטים של קבוצת הקשרים ספציפית, לוחצים על השם שלה ברשימה.
סוגי מטא-נתונים
נכנסים לדף Metadata types במסוף Google Cloud .
לוחצים על קבוצות של רשומות > קבוצת הקשר.
כדי לראות את הפרטים של קבוצת הקשרים ספציפית, לוחצים על השם שלה ברשימה.
בדף הפרטים מוצגים המאפיינים של קבוצת ההקשר, כמו התיאור, המיקום ומזהה הפרויקט. הוא מכיל גם את הקטע רשומות לדוגמה, שבו מופיעה תצוגה מקדימה של רשומות המטא-נתונים המועשרות שמאוחסנות בקבוצת ההקשר, וכפתור להצגת כל הרשומות הקשורות בחיפוש.
עריכת קבוצת הקשרים
באמצעות Google Cloud המסוף, אתם יכולים לערוך את מאפייני המאגר של קבוצת הקשר, כולל השם המוצג, Description ו-Labels.
כדי לעדכן את תוכן המטא-נתונים המועשרים בתוך קבוצת הקשר, צריך להריץ משימת העשרה שמטרגטת את הקבוצה הזו ולאשר את הצעות השינוי שנוצרו. מידע נוסף על אישור הצעות לשינויים זמין במאמר ניהול הרצות של העשרה.
כדי לערוך את המאפיינים של קבוצת הקשרים:
Knowledge Studio
נכנסים לדף Knowledge Studio במסוף Google Cloud .
בחלונית הניווט הימנית, לוחצים על קבוצות הקשר.
לוחצים על השם של קבוצת ההקשר שרוצים לערוך.
בדף הפרטים, לוחצים על עריכה.
משנים את השדות שניתנים לעריכה (השם המוצג, Description או Labels) ולוחצים על Save.
סוגי מטא-נתונים
נכנסים לדף Metadata types במסוף Google Cloud .
לוחצים על קבוצות של רשומות > קבוצת הקשר.
בדף Metadata types, לוחצים על השם של קבוצת ההקשר שרוצים לערוך.
בדף הפרטים, לוחצים על עריכה.
משנים את השדות שניתנים לעריכה (השם המוצג, Description או Labels) ולוחצים על Save.
מחיקה של קבוצת הקשרים
כשמוחקים קבוצת הקשר, השיוכים הסמנטיים שלה מוסרים מתרשים ההקשר של הנתונים. אם תמחקו קבוצת הקשר בזמן שהעשרת הנתונים פועלת, המערכת לא תוכל לשמור את המטא-נתונים שהיא הציעה בסיום ההפעלה כי יעד ההעברה לא יהיה זמין יותר. גם ההפעלות הבאות של משימת ההעשרה ייכשלו עד שתעדכנו את המשימה כך שהפלט שלה יהיה קבוצת הקשרים תקינה.
כדי למחוק קבוצת הקשר:
Knowledge Studio
נכנסים לדף Knowledge Studio במסוף Google Cloud .
בחלונית הניווט הימנית, לוחצים על קבוצות הקשר.
ברשימה, לוחצים על השם של קבוצת ההקשר שרוצים למחוק.
בדף הפרטים, לוחצים על מחיקה.
מאשרים את המחיקה.
סוגי מטא-נתונים
נכנסים לדף Metadata types במסוף Google Cloud .
לוחצים על קבוצות של רשומות > קבוצת הקשר.
ברשימה, לוחצים על השם של קבוצת ההקשר שרוצים למחוק.
בדף הפרטים, לוחצים על מחיקה.
מאשרים את המחיקה.
מגבלות
למידע על המגבלות שחלות במהלך גרסת טרום-ההשקה (Preview), קראו את המאמר גבולות גרסת טרום-ההשקה (Preview).
המאמרים הבאים
למידע נוסף, קראו את המאמרים הבאים: