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

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

במאמר הזה מוסבר איך לבדוק את הפרטים של מפתחים מאומתים של מיומנויות רשומות.

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

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

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

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

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

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

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

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

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

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

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

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

המסוף

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

    כניסה ל-Agent Registry

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

gcloud 

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, מאתרים את שם המשאב האחיד (URN) של המיומנות.

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

gcloud 

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: המזהה של בעל האפליקציה שרוצים לבדוק.

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