Best For
需要強執行隔離能力的程式碼 Agent 開發團隊。如果你的 Agent 會執行不受信任的程式碼、安裝套件或跑測試,ephemeral workspace 模型省去自己搭 Docker 沙盒的功夫。同時適合正在用 SWEBench 評比各 Agent 框架的技術選型者。
How I Actually Use It
我評估這款 SDK 的出發點是:能否作為現有 Agent 系統的隔離執行後端。核心概念是讓 Agent 不直接在本機執行程式碼,而是透過 REST API 呼叫 OpenHands 的 Agent Server,由伺服器啟動一次性 Docker 容器來執行任務,完成後立即銷毀。
實際結論:我沒有採用。目前的 Claude Agent SDK 已能處理程式碼執行需求,在既有的 TypeScript 技術棧旁邊再引入一套 Python 服務,會增加維運負擔,卻沒有解決具體的痛點。
值得借鏡的設計:AgentContext(load_public_skills=True) 自動載入套件管理 skills(uv、deno)的模式相當乾淨,概念上可以參考。
Where It Is Strong
- SWEBench 77.6 分:開源 coding agent 框架中的頂尖成績,有發表的技術報告(arXiv 2511.03690)為依據
- 一次性工作區隔離:每個任務啟動獨立的 Docker/K8s 容器,結束即銷毀,確保沒有狀態外洩
- REST API + WebSocket:Agent Server 作為獨立服務運行,理論上與程式語言無關
- Skills marketplace:透過
AgentContext自動載入常用工具的公共 skills - 企業採用實績:TikTok、Apple、NVIDIA 等公司實際使用,代表一定的生產環境穩定性
Where It Fails
- Python 優先生態:如果你的技術棧是 TypeScript 或其他語言,必須透過 REST API 互動,多了一層網路傳輸與序列化成本
- 依賴 Docker/K8s:一次性工作區是最大賣點,但需要容器基礎設施才能發揮;沒有 Docker 就失去隔離優勢
- 版本號不明確:目前文件中 SDK 版本資訊模糊,難以釘選相依版本或追蹤重大變更
- 與既有框架重疊:如果你已經在用 Claude Agent SDK 或類似工具,增量價值有限,除非你明確需要沙盒模型
Pricing, Difficulty, and Risk
價格:完全開源,Apache-2.0 授權,無使用費用。
上手難度:進階。需要熟悉 Python、Docker 以及 Agent 框架的基本概念。Agent Server 的 REST API 若要對外開放,認證設定並不簡單。
風險:容器隔離的強度取決於底層 runtime 的安全性,容器逃逸是已知風險類別。REST API 若暴露到 localhost 以外,必須加上認證機制。供應鏈風險與所有 PyPI 套件相同。
Verdict
觀望,暫不採用。一次性工作區的設計和 SWEBench 成績確實出色。如果你需要沙盒化的 coding agent 且還沒有現成方案,這是很強的候選。如果你已有運作良好的 Agent 框架,目前沒有急迫的切換理由。
Source
- GitHub: https://github.com/OpenHands/software-agent-sdk
- Documentation: https://docs.openhands.dev/sdk
- Technical Report: https://arxiv.org/abs/2511.03690