ניהול מיומנויות

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

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

  1. הגדרת Agent Registry.

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

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

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

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

כדי לקבל את ההרשאות שדרושות לניהול מיומנויות ב-Agent Registry, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM בפרויקט הפיקוח שבו Agent Registry מופעל:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

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

הצגה של רשימת המיומנויות

אתם יכולים לעיין בכל היכולות הרשומות או לחפש יכולות ספציפיות:

המסוף

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

    כניסה ל-Agent Registry

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

gcloud

כדי להציג את כל המיומנויות במיקום מסוים, משתמשים בפקודה gcloud alpha agent-registry skills list:

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

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

gcloud alpha agent-registry skills describe SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

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

  • ‫SKILL_ID: המזהה של המיומנות שרוצים לבדוק. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.

REST

כדי לאחזר את רשימת כל המיומנויות, שולחים בקשת GET:

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

כדי לאחזר מאגר מיומנויות אחד, שולחים בקשת GET:

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

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.
  • ‫SKILL_ID: המזהה של המיומנות שרוצים לבדוק. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.

עדכון המטא-נתונים או גרסת ברירת המחדל של המיומנות

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

כדי לעדכן את המטא-נתונים של מיומנות או את גרסת ברירת המחדל של מיומנות מסוימת:

המסוף

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

    כניסה ל-Agent Registry

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

  5. בוחרים אחת מהאפשרויות הבאות:

    • עדכון המטא-נתונים של המיומנות:

      1. לוחצים על עריכה.
      2. בחלונית Edit skill, מעדכנים את השם המוצג או את התיאור של המיומנות.
      3. לוחצים על Save.

    • עדכון גרסת ברירת המחדל:

      1. מאתרים את הטבלה היסטוריית גרסאות.
      2. מוצאים את הגרסה שרוצים להגדיר כפעילה.
      3. בעמודה פעולות, לוחצים על הפעלת הגרסה.

gcloud

  • כדי לעדכן את המטא-נתונים של מיומנות, משתמשים בפקודה gcloud alpha agent-registry skills update:

    gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

  • כדי לעדכן את גרסת ברירת המחדל של המיומנות, משתמשים בפקודה gcloud alpha agent-registry skills update ומציינים את שם המשאב של הגרסה הרצויה:

    gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --default-revision="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

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

  • ‫SKILL_ID: המזהה של המיומנות שרוצים לעדכן. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.
  • ‫DISPLAY_NAME: השם המוצג המעודכן.
  • ‫DESCRIPTION: התיאור המעודכן.
  • ‫REVISION_ID: המזהה של גרסת המיומנות שרוצים להגדיר כברירת מחדל.

REST

שולחים בקשת PATCH ומציינים את השדות שרוצים לעדכן:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "defaultRevision": "projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,defaultRevision"

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

  • ‫DISPLAY_NAME: השם המוצג המעודכן של המיומנות.
  • ‫DESCRIPTION: התיאור המעודכן של המיומנות.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.
  • ‫SKILL_ID: המזהה של המיומנות שרוצים לעדכן. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.
  • ‫REVISION_ID: המזהה של גרסת המיומנות שרוצים להפעיל.

ניהול המצבים במחזור החיים של המיומנות

כדי לקבוע איך המערכת תטפל בסקיל בזמן הריצה, אתם יכולים לשנות את מצב היעד של הסקיל:

  • פעילה: המיומנות מוצגת וניתן לפתור אותה באופן מלא. כדי להגדיר מיומנות כפעילה, צריך שהשדה defaultRevision שלה יצביע על גרסה פעילה של המיומנות.
  • מושבתת: המצב ההתחלתי שמוגדר כברירת מחדל כשיוצרים מיומנות. הסקיל לא מופעל בזמן הריצה, הניסיון לפתור את הסקיל נכשל באופן מיידי והורדות המטען הייעודי (payload) נחסמות. מיומנות תהיה במצב מושבת גם אם המצביע defaultRevision שלה נמחק או אם גרסת ברירת המחדל שלה נמחקה. בניגוד למיומנות במצב Decommissioned, אתם יכולים להפעיל מיומנות מושבתת על ידי הגדרת defaultRevision תקין ועדכון מצב היעד שלה ל-Active.
  • הוצאה משימוש: עדיין אפשר לטעון ולהוריד את המיומנות, אבל היא תושבת בקרוב.
  • הוצאה משימוש: המיומנות מושבתת באופן סופי, לא מוצגת יותר ואי אפשר להחזיר אותה למצב פעיל או לכל מצב אחר. אפשר להוציא משימוש מיומנות רק אחרי שהיא כבר הוצאה משימוש. חשוב לתת למשתמשים מספיק זמן להעביר את הנתונים לפני שמוציאים את הסקיל משימוש. מכיוון שזהו מצב סופי, צריך להשתמש בו בזהירות.

כדי לשנות את מצב מחזור החיים של מיומנות:

המסוף

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

    כניסה ל-Agent Registry

  2. לוחצים על הכרטיסייה מיומנויות.
  3. עוברים על רשימת המיומנויות. אפשר לסנן את התצוגה באמצעות התפריטים Location או Status.
  4. לוחצים על שם המיומנות כדי לפתוח את הדף פרטי המיומנות, שבו מוצגים השם, התיאור, הגרסה הפעילה, מזהה המיומנות, תאריך העדכון האחרון, המטא-נתונים בהתאמה אישית והיסטוריית הגרסאות.
  5. משתמשים בלחצני הבקרה של הסטטוס כדי לשנות את מצב היעד. הלחצנים שמופיעים בדף תלויים בסטטוס הנוכחי של המיומנות, למשל Enable,‏ Disable,‏ Deprecate או Decommission.

gcloud

מעדכנים את מאגר המיומנויות באמצעות הפקודה gcloud alpha agent-registry skills update והדגל --target-state:

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --target-state=DISABLED

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

  • ‫SKILL_ID: המזהה של המיומנות שרוצים לעדכן. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.

הערכים המותרים למצב היעד הם:

  • ACTIVE
  • DISABLED
  • DEPRECATED
  • DECOMMISSIONED

REST

שולחים בקשת PATCH ומציינים את targetState בגוף הבקשה ובמסכת העדכון:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "targetState": "TARGET_STATE_DISABLED"
    }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=targetState"

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.
  • ‫SKILL_ID: המזהה של המיומנות שרוצים לעדכן. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.

הערכים המותרים למצב היעד הם:

  • TARGET_STATE_ACTIVE
  • TARGET_STATE_DISABLED
  • TARGET_STATE_DEPRECATED
  • TARGET_STATE_DECOMMISSIONED

מחיקת סקיל

מחיקת מאגר מיומנויות מוחקת באופן סופי את המשאב Skill ואת כל המשאבים הבלתי ניתנים לשינוי מסוג SkillRevision שמשויכים אליו. סוכנים שמנסים לפתור את מזהה המיומנות שנמחק נכשלים בזמן הריצה.

המסוף

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

    כניסה ל-Agent Registry

  2. לוחצים על הכרטיסייה מיומנויות.
  3. עוברים על רשימת המיומנויות. אפשר לסנן את התצוגה באמצעות התפריטים Location או Status.
  4. לוחצים על שם המיומנות שרוצים למחוק.
  5. בדף Skill Details, לוחצים על Delete.
  6. בתיבת הדו-שיח לאישור, מזינים DELETE ולוחצים על מחיקה.

gcloud

כדי למחוק מיומנות, משתמשים בפקודה gcloud alpha agent-registry skills delete:

gcloud alpha agent-registry skills delete SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

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

  • ‫SKILL_ID: המזהה של המיומנות שרוצים למחוק. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.

REST

כדי למחוק מיומנות, שולחים בקשת DELETE:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?force=true"

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

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫LOCATION: המיקום של המרשם.
  • ‫SKILL_ID: המזהה של המיומנות שרוצים למחוק. למיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.

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