Documentation Index
Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
Use this file to discover all available pages before exploring further.
ACP Agent 可供 Pro、Max 和 Teams 用户使用。Enterprise admins 如需启用第三方 Agent,应联系其账户团队。
Devin Desktop 支持在 Agent Command Center 中运行第三方 Agent。为此,我们使用 Agent Client Protocol (ACP)。
ACP 是一种开放协议,用于标准化代码编辑器与编程 Agent 之间的通信,类似于 Language Server Protocol (LSP) 对语言服务器集成的标准化。任何实现了 ACP 的 Agent 都可以接入 Devin Desktop,而 Devin Desktop 也可以与任何兼容 ACP 的 Agent 通信。
使用外部 ACP Agent 时,所有 Agent 操作都会交给该 Agent。Devin Desktop 的隐私政策和法律条款不适用,计费也由你与第三方 Agent 提供方直接结算。
除了支持 Claude Code 和 Codex 等第三方 Agent 外,你还可以使用 ACP 将 自定义 Agent 集成到 Devin Desktop 中。
将 Agent 添加到你的本地或团队注册表后,即可在 Windsurf Settings 中启用:
- 使用
Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板
- 打开
Windsurf User Settings
- 点击“Agents”选项卡
- 打开你想使用的 ACP Agent 开关
- 重启 Devin Desktop
启用后,在开始新对话时,该 Agent 会出现在 Devin Desktop 右下角的 Agent 选择器中,与 Cascade 和 Devin Local 等内置 Agent 一起显示。
各个用户都可以通过编辑本地注册表文件来配置自己的 ACP Agent:
- Devin Desktop:
~/.windsurf/acp/registry.json
- Devin Desktop Next:
~/.windsurf-next/acp/registry.json
你也可以运行 Open Local ACP Registry Config,直接从命令面板打开该文件。
该文件遵循 ACP 注册表规范。
如果你想在本机上试用 Devin Local,但不想为整个团队启用它,可以配置一个指向 Devin CLI 的本地注册表。
这里假设 devin CLI 已经安装,并且已加入你的 PATH。Devin Desktop 会通过 devin acp 启动它。
{
"version": "1.0.0",
"agents": [
{
"id": "devin-cli",
"name": "Devin Local",
"version": "1.0.0",
"description": "Devin AI coding agent via Devin CLI",
"authors": [
"Cognition AI"
],
"license": "proprietary",
"distribution": {
"binary": {
"darwin-aarch64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"darwin-x86_64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"linux-aarch64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"linux-x86_64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"windows-aarch64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
},
"windows-x86_64": {
"archive": "",
"cmd": "devin",
"args": [
"acp"
]
}
}
}
}
],
"extensions": []
}
团队管理员可以通过 Windsurf Settings 中的“ACP Registry Config”设置,向团队下发自定义 ACP 配置。
这样,你就可以维护一个静态的、已批准的 ACP Agent 注册表,供团队所有成员使用,而无需每位用户单独配置。
出于安全考虑,Devin Desktop 目前不会直接从注册表下载 Agent 分发包。Agent 二进制文件应已安装在用户的机器上——注册表配置会告诉 Devin Desktop 如何启动它。下方示例中的 distribution.binary.<platform>.archive URL 是 ACP 注册表 schema 的一部分,用于兼容更广泛的生态,但 Devin Desktop 目前不会拉取这些内容。
{
"version": "1.0.0",
"agents": [
{
"id": "opencode",
"name": "OpenCode",
"version": "1.15.7",
"description": "The open source coding agent",
"repository": "https://github.com/anomalyco/opencode",
"website": "https://opencode.ai",
"authors": [
"Anomaly"
],
"license": "MIT",
"icon": "https://cdn.agentclientprotocol.com/registry/v1/latest/opencode.svg",
"distribution": {
"binary": {
"darwin-aarch64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-darwin-arm64.zip",
"cmd": "./opencode",
"args": [
"acp"
]
},
"darwin-x86_64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-darwin-x64.zip",
"cmd": "./opencode",
"args": [
"acp"
]
},
"linux-aarch64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-linux-arm64.tar.gz",
"cmd": "./opencode",
"args": [
"acp"
]
},
"linux-x86_64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-linux-x64.tar.gz",
"cmd": "./opencode",
"args": [
"acp"
]
},
"windows-aarch64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-windows-arm64.zip",
"cmd": "./opencode.exe",
"args": [
"acp"
]
},
"windows-x86_64": {
"archive": "https://github.com/anomalyco/opencode/releases/download/v1.15.7/opencode-windows-x64.zip",
"cmd": "./opencode.exe",
"args": [
"acp"
]
}
}
}
}
],
"extensions": []
}
第三方 Agent 的大部分设置会从各自的配置文件中读取,但身份验证通常需要单独处理。具体来说,你通常需要:
- 在 Agent 中通过
/login 斜杠命令进行身份验证。
- 在 Windsurf User Settings 的 Agents 选项卡中,使用“…”按钮配置环境变量。
- 在你的
settings.json 文件中,通过 windsurf.acp.agentEnv.<agentName> 设置环境变量。