Saltar al contenido principal

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.

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.
Además de admitir agentes de terceros como Claude Code y Codex, puede 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 Windsurf Settings:
  1. Abre la Command Palette con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
  2. Abre Windsurf User Settings
  3. Haz clic en la pestaña “Agents”
  4. Activa los agentes ACP que quieras usar
  5. 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.

​
Configuración del registro local

Cada usuario puede configurar sus propios agentes ACP editando un archivo de registro local:
  • Devin Desktop: ~/.windsurf/acp/registry.json
  • Devin Desktop Next: ~/.windsurf-next/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 Windsurf 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 de 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 Windsurf User Settings.
  • Establecer variables de entorno mediante la configuración windsurf.acp.agentEnv.<agentName> en tu archivo settings.json.