הבעיה

כשהסוכן עובד, מערך ההודעות שלו גדל. כל קריאת קובץ, כל פלט bash נשאר ב-context לנצח. “איזה framework בדיקות משתמש הפרויקט הזה?” עשוי לדרוש קריאת 5 קבצים, אבל ההורה צריך רק את התשובה: “pytest.”

הפתרון

Parent agent                     Subagent
+------------------+             +------------------+
| messages=[...]   |             | messages=[]      | <-- fresh
|                  |  dispatch   |                  |
| tool: task       | ----------> | while tool_use:  |
|   prompt="..."   |             |   call tools     |
|                  |  summary    |   append results |
|   result = "..." | <---------- | return last text |
+------------------+             +------------------+

Parent context stays clean. Subagent context is discarded.

איך זה עובד

ההורה מקבל כלי task. הילד מקבל את כל הכלים הבסיסיים חוץ מ-task (ללא ייצור רקורסיבי).

PARENT_TOOLS = CHILD_TOOLS + [
    {"name": "task",
     "description": "Spawn a subagent with fresh context.",
     "input_schema": {
         "type": "object",
         "properties": {"prompt": {"type": "string"}},
         "required": ["prompt"],
     }},
]

התת-סוכן מתחיל עם messages=[] ומריץ לולאה משלו. רק הטקסט הסופי חוזר להורה.

def run_subagent(prompt: str) -> str:
    sub_messages = [{"role": "user", "content": prompt}]
    for _ in range(30):  # safety limit
        response = client.messages.create(
            model=MODEL, system=SUBAGENT_SYSTEM,
            messages=sub_messages,
            tools=CHILD_TOOLS, max_tokens=8000,
        )
        sub_messages.append({"role": "assistant",
                             "content": response.content})
        if response.stop_reason != "tool_use":
            break
        results = []
        for block in response.content:
            if block.type == "tool_use":
                handler = TOOL_HANDLERS.get(block.name)
                output = handler(**block.input)
                results.append({"type": "tool_result",
                    "tool_use_id": block.id,
                    "content": str(output)[:50000]})
        sub_messages.append({"role": "user", "content": results})
    return "".join(
        b.text for b in response.content if hasattr(b, "text")
    ) or "(no summary)"

כל היסטוריית ההודעות של הילד (אולי 30+ קריאות כלי) נזרקת. ההורה מקבל סיכום של פסקה אחת כ-tool_result רגיל.

מה השתנה מ-TodoWrite

רכיב	לפני (TodoWrite)	אחרי (תת-סוכנים)
כלים	5	5 (base) + task (parent)
Context	שיתוף יחיד	בידוד הורה + ילד
תת-סוכן	אין	פונקציה `run_subagent()`
ערך החזרה	N/A	טקסט סיכום בלבד

מסקנה מרכזית

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

מדריך קוד אינטראקטיבי

פונקציית spawn_subagent

1def run_subagent(prompt: str) -> str:
2    sub_messages = [{"role": "user", "content": prompt}]
3    for _ in range(30):  # safety limit
4        response = client.messages.create(
5            model=MODEL, system=SUBAGENT_SYSTEM,
6            messages=sub_messages,
7            tools=CHILD_TOOLS, max_tokens=8000,
8        )
9        sub_messages.append({"role": "assistant",
10                             "content": response.content})
11        if response.stop_reason != "tool_use":
12            break
13        results = []
14        for block in response.content:
15            if block.type == "tool_use":
16                handler = TOOL_HANDLERS.get(block.name)
17                output = handler(**block.input)
18                results.append({"type": "tool_result",
19                    "tool_use_id": block.id,
20                    "content": str(output)[:50000]})
21        sub_messages.append({"role": "user", "content": results})
22    return "".join(
23        b.text for b in response.content if hasattr(b, "text")
24    ) or "(no summary)"
25

התת-סוכן מתחיל עם רשימת הודעות חדשה לגמרי המכילה רק את ה-prompt שהואצל. שום דבר מהיסטוריית ההורה לא דולף — בידוד הקשר אמיתי.

שלב 1 מתוך 6

4. תת-סוכנים

מה זה תת-סוכן?

למה לא לשמור הכל בשיחה אחת?

האם תת-סוכנים יכולים לייצר תת-סוכנים משלהם?

מה קורה לעבודת התת-סוכן?