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

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

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

מושגים מרכזיים

ב-Skill Registry יש שתי ישויות API סטנדרטיות ברמה העליונה לניהול מחזור החיים והגרסאות:

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

דוגמאות למבנה המיומנות הצפוי מופיעות בקובצי SKILL.md במאגר המיומנויות של Google Cloud.
גרסת הסקיל תמונת מצב קבועה של גרסת מיומנות ספציפית. הוא כולל שם, תיאור והפניה שלא ניתנת לשינוי למשאב של מיומנות ההורה.

אימות המטען הייעודי (payload) של המיומנות

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

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

  • הקובץ הוא לא קובץ ZIP תקין או שחסר בו מידע חשוב.
  • קובץ ה-ZIP ריק.
  • קובץ ה-ZIP מכיל יותר מ-10,000 פריטים.
  • השמות של הקבצים או התיקיות בקובץ ה-ZIP מכילים את התו .. או מתחילים בתווים / או \\.
  • קובץ ה-ZIP מכיל קישורים סימבוליים.
  • יש שמות כפולים של קבצים או תיקיות בקובץ ה-ZIP.
  • הגודל הכולל של כל הקבצים בתוך קובץ ה-ZIP הוא יותר מ-500MB אחרי פתיחת הקובץ.
  • הקובץ דחוס מדי, עם יחס דחיסה של יותר מ-100.
  • התיקיות בתוך קובץ ה-ZIP מגיעות לעומק של יותר מ-8 רמות.
  • קובץ ה-ZIP לא מכיל קובץ SKILL.md.
  • בקובץ SKILL.md יש את הבעיות הבאות:
    • בקובץ SKILL.md חסר ה-front matter הנדרש של YAML או תוכן ה-Markdown הצפוי.
    • שדה השם ב-YAML front matter חסר, מכיל יותר מ-64 תווים, מתחיל או מסתיים במקף, או מכיל תווים שהם לא אותיות קטנות, מספרים ומקפים.
    • שדה התיאור ב-YAML front matter חסר או ארוך מ-1,024 תווים.
    • שדה הרישיון ב-YAML front matter חורג מ-1,024 תווים.
    • ההוראות בקובץ SKILL.md חורגות מ-500,000 תווים.
  • ארכיון ה-ZIP גדול מ-10MB.

סקילים מובנים

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

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

מדריך

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