> ## 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.

# Agent Client Protocol

> Execute agentes de terceiros no Agent Command Center do Devin Desktop via ACP.

<Note>
  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.
</Note>

O Devin Desktop oferece suporte à execução de agentes de terceiros no [Agent Command Center](/pt-BR/desktop/agent-command-center). Para isso, usamos o [Agent Client Protocol (ACP)](https://agentclientprotocol.com/).

O ACP é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de código — 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.

<Note>
  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.
</Note>

<div id="example-agents">
  ## Agentes de exemplo
</div>

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](https://github.com/openai/codex) — agente de código da OpenAI
* [Claude Agent](https://www.anthropic.com/claude-code) — agente de código da Anthropic
* [OpenCode](https://opencode.ai) — agente de código open source
* [Junie](https://www.jetbrains.com/junie/) — agente de código da JetBrains
* [Gemini CLI](https://github.com/google-gemini/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](/pt-BR/desktop/acp-custom) ao Devin Desktop.

<div id="enabling-custom-agents">
  ## Ativando agentes personalizados
</div>

Depois que um agente é adicionado ao seu registro [local](#local-registry-config) ou ao registro da [equipe](#team-registry-config), ele pode ser ativado em `Configurações do Devin`:

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 Devin`
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](/pt-BR/desktop/cascade/cascade) e [Devin Local](/pt-BR/desktop/devin-local).

<div id="local-registry-config">
  ## Configuração do registro local
</div>

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](https://agentclientprotocol.com/get-started/registry).

<div id="sample-config-for-devin-local">
  ### Configuração de exemplo para o Devin Local
</div>

Se você quiser testar o [Devin Local](/pt-BR/desktop/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`.

```json theme={null}
{
  "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": []
}
```

<div id="team-registry-configuration">
  ## Configuração do registro da equipe
</div>

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](https://windsurf.com/team/settings).

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.

<Note>
  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.
</Note>

<div id="sample-config-for-opencode">
  ### Exemplo de configuração do OpenCode
</div>

```json theme={null}
{
  "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": []
}
```

<div id="troubleshooting">
  ## Solução de problemas
</div>

<div id="my-existing-agent-setup-isnt-working">
  ### A configuração do meu agente existente não está funcionando
</div>

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`.