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

> Esegui agenti di terze parti in Agent Command Center di Devin Desktop tramite ACP.

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

Devin Desktop supporta l'esecuzione di agenti di terze parti all'interno di [Agent Command Center](/it/desktop/agent-command-center). A questo scopo, utilizziamo [Agent Client Protocol (ACP)](https://agentclientprotocol.com/).

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.

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

<div id="example-agents">
  ## Agenti di esempio
</div>

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](https://github.com/openai/codex) — l'agente di coding di OpenAI
* [Claude Agent](https://www.anthropic.com/claude-code) — l'agente di coding di Anthropic
* [OpenCode](https://opencode.ai) — agente di coding open source
* [Junie](https://www.jetbrains.com/junie/) — l'agente di coding di JetBrains
* [Gemini CLI](https://github.com/google-gemini/gemini-cli) — l'agente di coding di Google

Oltre a agenti di terze parti come questi, puoi usare ACP per integrare un [agente personalizzato](/it/desktop/acp-custom) con Devin Desktop.

<div id="enabling-custom-agents">
  ## Abilitazione degli agenti personalizzati
</div>

Una volta aggiunto un agente al registry [locale](#local-registry-config) o del [team](#team-registry-config), puoi abilitarlo da `Devin Settings`:

1. Apri la command palette con `Cmd+Shift+P` (macOS) o `Ctrl+Shift+P` (Windows/Linux)
2. Apri `Devin 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](/it/desktop/cascade/cascade) e [Devin Local](/it/desktop/devin-local).

<div id="local-registry-config">
  ## Configurazione del registry locale
</div>

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

<div id="sample-config-for-devin-local">
  ### Configurazione di esempio per Devin Local
</div>

Se vuoi provare [Devin Local](/it/desktop/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`.

```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">
  ## Configurazione del registry del team
</div>

Gli amministratori del team possono distribuire al proprio team una configurazione ACP personalizzata tramite l'impostazione "ACP Registry Config" in [Devin Settings](https://windsurf.com/team/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.

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

<div id="sample-config-for-opencode">
  ### Esempio di configurazione per 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">
  ## Risoluzione dei problemi
</div>

<div id="my-existing-agent-setup-isnt-working">
  ### La configurazione del mio agente esistente non funziona
</div>

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