‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול גרסאות של סקילז

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

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

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

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

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

הצגה, הורדה וצפייה בגרסאות של מיומנויות: Agent Registry API Viewer (roles/agentregistry.viewer)
יצירה, עדכון ומחיקה של גרסאות מיומנות: משתמש במרשם הסוכנים (roles/agentregistry.user)
ניהול גרסאות של מיומנויות ומשאבים אחרים של Agent Registry: עריכה של Agent Registry API (roles/agentregistry.editor)

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

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

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

יצירת גרסה של סקיל

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

למחירון של Agent Registry

גודל הקובץ המקסימלי של גרסת מיומנות בפורמט ZIP הוא 500KB.

המסוף

נכנסים לדף Agent Registry במסוף Google Cloud :
כניסה ל-Agent Registry
לוחצים על הכרטיסייה מיומנויות ואז על שם המיומנות.
בדף פרטי המיומנות, מאתרים את הטבלה היסטוריית גרסאות.
‫לוחצים על הוספת גרסה.
בחלונית Add version, בוחרים אחת מהאפשרויות הבאות:
- ‫File: מעלים את החבילה או את קובץ ה-ZIP שמכיל את קובץ ההוראות של SKILL.md ואת הסקריפטים האופציונליים. אפשר ללחוץ על Browse כדי למצוא את הקובץ בסביבה המקומית.
- ‫Bucket: מספקים URI של gs://... Cloud Storage שמכיל חבילת ZIP תקינה. אפשר ללחוץ על Browse כדי למצוא את הקובץ בקטגוריות של Cloud Storage.
  
  חשוב: כדי ש-Agent Registry יוכל לגשת לקובצי המיומנויות, צריך לתת לסוכן השירות שלו גישה לארכיון ה-ZIP בקטגוריה של Cloud Storage. סוכן השירות של Agent Registry משתמש בפורמט הבא: service-PROJECT_NUMBER@gcp-sa-agentregistry.iam.gserviceaccount.com. אם סוכן השירות הזה לא קיים בפרויקט, צריך ליצור אותו בשביל Agent Registry API. איך יוצרים סוכני שירות ומקצים להם תפקידים לסוכן השירות נדרשת ההרשאה storage.objects.get בקטגוריה של Cloud Storage שמכילה את ארכיון ה-ZIP. במאמר IAM ל-Cloud Storage מוסבר איך נותנים הרשאות של ניהול זהויות והרשאות גישה (IAM) למשאבים בקטגוריה.
לוחצים על יצירה.

הגרסה של המיומנות מופיעה בטבלה Version history בדף Skill Details.

gcloud

כדי ליצור גרסה של מיומנות, אתם יכולים להעלות קובץ ZIP מקומי או לייבא חבילה ששמורה ב-Cloud Storage.

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

‫REVISION_ID: המזהה שרוצים להקצות לגרסת המיומנות.
‫SKILL_ID: המזהה של המיומנות שבה משתמשים לגרסה. במיומנויות שנרשמו באופן ידני, צריך לכלול את הקידומת private-, למשל private-my-skill.
‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: המיקום של המרשם.
העלאת קובץ ZIP מקומי: כדי ליצור גרסה של סקיל באמצעות מטען ייעודי (payload) של קובץ ZIP מקומי, מריצים את הפקודה gcloud alpha agent-registry skills revisions create:
```
gcloud alpha agent-registry skills revisions create REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --payload="LOCAL_ZIP_PATH"
```
מחליפים את הערך LOCAL_ZIP_PATH בנתיב לארכיון המיומנות הארוז במכונה המקומית.
ייבוא מקטגוריה של Cloud Storage: כדי ליצור גרסת מיומנות באמצעות ארכיון ZIP שמתארח בקטגוריה של Cloud Storage, מריצים את הפקודה gcloud alpha agent-registry skills revisions create:
```
gcloud alpha agent-registry skills revisions create REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"
```
חשוב: כדי ש-Agent Registry יוכל לגשת לקובצי המיומנויות, צריך לתת לסוכן השירות שלו גישה לארכיון ה-ZIP בקטגוריה של Cloud Storage. סוכן השירות של Agent Registry משתמש בפורמט הבא: service-PROJECT_NUMBER@gcp-sa-agentregistry.iam.gserviceaccount.com. אם סוכן השירות הזה לא קיים בפרויקט, צריך ליצור אותו ל-Agent Registry API. איך יוצרים סוכני שירות ומקצים להם תפקידים לסוכן השירות נדרשת ההרשאה storage.objects.get בקטגוריה של Cloud Storage שמכילה את ארכיון ה-ZIP. במאמר IAM ל-Cloud Storage מוסבר איך נותנים הרשאות IAM למשאבים בקטגוריה.

מחליפים את מה שכתוב בשדות הבאים:
- ‫BUCKET_NAME: שם הקטגוריה ב-Cloud Storage שמכילה את חבילת ה-ZIP.
- ‫SKILL_PACKAGE: השם של חבילת המיומנויות שמכילה את גרסת המיומנות.

REST

כדי ליצור גרסה של מיומנות, שולחים בקשת POST לאוסף הגרסאות. אפשר להעלות את קובץ ה-ZIP ישירות או להפנות לנתיב ב-Cloud Storage.

העלאת קובץ ZIP מקומי: מציינים את archiveUploadSource שמכיל את הבייטים של קובץ ה-ZIP בקידוד base64 בגוף הבקשה. אתם יכולים להשתמש בפקודה base64 בתוך השורה ב-curl:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "archiveUploadSource": {
          "archiveContent": "'"$(base64 -w0 local_skill.zip)"'"
        }
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

ייבוא מקטגוריה של Cloud Storage: מציינים את gcsSource בגוף הבקשה שמפנה לנתיב הקטגוריה:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "gcsSource": {
          "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip"
        }
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

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

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: המיקום של המרשם.
‫SKILL_ID: המזהה של מאגר המיומנויות. במיומנויות שנרשמו ידנית, צריך לכלול את הקידומת private-, למשל private-my-skill.
‫REVISION_ID: המזהה שרוצים להקצות לגרסה הזו.
‫BUCKET_NAME: שם הקטגוריה ב-Cloud Storage שמכילה את קובץ ה-ZIP.
‫SKILL_PACKAGE: שם חבילת ה-ZIP.

הצגת רשימה של גרסאות ותיאור שלהן

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

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

המסוף

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

gcloud

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

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

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

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

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

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

REST

כדי להציג רשימה של גרסאות:

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

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

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

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

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

הורדת המטען הייעודי של הגרסה

אתם יכולים להוריד את המטען הייעודי (payload) של קובץ ה-ZIP של גרסה ספציפית כדי לאמת או לנפות באגים באופן מקומי.

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

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

כדי להוריד את המטען הייעודי (payload) של גרסה פעילה:

המסוף

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

gcloud

כדי להוריד את המטען הייעודי (payload) של ארכיון הגרסה, מריצים את הפקודה gcloud alpha agent-registry skills revisions download ומציינים את נתיב היעד:

gcloud alpha agent-registry skills revisions download REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --destination="./skill_payload.zip"

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

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

REST

שולחים בקשת GET לכתובת ה-URL של המשאב של הגרסה, ומוסיפים את הפרמטר של השאילתה alt=media. כדי לעקוב אחרי הפניות אוטומטיות של HTTP, צריך להשתמש בדגל -L עם curl:

curl -L -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -o skill_payload.zip \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID?alt=media"

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

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

מחיקת גרסה ספציפית

כשמוחקים גרסה ספציפית, המערכת מסירה את המטען הייעודי (payload) של קובץ ה-ZIP ואת היסטוריית המטא-נתונים מ-Agent Registry.

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

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

המסוף

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

gcloud

כדי למחוק גרסה, מריצים את הפקודה gcloud alpha agent-registry skills revisions delete:

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

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

‫REVISION_ID: המזהה של גרסת הסקיל שרוצים למחוק.
‫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/revisions/REVISION_ID"

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

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

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

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

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

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

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

יצירת גרסה של סקיל

המסוף

gcloud

REST

הצגת רשימה של גרסאות ותיאור שלהן

המסוף

gcloud

REST

הורדת המטען הייעודי של הגרסה

המסוף

gcloud

REST

מחיקת גרסה ספציפית

המסוף

gcloud

REST

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

ניהול גרסאות של סקילז