기계 번역

이 페이지는 AI에 의해 자동 번역되었으며 오류가 있을 수 있습니다. 모호한 점이 있으면 간체 중국어 원문을 기준으로 하십시오.

간체 중국어 원문 · 번역 문제 신고

하위 에이전트와 중단

---

1. 귀속 폭포수 차트 (백그라운드 하위 에이전트 부하의 결정적 귀속)

각 백그라운드 중첩 workflow_payload는 한 곳에서만 렌더링되며, 절대 이중 렌더링되지 않습니다. 여기서는 판정 함수와 데이터 구조에 해당합니다. 세 수준 모두 parsers.py에 있으며, 마운트 지점은 adapter.get_thread(adapter.py:150-157, computer/council만 실행):

flowchart TD
    BG["background_entries 顶层嵌套 workflow_payload<br/>（_iter_top_wf_payloads，parsers.py:343<br/>只取顶层不递归——嵌套随父负载整体渲染，防双重计入）"]

    BG --> L1{"① 主 entry 锚点命中？<br/>_anchored_payload_ids（parsers.py:369）<br/>主 entries 的 run_subagent 步骤<br/>含同 id 的 workflow_payload"}
    L1 -->|"是"| R1["发起轮内渲染<br/>adapter.sub_agents 建 sub_map（adapter.py:207-270）<br/>render_wf_step → render_subagent（render.py:404,363）<br/>prompt=objective_chunks 拼接<br/>steps/answer/sources 取自 plain background_entries"]
    L1 -->|"否"| L2{"② subagent_result 桩轮 10s 窗命中？<br/>match_stub_workflows（parsers.py:385）"}
    L2 -->|"是"| R2["桩轮「## 子代理工作」段<br/>turn.stub_wfs（models.py:131）<br/>_render_nested_wf 折叠块（render.py:46）<br/>答案不回填，Answer 保持 （无）"]
    L2 -->|"否"| R3["③ 线程附录兜底<br/>collect_unconsumed_background（parsers.py:491）<br/>conv.unconsumed_bgs（models.py:170）<br/>conversation.md 末尾「## 后台任务（未归入轮次）」<br/>render_bg_appendix（render.py:601）"]

    R1 -.-> ONE(["每条负载只落一处<br/>绝不双渲染"])
    R2 -.-> ONE
    R3 -.-> ONE

각 수준 판정 세부 사항:

• ① 앵커: _anchored_payload_ids는 _iter_wf_payloads(parsers.py:327, 재귀적 하향)를 사용하여 메인 항목이 이미 앵커링한 모든 페이로드 ID를 수집합니다. 하위 에이전트의 실제 상태는 백그라운드 측을 기준으로 합니다—— adapter.sub_agents는 백그라운드 항목의 workflow_block.status/locked_reason를 사용하여 SubAgent.status/locked_reason(adapter.py:227-244)을 채웁니다. 앵커 측 상태는 지연될 수 있기 때문입니다(실측 cfca382d에서 앵커는 COMPLETED, 백그라운드는 CANCELED).
• ② 말뚝 창: 말뚝 라운드 = trigger=="subagent_result"이고 블록에 워크플로 단계가 없음(parsers.py:422). 후보는 ①을 제외한 최상위 페이로드입니다. |后台完成时间 − 桩创建时间| ≤ 10s의 모든 쌍은 시간 차이 오름차순으로 탐욕적으로 매칭되며, used_cand 집합은 각 백그라운드가 한 번만 소비되도록 보장합니다(parsers.py:452-467). 하나의 말뚝이 여러 에이전트를 수용할 수 있습니다. 완료 시간은 payload.completed_at를 사용하며, 없으면 백그라운드 항목 업데이트 시간으로 대체합니다(중단 시나리오에서는 완료 알림이 없음, parsers.py:444-446).
• ③ 부록: collect_unconsumed_background는 ①의 앵커링과 ②의 소비를 모두 제외한 후, 남은 최상위 부하는 모두 그대로 기록됩니다(parsers.py:491-532)——중단된 백그라운드 작업은 subagent_result 완료 알림을 생성하지 않으므로, 처음 두 수준은 반드시 실패합니다. 상태는 제한 없음(AWAITING/CANCELED/COMPLETED/미래 값). 위치는 conversation.md 끝에 고정되며, 시간 귀속 추측 없음, turns/에 추가되지 않음(부록은 스레드 수준, render.py:601-638).

---

2. 중단 의미 상태 다이어그램

통일된 진실 소스 parsers.classify_wf_status(parsers.py:263-284): workflow status + locked_reason → 다섯 가지 유형. 세 가지 소비 경로가 동일한 분류 결과를 공유하며, COMPLETED는 절대 주석을 추가하지 않음(정상 스레드는 diff 없음).

stateDiagram-v2
    state "completed 完成" as c1
    state "limit_interrupted 限额中断" as c2
    state "awaiting 中断待续" as c3
    state "canceled 已取消" as c4
    state "other 未知取值" as c5
    state "静默：不加注/不登记/不告警" as quiet
    state "标注：wf_status_tag（parsers.py:294-299）" as tag
    state "渲染消费：工作过程标题（render.py:540-541）/ 子代理标题（render.py:367-368）/ 嵌套 details summary（render.py:116-119）" as consume1
    state "登记消费：thread.json.interruptions（parsers.py:535；写入 fs_writer.py:242-244；无中断不出现该键）" as consume2
    state "告警消费：scan_wf_anomalies → log.warning（parsers.py:646；adapter.py:131-134）" as consume3
    state "续跑覆盖：lastUpdated 变化 → plan_incremental 判 updated → 增量重抓（无需特例代码）" as cont

    [*] --> c1 : status 为空 / COMPLETED / WORKFLOW_COMPLETED（parsers.py:278-279）
    [*] --> c2 : WORKFLOW_AWAITING_NEXT_STEPS + locked_reason=spending_limit_exceeded（parsers.py:280-281）
    [*] --> c3 : WORKFLOW_AWAITING_NEXT_STEPS 无 locked_reason
    [*] --> c4 : WORKFLOW_CANCELED（parsers.py:282-283）
    [*] --> c5 : 其他未知取值（parsers.py:284）

    c1 --> quiet
    c5 --> quiet : 无标注（枚举未覆盖，不打扰渲染）
    c2 --> tag : 「⏸ 限额中断（内容截至中断点）」
    c3 --> tag : 「⏸ 中断待续」
    c4 --> tag : 「⛔ 已取消」
    tag --> consume1
    tag --> consume2
    c2 --> consume3
    c3 --> consume3
    c4 --> consume3
    c5 --> consume3
    consume2 --> cont : 中断后被用户继续

데이터 출처 및 실측 분포(자세한 내용은 ../reference/api/api-responses-errors.md §5.1 참조):

• locked_reason는 thread_metadata / entries / background_entries 세 수준에서 나타나며, 실측 유일 값은 spending_limit_exceeded입니다. parse_turn는 항목 수준 값을 turn.metadata["locked_reason"](parsers.py:205-208)에 저장합니다.
• 중단 표시 추가 지점의 상태 출처: 라운드 수준은 turn.metadata["wf_status"] (attach_workflow_blocks 마운트, parsers.py:256); 하위 에이전트는 백그라운드 측 실제 상태 (SubAgent.status, adapter.py:257-260); 부록 항목은 페이로드 자체 status.
• thread.json.interruptions 각 {location, kind, headline, status}, location 형식은 turn_0007 / turn_0011/subagent / turn_0024/subagent_stub / background_unassigned(parsers.py:535-583).
• re-render --thread-json는 오프라인에서 해당 키를 추가/삭제할 수 있습니다(rerender_cmd.py:141-169, §12 참조).