Pular para o conteúdo 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.

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.
Além de oferecer suporte a agentes de terceiros, como Claude Code e Codex, 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 Windsurf:
  1. Abra a Paleta de Comandos com Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
  2. Abra Configurações de Usuário do Windsurf
  3. Clique na aba “Agents”
  4. Ative os agentes ACP que você quer usar
  5. 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 Cascade e Devin Local.

​
Configuração do registro local

Cada usuário pode configurar seus próprios agentes ACP editando um arquivo de registro local:
  • Devin Desktop: ~/.windsurf/acp/registry.json
  • Devin Desktop Next: ~/.windsurf-next/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 Windsurf. 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 Windsurf.
  • Definir variáveis de ambiente por meio da configuração windsurf.acp.agentEnv.<agentName> no arquivo settings.json.