סקירה כללית

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


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


למבוא לתוספים ולאפליקציות הכלולות בהם, ראו: תוספים ב-ChatGPT וב-Codex.

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

• השתמשו בחשבון GitHub עם הרשאת קריאה למאגר של זירת התוספים ולכל מאגר אחר שאליו היא מפנה. יש תמיכה במאגרים ציבוריים ופרטיים ב-github.com.

• השלימו כל הליך אישור שנדרש בארגון ב-GitHub כדי שהחשבון שמבצע את הייבוא יוכל לגשת למאגרים האלה.

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

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

ייבוא זירת תוספים

1. עברו אל מסוף הניהול, בחרו את ה-workspace הרצוי ב-ChatGPT ופתחו את תוספים. לאחר מכן בחרו הוספה ואז ייבוא זירת תוספים.

2. בשדה מקור, הזינו את כתובת ה-URL של המאגר, למשל https://github.com/example/team-plugins. השתמשו בכתובת ה-URL של המאגר בלבד, ולא בכתובת של ענף או תיקייה.

3. אם זירת התוספים נמצאת בתיקיית משנה, הזינו את התיקייה הזו בשדה נתיב. לדוגמה, הזינו team-tools עבור team-tools/.agents/plugins/marketplace.json. אם זירת התוספים נמצאת בתיקיית השורש של המאגר, השאירו את השדה נתיב ריק. אל תזינו את שם קובץ המניפסט.

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

5. בחרו ייבוא זירת תוספים ואשרו את הגישה ל-GitHub כשתתבקשו.

6. בדקו את תוצאות הייבוא, ואז פתחו כל תוסף שיובא כדי להגדיר את מדיניות ההתקנה שלו ואת האפליקציות הנדרשות.

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

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

פורמטים נתמכים

התיקייה שנבחרה חייבת להכיל מניפסט נתמך:

• .agents/plugins/marketplace.json עבור זירת תוספים של Codex.

• .claude-plugin/marketplace.json עבור זירת תוספים תואמת Claude.

• .claude-plugin/plugin.json עבור תוסף Claude עצמאי כשאין מניפסט של זירת תוספים.

רשומות בזירת התוספים יכולות להפנות לתיקיות תוספים באותו מאגר או למקורות נתמכים במאגרי GitHub. הייבוא ל-workspace אינו תומך בשירותי אחסון Git אחרים ובמקורות ממרשמי חבילות, כגון npm.

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

הגדרת גישה ב-workspace

GitHub מספק את תוכן התוספים, ואילו הגדרות ה-workspace קובעות את אופן ההתקנה והאימות. ייבוא וסנכרון אינם מחילים ערכי מדיניות מהמאגר, כגון AVAILABLE או ON_USE. קבעו את ההגדרות האלה לכל תוסף ב-workspace שלכם.


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


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


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

שמירה על תוספים מעודכנים

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

1. עברו אל מסוף הניהול, בחרו את ה-workspace הרצוי ב-ChatGPT ופתחו את תוספים.

2. פתחו את זירות תוספים ובחרו את הזירה.

3. בחרו סנכרון כעת.

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

בדיקת תוצאות הסנכרון

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


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


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

המשמעות של הסרה ומחיקה

הסרת רשומה מהמאגר אינה מוחקת את העותק שלה שיובא ל-workspace. התוסף מסומן ככבר לא נמצא במקור.


מחיקת זירת התוספים ב-ChatGPT מוחקת את כל התוספים שיובאו ממנה. אל תמחקו זירת תוספים כדי לחבר מחדש את GitHub או לשנות בעלות.

חיבור מחדש או שינוי הגישה ל-GitHub

סנכרון זירת התוספים משתמש בחיבור ל-GitHub של מנהל המערכת שייבא אותה. לחשבון הזה צריכה להישאר גישה למאגר של זירת התוספים ולכל המאגרים שאליהם היא מפנה.

חיבור מחדש של החשבון המקורי

1. ודאו שלחשבון GitHub ששימש לייבוא עדיין יש גישה לכל המאגרים הנדרשים.

2. בקשו ממנהל המערכת שייבא את זירת התוספים במקור לפתוח את תוסף GitHub ב-ChatGPT ולחבר מחדש את החשבון שלו.

העברה למנהל מערכת חדש

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

1. עברו אל מסוף הניהול, בחרו את ה-workspace הרצוי ב-ChatGPT ופתחו את תוספים. לאחר מכן בחרו הוספה > ייבוא זירת תוספים.

2. הזינו בשדות מקור, נתיב וענף, תג או commit את אותם ערכים ששימשו לזירת התוספים הקיימת.

3. בחרו ייבוא זירת תוספים ואשרו את הגישה ל-GitHub כשתתבקשו.

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

העברת תוסף קיים לניהול דרך GitHub

אפשר להשתמש בזירת תוספים כדי לנהל תוסף קיים ב-workspace שהועלה כקובץ ארכיון או שעדיין אינו מנוהל באמצעות מקור ב-GitHub. התוסף הקיים חייב להיות באותו workspace ובעל אותו שם תוסף. אי אפשר להעביר בדרך זו את הניהול של תוסף שמנוהל באמצעות מקור אחר ב-GitHub.


כדי לציין את התוסף הקיים בזירת התוספים שלכם:

1. עברו אל מסוף הניהול, בחרו את ה-workspace הרצוי ב-ChatGPT ופתחו את תוספים. פתחו את התוסף.

2. העתיקו את מזהה התוסף שמופיע אחרי /admin/plugins/ בכתובת ה-URL שלו.

3. הוסיפו את המזהה כערך של pluginId לצד name ו-source ברשומה המתאימה במערך plugins של זירת התוספים. אל תוסיפו אותו לקובץ plugin.json של התוסף.

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


לדוגמה להעברה ולדרישות, ראו: ניהול תוספים.

הפניה לאפליקציה קיימת

תוסף יכול להפנות לאפליקציה קיימת בקובץ .app.json שבתיקיית השורש של התוסף. הקפידו לכלול את הנקודה בתחילת שם הקובץ, ולהשתמש במזהה האפליקציה ולא במזהה תוסף. בתוסף מקורי, הגדירו את השדה apps בקובץ .codex-plugin/plugin.json לערך ./.app.json.


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


לפרטים על פורמט ה-JSON, ראו: ניהול תוספים.

המשמעות של התווית ״למחשב בלבד״

תוסף שמסומן בתווית למחשב בלבד אינו יכול לפעול ב-ChatGPT בדפדפן. תוספים שיובאו עשויים לקבל את התווית הזו אם הם מצהירים על שרתי MCP, למשל בקובץ mcp.json או .mcp.json, גם אם השרת משתמש בכתובת HTTPS מרוחקת.


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