מדריך גרוק CLI בעברית

פרק 11

סוכני משנה, פרסונות ו-Workflows

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

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

מנגנון סוכני המשנה פעיל כברירת מחדל. ניתן להשביתו באמצעות GROK_SUBAGENTS=0 או הגדרת [subagents] enabled = false בקובץ התצורה.

#הבחנה בין סוכנים, פרסונות ודשבורד

חשוב להכיר את ההבדל בין שלושת המושגים:

מושגמה הוא מגדירמיקום ההגדרהפקודת ניהול ב-TUI
סוכן (Agent)תצורת סשן שלמה: מודל שפה, כלי מערכת, והנחיית בסיס.grok/agents/ או ~/.grok/agents//config-agents (כינוי: /agents)
פרסונה (Persona)שכבת התנהגות ייעודית המוצמדת לסוכן משנהconfig.toml או .grok/personas//personas
לוח בקרה (Dashboard)ממשק תצוגה וניטור של כל הסשנים הפעילים בזמן אמתתהליך הריצה הנוכחי/dashboard או Ctrl+\

#סוגי סוכני משנה מובנים

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

סוג סוכןייעוד ויכולותמגבלות והרשאות
general-purposeסוכן רב-תכליתי כללי (ברירת מחדל)גישה לכל הכלים: קריאה, כתיבה והרצת Shell
exploreסוכן חקירה, סריקה ומיפוי קודקורא קבצים, מחפש ומריץ Shell לבדיקה. אינו יכול לערוך קבצים
planסוכן מחקר ותכנון ארכיטקטוניחוקר את המערכת וכותב תוכנית פעולה. אינו נוגע בקוד

#מצבי יכולת ובידוד דיסק

  • מצבי יכולת (capability_mode): ניתן להגביל סוכן משנה למצבים: read-only, read-write, execute או all.
  • בידוד באמצעות Worktree: הגדרת isolation: worktree מפעילה את סוכן המשנה בתוך Git Worktree נפרד לחלוטין, כך ששינויים שהוא מבצע אינם משפיעים על תיקיית העבודה של סוכן האב. ברירת המחדל היא none (עבודה באותה תיקייה).
  • ריצה ברקע (background: true): סוכן המשנה רץ ברקע ומחזיר מיד מזהה לסוכן האב. סוכן האב יכול להמשיך בעבודתו ולאסוף את התוצאות כשהן מוכנות.

#הגדרת פרסונות מותאמות אישית

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

הגדרה בקובץ ~/.grok/config.toml או .grok/config.toml:

[subagents.personas.researcher]
description = "חוקר מעמיק של בסיס הקוד"
instructions = "אתה חוקר קוד מומחה. תמיד ציין נתיבי קבצים מדויקים ומספרי שורות. התמקד באיתור שגיאות נסתרות ותלויות הדדיות."
model = "grok-4.6"
effort = "high"

ניתן גם ליצור קובץ ייעודי בנתיב .grok/personas/researcher.toml. הגדרה בקובץ config.toml מקבלת קדימות על פני קבצים בודדים.

#מצב תכנון בסוכן הראשי (Plan Mode)

יש להבחין בין סוכן משנה מסוג plan לבין מצב תכנון של הסשן הראשי:

מצב התכנון הראשי מופעל באמצעות הפקודה /plan [הנחיה] או קיצור המקלדת Shift+Tab.

במצב זה:

  1. הסוכן הראשי רשאי לקרוא קבצים ולהריץ שאילתות, אך מותר לו לערוך רק את קובץ plan.md של הסשן.
  2. כל ניסיון עריכה של קובץ פרויקט אחר נחסם באופן קשיח (גם אם אתם במצב always-approve).
  3. בסיום כתיבת התוכנית, נפתח מסך אישור:
    • a: אישור התוכנית ותחילת בנייה ומימוש.
    • s: הזנת תיקונים והנחיות להמשך חידוד התוכנית.
    • q: ביטול ויציאה ללא שינוי.

#מנוע ה-Workflows (שפת Rhai)

מנוע ה-Workflows מאפשר לתסרט תהליכי פיתוח מרובי-שלבים וסוכנים באמצעות שפת התסרוט Rhai.

קובצי ה-Workflows נשמרים בתיקיות:

  • .grok/workflows/*.rhai (ברמת הפרויקט)
  • ~/.grok/workflows/*.rhai (ברמת המשתמש)

הפעלה וניהול ב-TUI:

/workflow review-changes {"target":"origin/main...HEAD"}
/workflows

#משימות אוטונומיות מובנות

  • /deep-research <נושא>: מפעיל חקירה מעמיקה ברקע הכוללת אימות והצלבת מקורות מידע ברשת ובפרויקט.
  • /goal <מטרה>: מפעיל לולאת פעולה אוטונומית הממשיכה לרוץ עד שמנגנון בדיקה עצמאי מוודא שהיעד הושג במלואו.

#תקציב משאבים ומקביליות

  • תקציב ברירת מחדל: עד 128 קריאות סוכן ילד מצטברות לתהליך (ניתן להגדרה עד תקרה של 1,024).
  • מקביליות: עד 32 סוכני משנה יכולים לרוץ במקביל בו-זמנית, ושאר הבקשות ממתינות בתור.

#לוח בקרת הסוכנים (Dashboard)

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

  • פתיחה: הקשת Ctrl+\, הפקודה /dashboard, או הרצת grok dashboard מהטרמינל.
  • סטטוסים בזמן אמת: דורש קלט (Needs input), עובד (Working), ממתין (Idle), הושלם (Completed), או נכשל (Failed).
  • מעבר וקיבוץ: הקשת Ctrl+G מקבצת את הסוכנים לפי תיקיית פרויקט.
  • הצצה ומענה: בחירת שורה עם החצים מציגה חלונית הצצה לפעילות הסוכן. ניתן לענות ישירות על שאלות ואישורים באמצעות מקשי המספרים, או להקיש Enter לכניסה לסשן המלא.
  • יצירת סוכנים חדשים: סרגל הקלט התחתון מאפשר שיגור סוכנים חדשים, כאשר Ctrl+L משנה את תיקיית היעד ו-Ctrl+W קובע האם להפעילם ב-Git Worktree נפרד.

בפרק הבא נלמד על אוטומציה מתקדמת באמצעות ה-CLI, מצב Headless, ופרוטוקול ACP.