Skip to main content
Agent Client Protocol (ACP) 标准化了编码智能体与代码编辑器或 IDE 之间的通信。 通过 ACP 协议，您可以将自定义 deep agents 与任何兼容 ACP 的客户端配合使用，让您的代码编辑器能够提供项目上下文并接收丰富的更新。
ACP 专为智能体与编辑器的集成而设计。如果您希望智能体调用外部服务器托管的工具，请参阅 Model Context Protocol (MCP)。

​
快速开始

安装 ACP 集成包： 
pip install deepagents-acp
然后通过 ACP 暴露一个 Deep Agent。 这将以 stdio 模式启动 ACP 服务器（从 stdin 读取请求，将响应写入 stdout）。实际使用中，通常由 ACP 客户端（例如您的编辑器）作为命令启动，然后通过 stdio 与服务器通信。 
import asyncio

from acp import run_agent
from deepagents import create_deep_agent
from langgraph.checkpoint.memory import MemorySaver

from deepagents_acp.server import AgentServerACP


async def main() -> None:
    agent = create_deep_agent(
        # 您可以在此处自定义您的 Deep Agent：设置自定义提示词、
        # 添加自己的工具、附加中间件或组合子智能体。
        system_prompt="You are a helpful coding assistant",
        checkpointer=MemorySaver(),
    )

    server = AgentServerACP(agent)
    await run_agent(server)


if __name__ == "__main__":
    asyncio.run(main())

示例编码智能体

deepagents-acp 包包含一个带有文件系统和 Shell 的示例编码智能体，可以直接运行。

​
客户端

Deep agents 可在任何能够运行 ACP 智能体服务器的地方使用。一些值得关注的 ACP 客户端包括：

​
Zed

deepagents 仓库包含一个演示 ACP 入口点，您可以将其注册到 Zed：
  1. 克隆 deepagents 仓库并安装依赖：
git clone https://github.com/langchain-ai/deepagents.git
cd deepagents/libs/acp
uv sync --all-groups
chmod +x run_demo_agent.sh
  1. 为演示智能体配置凭证：
cp .env.example .env
然后在 .env 中设置 ANTHROPIC_API_KEY。
  1. 在 Zed 的 settings.json 中配置您的 ACP 智能体服务器命令：
{
  "agent_servers": {
    "DeepAgents": {
      "type": "custom",
      "command": "/your/absolute/path/to/deepagents/libs/acp/run_demo_agent.sh"
    }
  }
}
  1. 打开 Zed 的 Agents 面板，开始一个 DeepAgents 会话。

​
Toad

如果您想将 ACP 智能体服务器作为本地开发工具运行，可以使用 Toad 来管理进程。 
uv tool install -U batrachian-toad

toad acp "python path/to/your_server.py" .
# 或
toad acp "uv run python path/to/your_server.py" .
有关协议详情和编辑器支持，请参阅上游 ACP 文档：
在 GitHub 上编辑此页面 或 提交问题。
将这些文档连接到 Claude、VSCode 等工具，通过 MCP 获取实时答案。