הגדרת סוכן

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

שדות ישות הסוכן

שדה	טיפוס	נדרש	תיאור
`id`	`String`	כן	מזהה ייחודי של הסוכן
`name`	`String`	כן	מזהה קצר לאזכורים ב-@
`title`	`String`	כן	תואר תפקיד בשפה אנושית
`agentMdPath`	`String`	כן	נתיב מוחלט לקובץ ההגדרה `.md` של הסוכן
`workspaceId`	`String`	כן	סביבת העבודה הבעלים (אינה null)
`reportsTo`	`String?`	לא	המזהה של סוכן האב
`skills`	`AgentSkills`	כן	סט של מזהי מיומנויות
`persona`	`String?`	לא	הוראות התנהגות בטקסט חופשי
`systemPrompt`	`String?`	לא	עקיפת הנחיית המערכת המוגדרת כברירת מחדל
`adapterId`	`String?`	לא	המזהה של מתאם ההסקה
`modelId`	`String?`	לא	מזהה המודל בתוך המתאם
`strictMode`	`bool`	לא	ברירת מחדל `false`. נכתב לשורה ולקובץ `AGENTS.md` של הסוכן
`effort`	`String?`	לא	מזהה רמת החשיבה (למשל `'low'`, `'xhigh'`), שמקורו ב-`thinkingLevels` של המודל הנבחר
`contextSize`	`int?`	לא	גודל חלון ההקשר המרבי
`role`	`AgentRole?`	לא	תפקיד הסוכן
`monthlyBudgetCents`	`int`	לא	תקרת הוצאה חודשית בסנטים (ברירת מחדל `0`, ללא הגבלה)
`silenceTimeoutMinutes`	`int?`	לא	עקיפה של מנגנון ניטור השקט בדקות; חייבת להיות null או בטווח 1–240 (נאכף בבנאי)
`maxConcurrentTasks`	`int`	לא	ברירת מחדל `1`. נתון הקיבולת שמודל הנוכחות מדווח (ספירות ההרצות והתורים מושוות אליו)
`visibility`	`AgentVisibility`	לא	ברירת מחדל `workspace`
`lifecycleStatus`	`AgentLifecycleStatus`	לא	סטטוס ממשל (ברירת מחדל `active`). נכתב בעצירה הקשה של התקציב ומוצג בתרשים הארגון ובסגל הנוכחות. השליחה עדיין מקבלת עבודה מסוכן `paused`
`budgetPolicyId`	`String?`	לא	המזהה של מדיניות תקציב משותפת; כשהוא null חל `monthlyBudgetCents` ישירות
`runtimeProfileId`	`String?`	לא	המזהה של פרופיל הרצה מותאם
`createdAt`	`DateTime`	כן	חתימת זמן היצירה

name ו-title חייבים שניהם להיות לא ריקים (נאכף בבנאי). ברירת המחדל 0 של monthlyBudgetCents פירושה ללא הגבלה. כתבו תקרה באמצעות agents.upsert.

ה-enum‏ AgentRole

תפקיד	תווית	תיאור
`ceo`	CEO	תיאום והאצלה
`coder`	Coder	מימוש קוד
`reviewer`	Reviewer	סקירת PR וניתוח
`qa`	QA	בדיקות והבטחת איכות
`designer`	Designer	מימוש UI/UX
`security`	Security	סקירת אבטחה וביקורת
`devops`	DevOps	תשתיות ופריסה
`pm`	PM	ניהול מוצר
`general`	General	גמיש, רב-שימושי

ה-enum‏ AgentVisibility

ערך	תיאור
`workspace`	ברירת המחדל; ערכים שמורים לא מוכרים ו-null מפוענחים אליה
`private`	פרטי למשתמש שיצר את הסוכן

ה-enum‏ AgentLifecycleStatus

ערך	תיאור
`active`	ברירת המחדל. `isDispatchable` הוא true רק עבור הערך הזה
`paused`	נקבע בעצירה הקשה של התקציב. מוצג בסגל הנוכחות; השליחה עדיין מקבלת עבודה
`archived`	הוצא משימוש ומוסתר מהסגלים הפעילים

הרשאות

סוכנים אינם נושאים דגלי הרשאה. דחיפה, פתיחה ופרסום של בקשות משיכה, כתיבה למערכת מעקב ותעבורה יוצאת לרשת הן מחלקות פעולה (gitPush, prCreate, prPublish, vendorSyncWrite, networkEgress) שמעקות הבטיחות מכריעים בטווח של סביבת עבודה, סוכן או מרחב. אסימון ה-GitHub של הרצה מוגבל תמיד לקריאה; דחיפות עוברות דרך שער הרצת הסוכן, ששואל את הכלל gitPush לפני שהוא מעביר אותן.

AgentSkills

סט בלתי ניתן לשינוי ושאינו תלוי רישיות של מזהי מיומנויות. בעת השליחה ה-slugs האלה מסונכרנים כקישורי מיומנויות בשכבת-העל של הסוכן; מנגנון ההרצה טוען אז אוטומטית את ה-frontmatter של המיומנויות המקושרות אל ההנחיה.

{'flutter', 'dart', 'rest-api'}

AgentLiveState (נגזר)

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

מצב	`sortPriority`	תנאי
`running`	0	ליומן הרצה כלשהו יש סטטוס `running`
`blocked`	1	מצב החיות של ההרצה האחרונה הוא `blocked`, `stalled` או `looping`
`failed`	2	הסטטוס של ההרצה האחרונה הוא `error`, או שמצב החיות שלה הוא `failed` או `dead`
`queued`	3	הרצה נשלחה אך אינה מתבצעת — היא חונה מאחורי הרצה אחרת של אותו סוכן, או שנכתבה אך טרם החלה
`succeeded`	4	ההרצה הסתיימה בהצלחה
`idle`	5	הסוכן כבר רץ בעבר ואין לו דבר באוויר
`neverRun`	6	לא קיימים יומני הרצה

queued ו-succeeded הם להרצה בודדת בלבד. deriveAgentLiveState, שמחשב את מצב הסגל של סוכן, לעולם אינו מפיק אף אחד מהם — הוא מחזיר neverRun, running, failed, blocked או idle.