Agent Client Protocol

Gli agenti ACP sono disponibili per gli utenti Pro, Max e Teams. Gli amministratori Enterprise devono contattare il proprio account team per abilitare gli agenti di terze parti.

Devin Desktop supporta l’esecuzione di agenti di terze parti all’interno di Agent Command Center. A questo scopo, utilizziamo Agent Client Protocol (ACP). ACP è un protocollo aperto che standardizza la comunicazione tra editor di codice e agenti di coding, in modo analogo a come il Language Server Protocol (LSP) ha standardizzato l’integrazione dei language server. Qualsiasi agente che implementa ACP può essere integrato in Devin Desktop e Devin Desktop può comunicare con qualsiasi agente compatibile con ACP.

Quando si utilizza un agente ACP esterno, tutte le operazioni vengono delegate all’agente. L’informativa sulla privacy e i termini legali di Devin Desktop non si applicano e la fatturazione avviene direttamente tra te e il fornitore dell’agente di terze parti.

Agenti di esempio

Qualsiasi agente che supporta ACP può essere eseguito in Devin Desktop. Tra gli agenti compatibili con ACP più diffusi che puoi collegare ci sono:

Codex CLI — l’agente di coding di OpenAI
Claude Agent — l’agente di coding di Anthropic
OpenCode — agente di coding open source
Junie — l’agente di coding di JetBrains
Gemini CLI — l’agente di coding di Google

Oltre a agenti di terze parti come questi, puoi usare ACP per integrare un agente personalizzato con Devin Desktop.

Abilitazione degli agenti personalizzati

Una volta aggiunto un agente al registry locale o del team, puoi abilitarlo da Devin Settings:

Apri la command palette con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
Apri Devin User Settings
Fai clic sulla scheda “Agents”
Attiva gli agenti ACP che vuoi usare
Riavvia Devin Desktop

Una volta abilitato, l’agente compare nel selettore degli agenti in basso a destra in Devin Desktop quando avvii nuove conversazioni, insieme agli agenti integrati come Cascade e Devin Local.

Tutti gli agenti — Cascade, Devin Local e gli agenti ACP — non sono disponibili quando un workspace è aperto in Modalità con restrizioni, in cui gli hook non vengono né caricati né eseguiti.

Anteprime del browser

Gli agenti ACP possono aprire un’anteprima del browser della tua app, seguendo lo stesso flusso di lavoro di Cascade: l’agente funge da proxy per il tuo server di sviluppo locale, l’anteprima si apre nel riquadro Browser integrato accanto all’agente e gli elementi e l’output della Console acquisiti vengono aggiunti alla casella dei messaggi dell’agente come contesto in attesa.

Configurazione del registry locale

I singoli utenti possono configurare i propri agenti ACP modificando un file registry locale:

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

Puoi anche aprire il file direttamente dalla command palette eseguendo Open Local ACP Registry Config. Il file segue la spec del registry ACP.

Configurazione di esempio per Devin Local

Se vuoi provare Devin Local sul tuo computer senza abilitarlo per tutto il team, puoi configurare un registry locale che punti a Devin CLI. Questo presuppone che la CLI devin sia già installata e disponibile nel PATH. Devin Desktop la esegue 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": []
}

Configurazione del registry del team

Gli amministratori del team possono distribuire al proprio team una configurazione ACP personalizzata tramite l’impostazione “ACP Registry Config” in Devin Settings. In questo modo puoi mantenere un registry statico di agenti ACP approvati che tutti i membri del team possono usare, senza che ogni utente debba configurarli singolarmente.

Per motivi di sicurezza, Devin Desktop al momento non scarica direttamente dal registry i pacchetti di distribuzione degli agenti. Il binario dell’agente deve essere già installato sul computer dell’utente: la configurazione del registry indica a Devin Desktop come avviarlo. Gli URL distribution.binary.<platform>.archive nell’esempio seguente fanno parte dello schema del registry ACP per garantire la compatibilità con l’ecosistema più ampio, ma al momento Devin Desktop non li scarica.

Esempio di configurazione per 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": []
}

Risoluzione dei problemi

La configurazione del mio agente esistente non funziona

Gli agenti di terze parti leggono i propri file di configurazione per la maggior parte delle impostazioni, ma l’autenticazione viene solitamente gestita a parte. In particolare, in genere è necessario:

Autenticarsi tramite il comando slash /login nell’agente.
Configurare le variabili d’ambiente usando il pulsante ”…” nella scheda Agents di Devin User Settings.
Impostare le variabili d’ambiente tramite l’impostazione devin.acp.agentEnv.<agentName> nel file settings.json.

Devin Desktop

Centro di comando degli agenti

Release

Plugin di Windsurf

Account

Sicurezza

Agent Client Protocol

Agenti di esempio

Abilitazione degli agenti personalizzati

Anteprime del browser

Configurazione del registry locale

Configurazione di esempio per Devin Local

Configurazione del registry del team

Esempio di configurazione per OpenCode

Risoluzione dei problemi

La configurazione del mio agente esistente non funziona

​Agenti di esempio

​Abilitazione degli agenti personalizzati

​Anteprime del browser

​Configurazione del registry locale

​Configurazione di esempio per Devin Local

​Configurazione del registry del team

​Esempio di configurazione per OpenCode

​Risoluzione dei problemi

​La configurazione del mio agente esistente non funziona

Agenti di esempio

Abilitazione degli agenti personalizzati

Anteprime del browser

Configurazione del registry locale

Configurazione di esempio per Devin Local

Configurazione del registry del team

Esempio di configurazione per OpenCode

Risoluzione dei problemi

La configurazione del mio agente esistente non funziona