Protocolo Cliente-Agente

Los agentes ACP están disponibles para usuarios de Pro, Max y Teams. Los administradores de Enterprise deben ponerse en contacto con su equipo de cuenta para habilitar agentes de terceros.

Devin Desktop permite ejecutar agentes de terceros dentro del Agent Command Center. Para ello, usamos el Protocolo Cliente-Agente (ACP). ACP es un protocolo abierto que estandariza la comunicación entre editores de código y agentes de programación, de forma similar a como el Language Server Protocol (LSP) estandarizó la integración de servidores de lenguaje. Cualquier agente que implemente ACP puede conectarse a Devin Desktop, y Devin Desktop puede comunicarse con cualquier agente compatible con ACP.

Al usar un agente ACP externo, todas las operaciones se delegan a ese agente. La política de privacidad y los términos legales de Devin Desktop no se aplican, y la facturación se gestiona directamente entre usted y el proveedor externo del agente.

Agentes de ejemplo

Cualquier agente compatible con ACP puede ejecutarse en Devin Desktop. Algunos agentes populares compatibles con ACP que puedes conectar son:

Codex CLI — el agente de programación de OpenAI
Claude Agent — el agente de programación de Anthropic
OpenCode — agente de programación de código abierto
Junie — el agente de programación de JetBrains
Gemini CLI — el agente de programación de Google

Además de agentes de terceros como estos, puedes usar ACP para integrar un agente personalizado con Devin Desktop.

Habilitar agentes personalizados

Una vez que se agrega un agente a tu registro local o de equipo, puedes habilitarlo desde Devin Settings:

Abre la Command Palette con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
Abre Devin User Settings
Haz clic en la pestaña “Agents”
Activa los agentes ACP que quieras usar
Reinicia Devin Desktop

Una vez habilitado, el agente aparece en el selector de agentes de la esquina inferior derecha de Devin Desktop al iniciar conversaciones nuevas, junto con agentes integrados como Cascade y Devin Local.

Ningún agente —ni Cascade, ni Devin Local ni los agentes ACP— está disponible mientras haya un espacio de trabajo abierto en Modo restringido, donde los hooks tampoco se cargan ni se ejecutan.

Vistas previas en el navegador

Los agentes ACP pueden abrir una vista previa en el navegador de tu app, siguiendo el mismo flujo de trabajo que Cascade: el agente actúa como proxy de tu servidor de desarrollo local, la vista previa se abre en el panel de navegador integrado junto al agente, y los elementos y la salida de la consola que captures aparecen en el cuadro de mensajes de ese agente como contexto pendiente.

Configuración del registro local

Cada usuario puede configurar sus propios agentes ACP editando un archivo de registro local: macOS y Linux

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

Windows (todos los channels)

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

También puedes abrir el archivo directamente desde la Command Palette con Open Local ACP Registry Config. El archivo sigue la especificación del registro ACP.

Configuración de ejemplo para Devin Local

Si quieres probar Devin Local en tu máquina sin habilitarlo para todo tu equipo, puedes configurar un registro local que apunte al Devin CLI. Esto supone que la CLI devin ya está instalada y disponible en tu PATH. Devin Desktop la inicia con 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": []
}

Configuración del registro del equipo

Los administradores del equipo pueden implementar una configuración de ACP personalizada para su equipo mediante la opción “ACP Registry Config” en Devin Settings. Esto permite mantener un registro estático de agentes ACP aprobados que todos los miembros de tu equipo pueden usar, sin que cada usuario tenga que configurarlos individualmente.

Por motivos de seguridad, Devin Desktop no descarga actualmente distribuciones de agentes directamente desde el registro. Se espera que el binario del agente ya esté instalado en la máquina del usuario; la configuración del registro indica a Devin Desktop cómo iniciarlo. Las URL distribution.binary.<platform>.archive del ejemplo siguiente forman parte del esquema del registro ACP para mantener la compatibilidad con el ecosistema más amplio, pero Devin Desktop no las descarga actualmente.

Configuración de ejemplo para 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": []
}

Solución de problemas

La configuración actual de mi agente no funciona

Los agentes de terceros leen sus propios archivos de configuración para la mayoría de las opciones, pero la autenticación normalmente se gestiona por separado. En concreto, normalmente debes:

Autenticarte con el comando de barra diagonal /login en el agente.
Configurar variables de entorno con el botón ”…” en la pestaña Agents de Devin User Settings.
Establecer variables de entorno mediante la configuración devin.acp.agentEnv.<agentName> en tu archivo settings.json.

Devin Desktop

Centro de control de agentes

Versiones

Complementos de Windsurf

Cuentas

Seguridad

Protocolo Cliente-Agente

Agentes de ejemplo

Habilitar agentes personalizados

Vistas previas en el navegador

Configuración del registro local

Configuración de ejemplo para Devin Local

Configuración del registro del equipo

Configuración de ejemplo para OpenCode

Solución de problemas

La configuración actual de mi agente no funciona

​Agentes de ejemplo

​Habilitar agentes personalizados

​Vistas previas en el navegador

​Configuración del registro local

​Configuración de ejemplo para Devin Local

​Configuración del registro del equipo

​Configuración de ejemplo para OpenCode

​Solución de problemas

​La configuración actual de mi agente no funciona

Agentes de ejemplo

Habilitar agentes personalizados

Vistas previas en el navegador

Configuración del registro local

Configuración de ejemplo para Devin Local

Configuración del registro del equipo

Configuración de ejemplo para OpenCode

Solución de problemas

La configuración actual de mi agente no funciona