Vai al contenuto principale

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.

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.
Oltre a supportare agenti di terze parti come Claude Code e Codex, 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 Windsurf Settings:
  1. Apri la command palette con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
  2. Apri Windsurf User Settings
  3. Fai clic sulla scheda “Agents”
  4. Attiva gli agenti ACP che vuoi usare
  5. 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.

​
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 Windsurf 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 Windsurf User Settings.
  • Impostare le variabili d’ambiente tramite l’impostazione windsurf.acp.agentEnv.<agentName> nel file settings.json.