בדיקת פרטי בעל התוכן הדיגיטלי של המיומנות

במרשם הסוכנים, בעלי תוכן דיגיטלי מאפשרים לכם לאמת את הסמכות שמאחורי פעולות עצמאיות רשומות, כדי למנוע שימוש לא מורשה בשמות של בעלי תוכן דיגיטלי. כל מפתח מגדיר את הדומיין המאומת או את הקידומת של המזהה של מזהי הסקילים, כמו cloud.google.com לסקילים שמנוהלים על ידי Google או private- לסקילים שנרשמו באופן ידני.

‫Google שולטת ביצירה, בעדכון ובמחיקה של בעלי תוכן דיגיטלי. מיומנויות שאתם יוצרים מוקצות באופן אוטומטי לבעל התוכן הדיגיטלי שמוגדר כברירת מחדל, private, שמשתמש בקידומת private-. אתם יכולים להציג ולבדוק את פרטי בעלי התוכן הדיגיטלי ב-Agent Registry כדי לאמת את הבעלות על הפעולות הרשומות.

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

  1. הגדרת Agent Registry.

  2. אם אתם משתמשים בפרויקט אחד, אתרו את מזהה הפרויקט של פרויקט הפיקוח שבו מופעל Agent Registry. אם הגדרתם גבול ניהול לכמה פרויקטים, השתמשו במזהה של פרויקט הניהול כדי לגלות ולרשום את כל הפרויקטים בגבול, או ציינו מזהה של פרויקט חבר כדי לבצע פעולות בפרויקט יחיד.

  3. רישום מיומנות עצמאית.

  4. כדי להשתמש בפקודות של Google Cloud CLI שמופיעות במאמר הזה, צריך להגדיר את סביבת ה-CLI של gcloud.

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לבדיקת פרטי מפתחי המיומנויות ב-Agent Registry, בקשו מהאדמין לתת לכם את התפקיד צפייה ב-Agent Registry API ‏ (roles/agentregistry.viewer) ב-IAM בפרויקט הפיקוח שבו Agent Registry מופעל. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

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

רמות של בעלי תוכן דיגיטלי

בעלי התוכן הדיגיטלי מסווגים לרמות שמשקפות את רמת האימות שלהם:

  • ‫Google-managed (FIRST_PARTY): בעלי תוכן דיגיטלי מאומתים ש-Google מנהלת, כמו cloud.google.com ו-discoveryengine.googleapis.com.
  • פרטי (PRIVATE): בעל התפקיד private שמוגדר כברירת מחדל ומוקצה באופן אוטומטי למיומנויות שאתם או משתמשים אחרים יוצרים בפרויקט.

הצגת רשימה של בעלי תוכן דיגיטלי

אתם יכולים להציג את כל בעלי התוכן הדיגיטלי שהוגדרו במיקום שלכם:

המסוף

  1. נכנסים לדף Agent Registry במסוף Google Cloud :

    כניסה ל-Agent Registry

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

gcloud

כדי להציג את כל בעלי התוכן הדיגיטלי המאומתים במיקום מסוים, מריצים את הפקודה gcloud alpha agent-registry publishers list:

gcloud alpha agent-registry publishers list \
    --project=PROJECT_ID \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.

REST 

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.

צפייה בפרטי ספק החדשות

אתם יכולים לבדוק את הפרטים של בעל תוכן דיגיטלי ספציפי:

המסוף

  1. נכנסים לדף Agent Registry במסוף Google Cloud :

    כניסה ל-Agent Registry

  2. לוחצים על הכרטיסייה מיומנויות.
  3. לוחצים על שם המיומנות כדי לפתוח את דף הפרטים שלה.

  4. בקטע Skill details, מאתרים את מזהה המיומנות של המיומנות.

    אפשר להשתמש בשדה הזה כדי למצוא נכסים של בעל תוכן דיגיטלי ספציפי. לדוגמה, הפורמט של סקילים שמנוהלים על ידי Google הוא urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.

gcloud

כדי לראות את הפרטים של בעל תוכן דיגיטלי ספציפי, מריצים את הפקודה gcloud alpha agent-registry publishers describe:

gcloud alpha agent-registry publishers describe PUBLISHER_ID \
    --project=PROJECT_ID \
    --location=LOCATION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PUBLISHER_ID: המזהה של בעל האפליקציה שרוצים לבדוק.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.

REST 

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers/PUBLISHER_ID"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.
  • ‫PUBLISHER_ID: המזהה של בעל האפליקציה שרוצים לבדוק.

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