在 AI SDK 的 harness 层中使用兼容 ACP 的 harness
AI SDK 的 harness（编程代理运行框架）层现在支持任意符合智能体客户端协议（Agent Client Protocol，ACP）的 harness——通过新的 @ai-sdk/harness-acp 包，配合 HarnessAgent 即可接入。在此之前，每个 harness 适配器都只封装一个特定运行时，比如 Claude Code、Codex、Pi、Deep Agents、OpenCode。而 @ai-sdk/harness-acp 改为封装协议本身。它是一个元适配器（meta adapter）：不是去适配某一个 harness，而是让你能为任何提供了 ACP 兼容包的 harness 构建适配器。实现时，只需把该包传给 createACP，配置好基本的 harness 映射，再像其他 harness 一样传给 HarnessAgent 即可。换句话说，ACP 是对编程 harness 的一层抽象，但 AI SDK 的 harness 层刻意与它保持解耦。
并不是每个 harness 都支持 ACP；对某些 harness 来说，ACP 会限制或改变其内部行为的暴露方式，因此直接编写适配器往往能实现更紧密的集成。以 Claude Code 和 Codex 为例，应该优先使用 @ai-sdk/harness-claude-code 和 @ai-sdk/harness-codex 直接适配器，而不是走 ACP 实现。只有当某个 harness 没有直接适配器、但提供了 ACP 兼容包时，才考虑使用 @ai-sdk/harness-acp。
如需开始使用，请阅读 ACP harness 文档。阅读更多。