跳到主要内容

文档索引

在以下地址获取完整的文档索引:https://docs.langchain.org.cn/llms.txt

在进一步探索之前,请使用此文件发现所有可用页面。

代理客户端协议 (ACP) 标准化了编码代理与代码编辑器或 IDE 之间的通信。使用 ACP 协议,您可以将自定义的 deep agents 与任何兼容 ACP 的客户端结合使用,从而使您的代码编辑器能够提供项目上下文并接收丰富的更新。
ACP 专为代理-编辑器集成而设计。如果您希望您的代理调用由外部服务器托管的工具,请参阅 模型上下文协议 (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(
        model="google_genai:gemini-3.1-pro-preview",
        # 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())

示例编码代理

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" .
# or
toad acp "uv run python path/to/your_server.py" .
有关协议详细信息和编辑器支持,请参阅上游 ACP 文档

© . This site is unofficial and not affiliated with LangChain, Inc.