前言¶
DeepSeek Harness (DSH) 採用插件化架構,其核心依賴 Cordis。在智能體開發中,當子 Agent 的步驟激活 settled 後,它會喚醒父級。然而,如果父級當前正忙,運行時通常會將父級編寫的 subagent-settled 響應放入下一個安全的 Agent 步驟中。
這會導致父級在處理普通上下文之前,先處理子代理的回調。dsh-subagent-response-promoter 插件旨在穩定地將這些響應提升到該步驟的普通上下文之前,確保父級優先處理子代理回調,而無需輪詢或打斷正在進行的模型或工具調用。
是什麼¶
dsh-subagent-response-promoter 是一個 Host-side Cordis 插件。它由 JachinShen 維護。其核心作用是在 DeepSeek Harness 的 Agent 步驟邊界,安全地提升子代理響應,並處理協調器中繼的遷移。
核心功能¶
- 提升子代理響應:在 Agent 步驟中,將子代理響應放在普通上下文之前,確保父級優先響應子代理。
- 協調器中繼遷移:內置
send_message工具提交協調器中繼。該插件將該中繼從next-turn移至子代理的next-step收件箱,同時保留原始喚醒信號。 - 不中斷調用:中繼的 relocation 不會取消活躍的模型請求或工具調用。它僅在 Agent 到達安全步驟邊界時可見。
安裝與啓用¶
在 DSH 配置文件中添加依賴項並捆綁插件。
{
"dependencies": {
"dsh-subagent-response-promoter": "github:JachinShen/dsh-subagent-response-promoter#v0.2.0"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"dsh-subagent-response-promoter"
]
}
}
}
添加上述配置後,重新安裝配置文件並重啓 DSH 進程。插件的 cordis.patch.yml 會自動插入 Host 插件。
典型用法¶
插件會對 Agent 步驟進行重排。
假設一個提議的 Agent 步驟包含:
ordinary A, child response A, ordinary B, child response B
插件處理後,模型接收到的內容變爲:
child response A, child response B, ordinary A, ordinary B
對於插入到 next-turn 的協調器中繼,插件會將其持久化並重新插入到 next-step 中。這種遷移不會取消活躍的請求或工具調用,而是等待 Agent 到達安全的步驟邊界後再生效。
適用場景與注意¶
此插件適合需要在複雜 Agent 流程中確保子代理響應優先級,且不希望打斷正在進行的模型推理或工具調用的場景。
注意:
* 這是一個 Host-side Cordis 插件。
* 插件內置了 send_message 工具來提交協調器中繼。
* 安裝前建議檢查源碼與許可證(MIT)。
結尾¶
該插件通過調整響應順序和中繼路由,解決了子代理在父級忙碌時的處理延遲問題。更多實現細節與源碼,請參考 GitHub 倉庫。