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

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

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

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

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

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

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

סקירה כללית

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

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

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

הערה: אי אפשר ליצור מיומנויות במהדורת Gemini Enterprise Frontline. מידע נוסף זמין במאמר מהדורות נתמכות.

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

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

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

הערה: אי אפשר להעלות מיומנויות במהדורת Gemini Enterprise Frontline. מידע נוסף זמין במאמר מהדורות נתמכות.

כדי להוסיף מיומנויות קיימות, מעלים אותן כקובצי 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 חייב להתחיל בבלוק YAML frontmatter תקין שמוקף בתווים המפרידים --- ממש בתחילת הקובץ, ואחריו גוף ההוראות ב-Markdown (מגבלה קשיחה של 500,000 תווים. העלאות שחורגות מהמגבלה הזו נכשלות).

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

שדה	חובה	פורמט ומגבלות
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 מפעיל את המיומנות כברירת מחדל.

הערה: אם ההעלאה נכשלת ומוצגת שגיאה כמו Upload failed. Details: Request contains an invalid argument, צריך לוודא את הדברים הבאים:

• קובץ ה-SKILL.md מתחיל ב-Frontmatter תקין של YAML שמוקף בתווי ההפרדה ---.
• ה-frontmatter כולל את השדות הנדרשים name ו-description, במסגרת מגבלות התווים שלהם.
• השדה name מכיל רק אותיות קטנות, מספרים ומקפים (ותואם לשם של תיקיית ההורה אם הוא הועלה בארכיון ZIP).
• הארכיון עומד במגבלות של ארכיון ZIP.

עיון בסקילים

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

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

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

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

עדכון סקיל

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

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

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

שיתוף סקיל

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

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

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

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

הערה: אם האדמין של Gemini Enterprise דורש אישור לבקשות שיתוף, משתמשים אחרים לא יכולים לגשת למיומנות עד שהאדמין מאשר את הבקשה.

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

אתם יכולים להשתמש במיומנויות ישירות בשיחות באתר 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 רמות של ספריות מקוננות.

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

• איך אדמינים מנהלים מיומנויות