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

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

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

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

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

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

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

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

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

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

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

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

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

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

מדריך

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