Riferimento dei codici di errore di Devin air-gapped

Questa documentazione riguarda le distribuzioni di Devin per il governo federale. Torna alla documentazione di Devin

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 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
`MDL`	Convalida del file dei modelli	File dei modelli
`IDP`	SSO e provider di identità	SSO
`NET`	Raggiungibilità degli endpoint, TLS, verifica HTTP	Rete e certificati
`CFG`	Percorsi locali, configurazione, ambiente	Rete e certificati, File dei modelli

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

devin models validate

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

​LIC Licenza

​File dei modelli MDL

​IDP SSO e provider di identità

​NET Rete

​Configurazione CFG

​Interpretare un errore

`LIC` Licenza

File dei modelli `MDL`

`IDP` SSO e provider di identità

`NET` Rete

Configurazione `CFG`

Interpretare un errore