Agent 客户端协议 (ACP) 标准化编码代理与代码编辑器或 IDE 之间的通信。 使用 ACP 协议，您可以通过任何 ACP 兼容的客户端使用您的自定义 deep agents，使您的代码编辑器能够提供项目上下文并接收丰富的更新。

快速入门

安装 ACP 集成包：

pip install deepagents-acp

uv add deepagents-acp

然后通过 ACP 暴露一个 deep agent。

这会启动一个 ACP 服务器，以 stdio 模式运行（它从 stdin 读取请求并向 stdout 写入响应）。实际上，您通常将此作为 ACP 客户端（例如您的编辑器）启动的命令来运行，然后通过 stdio 与服务器通信。

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.5-flash",
        # You can customize your deep agent here: set a custom prompt,
        # add your own tools, attach middleware, or compose subagents.
        system_prompt="You are a helpful coding assistant",
        checkpointer=MemorySaver(),
    )

    server = AgentServerACP(agent)
    await run_agent(server)


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

客户端

Deep agents 可以在任何可以运行 ACP 代理服务器的地方使用。一些值得注意的 ACP 客户端包括：

• - Zed
• - JetBrains IDE
• - Visual Studio Code（通过 vscode-acp)
• - Neovim（通过 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

然后设置 ANTHROPIC_API_KEY in .env.

1. 在 Zed 的 settings.json:

{
  "agent_servers": {
    "DeepAgents": {
      "type": "custom",
      "command": "/your/absolute/path/to/deepagents/libs/acp/run_demo_agent.sh"
    }
  }
}

1. 中配置您的 ACP 代理服务器命令。打开 Zed 的 Agents 面板并启动 Deep Agents 线程。

Toad

如果您想将 ACP 代理服务器作为本地开发工具运行，可以使用 Toad 来管理进程。

uv tool install -U batrachian-toad

toad acp "python path/to/your_server.py" .
# or
toad acp "uv run python path/to/your_server.py" .