Agent Client Protocol

Os agentes ACP estão disponíveis para usuários Pro, Max e Teams. Os admins do Enterprise devem entrar em contato com a equipe da conta para saber mais sobre como habilitar agentes de terceiros.

O Devin Desktop oferece suporte à execução de agentes de terceiros no Agent Command Center. Para isso, usamos o Agent Client Protocol (ACP). O ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de programação — de forma semelhante ao que o Language Server Protocol (LSP) fez pela integração com servidores de linguagem. Qualquer agente que implemente ACP pode ser conectado ao Devin Desktop, e o Devin Desktop pode se comunicar com qualquer agente compatível com ACP.

Ao usar um agente ACP externo, todas as operações ficam a cargo desse agente. A política de privacidade e os termos legais do Devin Desktop não se aplicam, e a cobrança é feita diretamente entre você e o provedor terceirizado do agente.

Agentes de exemplo

Qualquer agente compatível com ACP pode ser executado no Devin Desktop. Alguns agentes populares compatíveis com ACP que você pode conectar incluem:

Codex CLI — agente de código da OpenAI
Claude Agent — agente de código da Anthropic
OpenCode — agente de código open source
Junie — agente de código da JetBrains
Gemini CLI — agente de código do Google

Além de agentes de terceiros como esses, você pode usar o ACP para integrar um agente personalizado ao Devin Desktop.

Ativando agentes personalizados

Depois que um agente é adicionado ao seu registro local ou ao registro da equipe, ele pode ser ativado em Configurações do Devin:

Abra a Paleta de Comandos com Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
Abra Configurações de Usuário do Devin
Clique na aba “Agents”
Ative os agentes ACP que você quer usar
Reinicie o Devin Desktop

Depois de ativado, o agente aparece no seletor de agentes no canto inferior direito do Devin Desktop ao iniciar novas conversas, junto a agentes nativos como Devin Local.

Todos os agentes — Devin Local e agentes ACP — ficam indisponíveis enquanto um workspace está aberto no Modo Restrito, no qual os hooks também não são carregados nem executados.

Prévias no Browser

Os agentes ACP podem abrir uma prévia do seu app: o agente atua como proxy do seu servidor de desenvolvimento local, a prévia é aberta no painel nativo do Browser ao lado do agente, e os elementos e a saída do Console capturados são enviados para a caixa de mensagens desse agente como contexto pendente.

Configuração do registro local

Cada usuário pode configurar seus próprios agentes ACP editando um arquivo de registro local: macOS e Linux

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

Windows (todos os canais)

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

Você também pode abrir o arquivo diretamente pela Paleta de Comandos usando Open Local ACP Registry Config. O arquivo segue a especificação de registro do ACP.

Configuração de exemplo para o Devin Local

Se você quiser testar o Devin Local na sua máquina sem habilitá-lo para toda a equipe, pode configurar um registro local apontando para o Devin CLI. Isso pressupõe que a CLI devin já esteja instalada e disponível no seu PATH. O Devin Desktop a executa com 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": []
}

Configuração do registro da equipe

Os administradores da equipe podem distribuir uma configuração personalizada do ACP para a equipe por meio da opção “ACP Registry Config” em Configurações do Devin. Isso permite manter um registro estático de agentes ACP aprovados que todos os membros da equipe podem usar, sem que cada usuário precise configurá-los individualmente.

Por motivos de segurança, o Devin Desktop atualmente não baixa distribuições de agentes diretamente do registro. O binário do agente deve já estar instalado na máquina do usuário — a configuração do registro informa ao Devin Desktop como iniciá-lo. As URLs distribution.binary.<platform>.archive no exemplo abaixo fazem parte do esquema de registro do ACP para manter compatibilidade com o ecossistema mais amplo, mas o Devin Desktop não as baixa atualmente.

Exemplo de configuração do 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": []
}

Solução de problemas

A configuração do meu agente existente não está funcionando

Agentes de terceiros leem seus próprios arquivos de configuração para a maioria das opções, mas a autenticação geralmente é tratada separadamente. Especificamente, em geral você precisa:

Fazer login no agente com o comando /login.
Configurar variáveis de ambiente usando o botão ”…” na aba Agents das Configurações de Usuário do Devin.
Definir variáveis de ambiente por meio da configuração devin.acp.agentEnv.<agentName> no arquivo settings.json.

Devin Desktop

Central de Comando do Agente

Lançamentos

Plugins do Windsurf

Contas

Segurança

Agent Client Protocol

Agentes de exemplo

Ativando agentes personalizados

Prévias no Browser

Configuração do registro local

Configuração de exemplo para o Devin Local

Configuração do registro da equipe

Exemplo de configuração do OpenCode

Solução de problemas

A configuração do meu agente existente não está funcionando

​Agentes de exemplo

​Ativando agentes personalizados

​Prévias no Browser

​Configuração do registro local

​Configuração de exemplo para o Devin Local

​Configuração do registro da equipe

​Exemplo de configuração do OpenCode

​Solução de problemas

​A configuração do meu agente existente não está funcionando

Agentes de exemplo

Ativando agentes personalizados

Prévias no Browser

Configuração do registro local

Configuração de exemplo para o Devin Local

Configuração do registro da equipe

Exemplo de configuração do OpenCode

Solução de problemas

A configuração do meu agente existente não está funcionando