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

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

כל מיומנות היא חבילה שמכילה קובץ הנחיה של SKILL.md. חבילת מיומנות יכולה גם לכלול סקריפטים, קבצים או הקשר ברקע שה-Assistant משתמשת בהם כדי להשלים משימה. כברירת מחדל, Gemini Enterprise מפעיל את המיומנויות שאתם יוצרים.

מהדורות נתמכות

היכולת ליצור, להעלות או להשתמש במיומנויות תלויה במהדורת Gemini Enterprise שאתם מנויים אליה:

  • ‫Standard,‏ Plus ו-Pay-as-you-go: אתם יכולים ליצור ולהעלות סקילים בהתאמה אישית, ולהשתמש בסקילים שמנוהלים על ידי Google ובסקילים שנוצרו על ידי משתמשים ושותפו איתכם.
  • Frontline: ניתן לעיין, להתקין ולהשתמש בסקילים שמנוהלים על ידי Google ובסקילים שנוצרו על ידי משתמשים ושותפו איתך. אתם לא יכולים ליצור או להעלות מיומנויות בהתאמה אישית.

סקירה כללית

ההיבטים העיקריים של מיומנויות כוללים:

  • תקן פתוח: כל מיומנות מבוססת על תקן המיומנויות הפתוח, מוגדרת באמצעות קובץ SKILL.md בסיסי ואפשר להרחיב אותה באמצעות קבצים או סקריפטים נוספים.
  • תוסף מודולרי: סקילים מאפשרים לכם ללמד סוכן לבצע משימות ספציפיות לדומיין באמצעות הוראות והקשר בהתאמה אישית.
  • גישה דינמית: Gemini Enterprise ניגש להוראות המיוחדות האלה באופן אוטומטי כשהן רלוונטיות לשאלה או למשימה שלכם.

יצירת מיומנות

כדי ליצור מיומנות חדשה באתר Gemini Enterprise, פועלים לפי השלבים הבאים:

  1. נכנסים לאתר Gemini Enterprise.
  2. בתפריט הניווט, לוחצים על מיומנויות.
  3. לוחצים על סמל ההוספה ואז על יצירת מיומנות באמצעות Gemini.
  4. נותנים שם למיומנות.
  5. הזן תיאור ‫Gemini Enterprise משתמש בתיאור כדי לקבוע אם הסקיל יכול לעזור בביצוע הנחיה או משימה. אתם יכולים גם להוסיף לתיאור הוראות להפעלה, כדי לעזור ל-Gemini Enterprise.
  6. מזינים את ההוראות למיומנות בשפה טבעית בתיבת הצ'אט או בשדה הוראות. כדי ליצור סקיל באמצעות קובץ SKILL.md קיים עם Markdown או YAML בהתאמה אישית, קראו את המאמר העלאת סקיל.
  7. לוחצים על Save. ‫Gemini Enterprise מפעיל את המיומנות החדשה כברירת מחדל.

העלאת סקיל

כדי להוסיף מיומנויות קיימות, מעלים אותן כקובצי Markdown או קובצי ZIP. ‫Gemini Enterprise מחלץ אוטומטית את השם והתיאור של המיומנות מקובץ ה-SKILL.md.

פורמט הקובץ ומבנה הספרייה של המיומנות

חבילת מיומנות מורכבת מקובץ הנחיה חובה של SKILL.md ומתיקיות משנה אופציונליות לסקריפטים, למאמרי עזרה ולנכסים. אפשר להעלות קובץ SKILL.md נפרד או ארכיון ZIP עם מבנה התיקיות הבא:

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output
קובץ או ספרייה חובה תיאור
SKILL.md כן מכיל את המטא-נתונים של ה-frontmatter ב-YAML של המיומנות (כמו name ו-description), ואחריהם הוראות Markdown שמנחות את העוזר הדיגיטלי של Gemini Enterprise.
scripts/ לא סקריפטים של Python או Bash שניתנים להפעלה, לביצוע פעולות דטרמיניסטיות או חוזרות.
references/ לא הקשר נוסף שנטען לפי דרישה, כמו סכימות, דפי מידע או מאמרי העזרה של ה-API.
assets/ לא קבצים שמשמשים בפלט (כמו תבניות או תמונות) שלא נטענים ישירות להקשר של ההנחיה ב-Gemini Enterprise.

הדרישות לגבי Frontmatter של YAML

קובץ SKILL.md חייב להתחיל בבלוק Frontmatter תקין של YAML שמוקף בתווים המפרידים --- ממש בתחילת הקובץ, ואחריו גוף ההוראות ב-Markdown (מגבלה קשיחה של 500,000 תווים. העלאות שחורגות מהמגבלה הזו ייכשלו).

ה-YAML frontmatter תומך בשדות הבאים:

שדה חובה פורמט ומגבלות
name כן מזהה ייחודי של המיומנות (בין תו אחד ל-64 תווים). השם יכול להכיל רק אותיות קטנות (a-z), מספרים (0-9) ומקפים (-). הוא לא יכול להתחיל או להסתיים במקף (-) או להכיל מקפים רצופים (--). אם מעלים את הקובץ בתוך תיקייה, הערך של name חייב להיות זהה לשם של תיקיית ההורה.
description כן תיאור פונקציונלי (בין תו אחד ל-1,024 תווים) שמסביר מה הסקיל עושה ומתי Gemini Enterprise צריך להפעיל אותו. כדאי לכלול מילות מפתח להפעלה כדי לעזור ל-Gemini Enterprise לזהות מתי המיומנות רלוונטית. זו מגבלה קשיחה. אם התיאור חורג מ-1,024 תווים, העלאת המיומנות נכשלת ומוצגת השגיאה: A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license לא רישיון ההפצה של התוכנה או התוכן שחל על חבילת המיומנות (עד 1,024 תווים), כמו מזהה רישיון SPDX בקוד פתוח (לדוגמה, Apache-2.0 או MIT) או Proprietary. השדה הזה מציין את תנאי השימוש בקובץ הסקיל עצמו, ולא רישיון מינוי של משתמש בגרסה הארגונית או אפליקציה ב-Gemini Enterprise. אם מציינים ערך, הוא לא יכול להיות ריק.
metadata לא מפה אופציונלית של מפתח/ערך של תגים מותאמים אישית, מחברים או פרמטרים של גרסאות. המפתחות חייבים להיות מחרוזות סקלריות, והערכים חייבים להיות מחרוזות סקלריות או רשימות של מחרוזות סקלריות.

קובץ SKILL.md לדוגמה

הדוגמה הבאה מציגה קובץ SKILL.md תקין:

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

מגבלות על ארכיון ZIP

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

  • קובץ SKILL.md יחיד: כל ארכיון ZIP חייב להכיל קובץ SKILL.md אחד בדיוק, שנמצא בתיקיית השורש של הארכיון (SKILL.md) או בתוך תיקיית wrapper אחת ברמה העליונה (עד 3 רמות עומק, למשל my-skill/SKILL.md).
  • גודל הארכיון: הגודל המקסימלי של ארכיון ZIP דחוס הוא 100MB, והגודל המקסימלי הכולל של קובץ לא דחוס הוא 100MB.
  • מספר הקבצים: עד 100 קבצים בכל ארכיון ZIP.
  • עומק ההיררכיה של התיקיות: עומק ההיררכיה המקסימלי של התיקיות הוא 10 רמות ביחס לתיקיית השורש של הסקיל.
  • תקינות הנתיב: אסור להשתמש בנתיבי קבצים כפולים ובהפניות לספריית אם (..).

העלאת מיומנות לאתר

כדי להעלות מיומנות, פועלים לפי השלבים הבאים:

  1. נכנסים לאתר Gemini Enterprise.
  2. בתפריט הניווט, לוחצים על מיומנויות.
  3. לוחצים על סמל ההוספה ואז על העלאת מיומנות.
  4. גוררים את קובץ ה-Markdown או קובץ ה-ZIP או מחפשים אותו, ולוחצים על ייבוא. ‫Gemini Enterprise מפעיל את המיומנות כברירת מחדל.

עיון בסקילים

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

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

כדי לחפש ולהתקין מיומנות, פועלים לפי השלבים הבאים:

  1. נכנסים לאתר Gemini Enterprise.
  2. בתפריט הניווט, לוחצים על מיומנויות.
  3. לוחצים על סמל ההוספה ואז על עיון במיומנויות.
  4. מוצאים את המיומנות שרוצים להשתמש בה ולוחצים על + התקנה.

עדכון סקיל

כדי לעדכן מיומנות קיימת:

  1. נכנסים לאתר Gemini Enterprise.
  2. בתפריט הניווט, לוחצים על מיומנויות.
  3. לוחצים על השם של המיומנות שרוצים לעדכן.
  4. לוחצים על הסמל ליד המיומנות ולוחצים על עריכה.
  5. מעדכנים את ההוראות, השם או התיאור.
  6. לוחצים על Save.

כדי לחזור לדף "סקילים", לוחצים על סקילים.

איך לראות ולשחזר גרסאות של מיומנויות

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

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

  • תייגו את הסקיל ישירות בשדה להזנת קלט בצ'אט.
  • בדף Skills, בוחרים את המיומנות ולוחצים על New chat בחלונית התצוגה המקדימה.

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

  1. נכנסים לאתר Gemini Enterprise.
  2. בתפריט הניווט, לוחצים על מיומנויות כדי לפתוח את גלריית המיומנויות.
  3. בוחרים מיומנות שבבעלותכם כדי לפתוח את חלונית התצוגה המקדימה שלה.
  4. בחלונית התצוגה המקדימה, לוחצים על כפתור הפעולה ובוחרים באפשרות היסטוריית גרסאות. בחלונית היסטוריית גרסאות מופיעה רשימה של הגרסאות השמורות של המיומנות עם חותמות הזמן שלהן, והגרסה הפעילה מסומנת כ-Current.
  5. כדי לראות גרסה קודמת, לוחצים על הגרסה ברשימה. ההוראות והקבצים של הגרסה, כמו SKILL.md, נפתחים במצב קריאה בלבד.
  6. כדי לשחזר את הגרסה שמוצגת, לוחצים על Restore this version, ואז בתיבת הדו-שיח Restore this version?‎ לוחצים על Restore.

כשמשחזרים גרסה, היסטוריית הגרסאות לא נמחקת. במקום זאת, Gemini Enterprise מעתיק את ההוראות והקבצים של הגרסה שנבחרה ושומר אותם כגרסה חדשה, שהופכת לגרסה הנוכחית. לדוגמה, אם הגרסה הנוכחית היא 4 ואתם משחזרים את גרסה 3, Gemini Enterprise שומר את התוכן של גרסה 3 בתור גרסה 5, וגרסאות 3 ו-4 נשארות ללא שינוי בהיסטוריית הגרסאות.

שיתוף סקיל

אם האדמין של Gemini Enterprise הפעיל את שיתוף המיומנויות, אתם יכולים לשתף את המיומנויות שאתם יוצרים עם משתמשים אחרים.

כדי לשתף מיומנות:

  1. נכנסים לאתר Gemini Enterprise.
  2. בתפריט הניווט, לוחצים על מיומנויות.
  3. מוצאים את הסקיל שרוצים לשתף.
  4. לוחצים על הסמל ליד המיומנות ולוחצים על שיתוף.
  5. בתיבת הדו-שיח Share skill, מזינים את כתובות האימייל של המשתמשים שרוצים לשתף איתם את המיומנות, מופרדות בפסיקים.
  6. לוחצים על סיום.

שימוש במיומנות

אתם יכולים להשתמש במיומנויות ישירות בשיחות באתר Gemini Enterprise.

איך בודקים מיומנות מהדף "מיומנויות"

אתם יכולים לבדוק מיומנות ישירות מהדף מיומנויות על ידי התחלת שיחת צ'אט חדשה עם המיומנות הזו:

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

איך מפעילים מיומנות בשיחה

אתם יכולים להפעיל מיומנויות באופן דינמי במהלך שיחה כדי להתאים אישית את התשובות של Assistant.

כשאתם משוחחים עם העוזר האישי של Gemini Enterprise, אתם יכולים להשתמש במיומנויות בדרכים הבאות:

  • תיוגים ידניים: אתם יכולים להפעיל מיומנות באופן מפורש באמצעות תכונת התיוג @ או / בתיבת הצ'אט (לדוגמה, @Brand Voice או /Brand Voice). הקלדה של / פותחת תפריט שבו מוצגות רק המיומנויות הזמינות שלכם, והקלדה של @ פותחת את תפריט התיוגים הכללי.
  • בקשות ישירות: אם אתם רוצים ש-Gemini Enterprise ישתמש במיומנות ספציפית, אתם יכולים לבקש את זה ישירות בהנחיה. לדוגמה, Use the brand voice skill to review this.
  • בחירה אוטומטית: Gemini Enterprise משתמש במיומנות באופן אוטומטי כשהיא רלוונטית למשימה, על סמך התיאור של המיומנות וההוראות להפעלה שלה.

השבתת מיומנות

כדי למנוע מ-Gemini Enterprise להשתמש במיומנות מסוימת, משביתים אותה. כשמשביתים מיומנות, Gemini Enterprise לא מפעיל אותה בשיחות.

כדי להשבית מיומנות:

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

הסרת סקיל

כדי להסיר סקיל שהתקנתם מהדף סקילים:

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

מצבי הסקילים

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

  • מושעה: האדמין השבית את המיומנות באופן זמני. היא תמשיך להופיע בדף מיומנויות בסטטוס "מושעית", אבל משתמשים אחרים לא יוכלו להפעיל אותה בשיחות עד שהאדמין יפעיל אותה מחדש. בעלי הסקיל יכולים לעדכן ולבדוק אותו.
  • מושבת: האדמין מסתיר באופן זמני את המיומנות ממשתמשים אחרים, ומסיר אותה מהדף מיומנויות שלהם. היכולת נשארת גלויה לבעלים שלה, שיכולים לעדכן ולבדוק אותה עד שהאדמין יפעיל אותה מחדש.
  • נמחקה: האדמין הסיר את המיומנות באופן סופי מאתר Gemini Enterprise, ולכן אתם לא יכולים להשתמש בה יותר.

מגבלות

בקטע הזה מפורטות המגבלות של המיומנויות ב-Gemini Enterprise:

  • אי אפשר להשתמש במיומנויות עם סוכנים.
  • המיומנויות תומכות רק בהרצה של Python ו-Bash.
  • בעורך של אפליקציית האינטרנט, אתם יכולים ליצור סקילים על ידי הזנת הוראות בשדות הטופס או באמצעות צ'אט עם העוזר הדיגיטלי, שיוצר באופן אוטומטי קובץ SKILL.md יחיד. סקילים מורכבים יותר שדורשים סקריפטים או קבצים נוספים צריך להעלות כקובץ ZIP.
  • יצירת מיומנויות בשפה טבעית לא משתמשת בהקשר של השיחה או במחברים כקלט ליצירת מיומנות.
  • הסקילים פועלים בצורה הטובה ביותר ב-Canvas כשיש להם רק קובץ SKILL.md אחד.
  • בקובץ SKILL.md יש מגבלות אורך קשיחות של 64 תווים ל-name, 1,024 תווים ל-description ו-500,000 תווים לגוף ההוראות ב-Markdown. ארכיוני ZIP שמעלים לא יכולים לחרוג מ-100MB (דחוסים או לא דחוסים), מ-100 קבצים או מ-10 רמות של תיקיות משנה.
  • רק הבעלים של הסקיל יכולים לראות את היסטוריית הגרסאות שלו ולהשתמש בה. היסטוריית הגרסאות לא זמינה למיומנויות שנוצרו על ידי משתמשים אחרים או למיומנויות שמנוהלות על ידי Google.

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