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

​
快速入门

安装ACP集成包： 
pip install deepagents-acp
然后通过ACP暴露一个深度代理。 这将在标准输入输出模式下启动一个ACP服务器（它从标准输入读取请求并将响应写入标准输出）。实践中，您通常会将此作为由ACP客户端（例如您的编辑器）启动的命令来运行，该客户端随后通过标准输入输出与服务器进行通信。 
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(
        model="google_genai:gemini-3.1-pro-preview",
        # 您可以在这里自定义您的深度代理：设置自定义提示、添加自己的工具、附加中间件或组合子代理。
        system_prompt="您是一个乐于助人的编程助手",
        checkpointer=MemorySaver(),
    )

    server = AgentServerACP(agent)
    await run_agent(server)


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

示例编码代理

deepagents-acp 包含一个可以立即运行的带有文件系统和 shell 的示例编码代理。

​
客户端

深度代理可以在任何可以运行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 的代理面板并启动一个 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 上 编辑此页面 或 报告问题。
通过 MCP 将这些文档连接到 Claude、VSCode 等，以实现实时答案。