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

# Riferimento dei codici di errore di Devin air-gapped

> Catalogo completo dei codici di errore LIC, MDL, IDP, NET e CFG restituiti da Devin CLI e Desktop in modalità air-gapped, con il significato di ciascuno e l'intervento richiesto all'amministratore.

> [!NOTE]
>
> Questa documentazione riguarda le distribuzioni di Devin per il governo federale. [Torna alla documentazione di Devin](/it/get-started/devin-intro)

Ogni errore che la CLI e Desktop air-gapped sono in grado di diagnosticare viene segnalato con un codice stabile nel formato `XXXnnn`. I codici compaiono all'inizio del messaggio di errore nel terminale, nell'output di `devin airgap doctor`, nei dati diagnostici di Desktop e nel campo `error_code` degli [eventi di audit](/it/federal/air-gapped/on-disk-formats#auth) `auth`. Il numero identifica la condizione, non il testo del messaggio, quindi puoi usarlo come riferimento per i runbook di supporto e gli avvisi SIEM.

| Namespace | Ambito | Pagina di dettaglio |
| - | - | - |
| `LIC` | Convalida del file di licenza | [Licenza](/it/federal/air-gapped/license) |
| `MDL` | Convalida del file dei modelli | [File dei modelli](/it/federal/air-gapped/models-file) |
| `IDP` | SSO e provider di identità | [SSO](/it/federal/air-gapped/sso) |
| `NET` | Raggiungibilità degli endpoint, TLS, verifica HTTP | [Rete e certificati](/it/federal/air-gapped/network-and-certificates) |
| `CFG` | Percorsi locali, configurazione, ambiente | [Rete e certificati](/it/federal/air-gapped/network-and-certificates), [File dei modelli](/it/federal/air-gapped/models-file) |

## `LIC` Licenza

Visualizzato come `LIC00n: <message>`, seguito dal percorso verificato e dalle istruzioni per sovrascriverlo (`DEVIN_LICENSE_FILE`).

| Codice | Significato | Cosa fare |
| - | - | - |
| `LIC001` | File di licenza mancante o illeggibile in `/etc/devin/license.devin-onprem-license` (`C:\ProgramData\Devin\license.devin-onprem-license` su Windows) o nel percorso indicato da `DEVIN_LICENSE_FILE`. Su Windows, viene restituito anche quando un utente standard tenta di sostituire da Desktop una licenza di proprietà di un amministratore. | Installa il file nel percorso predefinito oppure imposta `DEVIN_LICENSE_FILE`; verifica che l'utente che esegue Devin abbia l'autorizzazione di lettura. |
| `LIC002` | File non valido: non è un JWT EdDSA valido oppure l'intestazione non contiene `kid`. | Scarica di nuovo la licenza dal portale e trasferiscila byte per byte (senza aggiungere caratteri di nuova riga, senza andare a capo e senza modificare la codifica). |
| `LIC003` | Verifica della firma non riuscita. | Il payload è stato modificato dopo la firma. Scarica di nuovo la licenza. |
| `LIC004` | `kid` sconosciuto: in questa build non è incorporata alcuna chiave pubblica corrispondente. | Esegui la [verifica del `kid`](/it/federal/air-gapped/license#check-the-key-id). La licenza è stata emessa da un ambiente diverso oppure la tua build è precedente a una rotazione delle chiavi; installa il rilascio attuale. |
| `LIC005` | Scaduta da oltre 24 ore (periodo di tolleranza superato). | Rinnova la licenza tramite il portale. |
| `LIC006` | Non ancora valida: data di emissione successiva di oltre 24 ore a quella attuale. | Verifica l'orologio dell'host; se è corretto, contatta il tuo team di supporto. |
| `LIC007` | Claim `product` errato (diverso da `devin-onprem`). | Il file non è una licenza di Devin air-gapped. Scaricalo di nuovo dal portale. |

## File dei modelli `MDL`

Segnalati da `devin models validate`, `devin airgap doctor`, dalle impostazioni dei modelli di Desktop e all'avvio dell'agente. Ogni diagnostica indica la voce di modello a cui si riferisce.

| Codice | Significato | Cosa fare |
| - | - | - |
| `MDL001` | Il file non è un JSON valido per lo schema v0 (anche a causa di campi sconosciuti). | Correggi il JSON; rimuovi i campi non presenti nello [schema](/it/federal/air-gapped/models-file#schema-reference-version-0). |
| `MDL002` | `schema_version` non supportato. | Imposta `"schema_version": 0`. |
| `MDL003` | `models` è vuoto. | Aggiungi almeno una voce di modello. |
| `MDL004` | Un modello ha un `name` vuoto. | Assegna a ogni voce un `name` univoco. |
| `MDL005` | `name` del modello duplicato. | Rinomina una delle voci. |
| `MDL006` | `base_url` vuoto. | Imposta l'URL dell'endpoint. |
| `MDL007` | `api_key.env` vuoto. | Indica la variabile d'ambiente che contiene la chiave. |
| `MDL008` | `max_context_tokens` è zero. | Imposta la finestra di contesto del modello. |
| `MDL009` | Più di un modello è contrassegnato come `default`. | Lascia `default: true` su una sola voce. |
| `MDL010` | `base_url` non è un URL `https://` con un host (`http://` è accettato solo per gli indirizzi di loopback). | Usa `https://` oppure un indirizzo di loopback per un server sullo stesso host. |
| `MDL011` | `max_output_tokens` supera `max_context_tokens`. | Riduci `max_output_tokens`. |
| `MDL012` | Il file esiste ma non è stato possibile leggerlo (autorizzazioni insufficienti o UTF-8 non valido). | Concedi l'autorizzazione di lettura all'utente che esegue Devin; salva il file in UTF-8. |
| `MDL013` | `max_output_tokens` è zero. | Rimuovi il campo o imposta un valore positivo. |
| `MDL014` | Il file appartiene a un altro utente, quindi Desktop si rifiuta di sostituirlo. | Modifica il file su disco come suo proprietario, oppure fai puntare `DEVIN_MODELS_FILE` a un file di tua proprietà. |

## `IDP` SSO e provider di identità

Segnalati da `devin auth login`, `devin auth status`, all'avvio dell'agente e dal flusso di accesso dell'app Desktop. `IDP004` e `IDP005` vengono inoltre scritti nel registro di audit con gli eventi `sso_login_denied`, mentre qualsiasi codice `IDP` può comparire con `sso_revalidation_failed`.

| Codice | Significato | Cosa fare |
| - | - | - |
| `IDP001` | Il file di autenticazione è illeggibile o non valido. | Correggi `/etc/devin/auth.json` (`C:\ProgramData\Devin\auth.json` su Windows) oppure il file nel percorso `DEVIN_AUTH_FILE`; il messaggio indica il campo che causa l'errore. |
| `IDP002` | Nessun accesso memorizzato nella cache per l'emittente configurato. | Esegui `devin auth login`. |
| `IDP003` | L'accesso non è valido o è scaduto e non è stato possibile rinnovarlo in modo automatico (anche in caso di risposta `invalid_grant` dall'IdP). | Esegui di nuovo `devin auth login`. |
| `IDP004` | Accesso effettuato, ma l'utente non è membro di `required_group`. | Aggiungi l'utente al gruppo nell'IdP oppure correggi `required_group` / `groups_claim` nel file di autenticazione. |
| `IDP005` | L'IdP non è raggiungibile, ha restituito un errore oppure ha restituito un ID token che non ha superato la convalida. | Verifica la raggiungibilità di rete, l'attendibilità TLS (`DEVIN_CA_BUNDLE`), il valore di `issuer` e i log dell'IdP. |
| `IDP006` | La cache locale dei token SSO è illeggibile, danneggiata o non riservata all'utente attuale. | Esegui `devin auth login`; un nuovo accesso riscrive la cache con autorizzazioni riservate al solo proprietario. |

## `NET` Rete

Segnalati dalle probe sugli endpoint eseguite da `devin airgap doctor` e dalle richieste di inferenza e all'IdP. Ogni errore `NET` include la catena di errori sottostante.

| Codice | Significato | Cosa fare |
| - | - | - |
| `NET001` | Risoluzione DNS dell'host dell'endpoint non riuscita. | Verifica l'hostname nel file dei modelli o nel file di autenticazione e la configurazione DNS della workstation. |
| `NET002` | Impossibile stabilire la connessione TCP (rifiutata, reimpostata o non instradabile). | Verifica che l'endpoint sia in ascolto sulla porta e che i firewall o le regole del proxy consentano alla workstation di raggiungerlo. |
| `NET003` | Handshake TLS non riuscito: certificato non attendibile, scaduto o non corrispondente. Quando possibile, `devin airgap doctor` mostra il certificato presentato dal server (soggetto, emittente, scadenza) e indica se `DEVIN_CA_BUNDLE` era attivo. | Rendi attendibile la CA privata con [`DEVIN_CA_BUNDLE`](/it/federal/air-gapped/network-and-certificates#trust-a-private-ca-with-devin_ca_bundle) oppure correggi il certificato del server (nome, catena, scadenza). |
| `NET004` | L'endpoint ha restituito uno stato HTTP di errore diverso da 401/403. Un `404` su `GET {base_url}/models` viene segnalato come avviso, poiché alcuni server compatibili con OpenAI non implementano `/models`. | Controlla i log dell'endpoint e il percorso `base_url` (ad esempio, un `/v1` mancante). |
| `NET005` | Timeout della richiesta (10 s per le probe di doctor, 30 s per le richieste all'IdP, 30 s di connessione / 300 s di lettura per l'inferenza). | Verifica il carico sull'endpoint e su eventuali proxy intermedi; vedi [timeout](/it/federal/air-gapped/network-and-certificates#timeouts). |
| `NET006` | L'endpoint ha rifiutato le credenziali configurate (HTTP 401/403). | Verifica il valore nella variabile `api_key.env` e che la chiave sia valida per l'endpoint. |

## Configurazione `CFG`

Segnalati da `devin airgap doctor` e all'avvio.

| Codice | Significato | Cosa fare |
| - | - | - |
| `CFG001` | Una directory di configurazione o di stato obbligatoria è mancante o non scrivibile (`~/.config/devin`, `~/.local/share/devin` o la directory del prodotto `cli-federal`; su Windows, `%APPDATA%\devin` o la relativa sottodirectory `cli-federal`). | Crea la directory o correggine proprietario e autorizzazioni per l'utente che esegue Devin. |
| `CFG002` | Una variabile d'ambiente a cui fa riferimento la configurazione (l'`api_key.env` di un modello) non è impostata nell'ambiente dell'agente. | Esporta la variabile oppure impostala tramite l'impostazione `devin.acp.agentEnv` di Desktop; vedi [Variabili d'ambiente della chiave API](/it/federal/air-gapped/models-file#api-key-environment-variables). |
| `CFG003` | Il file dei modelli non è stato trovato in `/etc/devin/models.json` (`C:\ProgramData\Devin\models.json` su Windows) né nel percorso indicato dall'override `DEVIN_MODELS_FILE`. | Installa il file dei modelli; vedi [File dei modelli](/it/federal/air-gapped/models-file). |
| `CFG004` | Il file `DEVIN_CA_BUNDLE` è mancante, illeggibile o non contiene certificati PEM validi. | Correggi il percorso o il contenuto del file; vedi [Rete e certificati](/it/federal/air-gapped/network-and-certificates). |
| `CFG005` | Non è stato possibile analizzare la definizione di un sottoagente personalizzato (`agents/**/AGENT.md` o un singolo file `agents/<name>.md`), nella maggior parte dei casi per un frontmatter YAML non valido; il profilo viene ignorato. Viene segnalato anche come avviso quando una definizione dichiara chiavi di frontmatter che Devin non legge (ad esempio `allowed_tools` anziché `allowed-tools`); in questo caso il profilo viene comunque caricato. | Correggi il file indicato e l'errore di analisi riportato da `devin doctor`. |
| `CFG006` | È impostata una variabile d'ambiente `OTEL_EXPORTER_OTLP_*` che l'esportazione OTLP ignora (qualsiasi campo diverso da `ENDPOINT`, `HEADERS`, `TIMEOUT`, `PROTOCOL`; qualsiasi variabile `TRACES_`; oppure un `PROTOCOL` non supportato). Si tratta di un avviso; viene mostrato il nome della variabile, mai il suo valore. | Rimuovi o correggi la variabile. |

`CFG005` e `CFG006` provengono dai controlli standard di `devin doctor` e non sono specifici della build air-gapped.

## Interpretare un errore

Ecco un tipico errore di convalida:

```sh theme={null}
devin models validate
```

```text theme={null}
/etc/devin/models.json: 1 problem(s) found
  MDL010 [model 'qwen3-vl-32b']: model 'qwen3-vl-32b': `base_url` must be an https:// URL (plain http:// is only allowed for loopback addresses: localhost, 127.0.0.0/8, or [::1])
```

Individua il codice nelle tabelle precedenti, applica l'azione indicata, quindi esegui di nuovo `devin airgap doctor` finché tutte le verifiche non vengono superate. Se un codice non è elencato qui, la tua build è più recente di questa pagina: esegui `devin --version` e includi il messaggio completo nella richiesta di supporto, come descritto in [Risoluzione dei problemi](/it/federal/air-gapped/troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.