Agent Client Protocol

ACP 智能体可供 Pro、Max 和 Teams 用户使用。Enterprise admins 如需启用第三方智能体，应联系其账户团队。

Devin Desktop 支持在 Agent Command Center 中运行第三方智能体。为此，我们使用 Agent Client Protocol (ACP)。 ACP 是一种开放协议，用于标准化代码编辑器与代码智能体之间的通信，类似于 Language Server Protocol (LSP) 对语言服务器集成的标准化。任何实现了 ACP 的智能体都可以接入 Devin Desktop，而 Devin Desktop 也可以与任何兼容 ACP 的智能体通信。

使用外部 ACP 智能体时，所有智能体操作都会交给该智能体。Devin Desktop 的隐私政策和法律条款不适用，计费也由你与第三方智能体提供方直接结算。

示例 Agent

任何支持 ACP 的 Agent 都可以在 Devin Desktop 中运行。你可以接入的一些热门 ACP 兼容 Agent 包括：

Codex CLI — OpenAI 的代码 Agent
Claude Agent — Anthropic 的代码 Agent
OpenCode — 开源代码 Agent
Junie — JetBrains 的代码 Agent
Gemini CLI — Google 的代码 Agent

除了这类第三方 Agent 之外，你还可以使用 ACP 将自定义 Agent 集成到 Devin Desktop 中。

启用自定义智能体

将智能体添加到你的本地或团队注册表后，即可在 Devin Settings 中启用：

使用 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板
打开 Devin User Settings
点击“智能体”选项卡
打开你想使用的 ACP 智能体开关
重启 Devin Desktop

启用后，在开始新对话时，该智能体会出现在 Devin Desktop 右下角的智能体选择器中，与 Devin Local 等内置智能体一起显示。

当工作区以受限模式打开时，所有智能体 (包括 Devin Local 和 ACP 智能体) 均不可用，钩子也不会加载或运行。

浏览器预览

ACP 智能体可以打开你的 app 的浏览器预览：智能体会代理你的本地开发 server，预览会在智能体旁的内置浏览器窗格中打开，你捕获的元素和控制台输出则会作为待处理的 context 显示在该智能体的消息框中。

本地注册表配置

各个用户都可以通过编辑本地注册表文件来配置自己的 ACP Agent： macOS 和 Linux

Devin Desktop: ~/.windsurf/acp/registry.json
Devin Desktop Next: ~/.windsurf-next/acp/registry.json

Windows (所有 channel)

%USERPROFILE%\AppData\Roaming\Code\User\acp\registry.json

你也可以运行 Open Local ACP Registry Config，直接从命令面板打开该文件。该文件遵循 ACP 注册表规范。

Devin Local 的示例配置

如果你想在本机上试用 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": []
}

团队注册表配置

团队管理员可以通过 Devin Settings 中的“ACP Registry Config”设置，向团队下发自定义 ACP 配置。这样，你就可以维护一个静态的、已批准的 ACP Agent 注册表，供团队所有成员使用，而无需每位用户单独配置。

出于安全考虑，Devin Desktop 目前不会直接从注册表下载 Agent 分发包。Agent 二进制文件应已安装在用户的机器上——注册表配置会告诉 Devin Desktop 如何启动它。下方示例中的 distribution.binary.<platform>.archive URL 是 ACP 注册表 schema 的一部分，用于兼容更广泛的生态，但 Devin Desktop 目前不会拉取这些内容。

OpenCode 示例配置

{
  "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 的大部分设置会从各自的配置文件中读取，但身份验证通常需要单独处理。具体来说，你通常需要：

在 Agent 中通过 /login 斜杠命令进行身份验证。
在 Devin User Settings 的 Agents 选项卡中，使用“…”按钮配置环境变量。
在你的 settings.json 文件中，通过 devin.acp.agentEnv.<agentName> 设置环境变量。

Devin Desktop

Agent 指挥中心

发布

Windsurf 插件

账户

安全

Agent Client Protocol

示例 Agent

启用自定义智能体

浏览器预览

本地注册表配置

Devin Local 的示例配置

团队注册表配置

OpenCode 示例配置

故障排查

我现有的 Agent 设置无法正常工作

​示例 Agent

​启用自定义智能体

​浏览器预览

​本地注册表配置

​Devin Local 的示例配置

​团队注册表配置

​OpenCode 示例配置

​故障排查

​我现有的 Agent 设置无法正常工作

示例 Agent

启用自定义智能体

浏览器预览

本地注册表配置

Devin Local 的示例配置

团队注册表配置

OpenCode 示例配置

故障排查

我现有的 Agent 设置无法正常工作