Referência de códigos de erro do Devin air-gapped

Esta documentação é destinada às implantações federais do Devin. Voltar para a Documentação do Devin

Toda falha que o CLI e o Desktop air-gapped conseguem diagnosticar é informada com um código estável no formato XXXnnn. Os códigos aparecem no início da mensagem de erro no terminal, na saída de devin airgap doctor, nos diagnósticos do Desktop e no campo error_code dos eventos de auditoria de auth. O número identifica a condição, e não o texto da mensagem, então você pode usá-lo como referência em runbooks de suporte e alertas de SIEM.

Namespace	Abrange	Página detalhada
`LIC`	Validação do arquivo de licença	Licença
`MDL`	Validação do arquivo de modelos	Arquivo de modelos
`IDP`	SSO e provedor de identidade	SSO
`NET`	Acessibilidade de endpoints, TLS, verificação HTTP	Rede e certificados
`CFG`	Caminhos locais, configuração, ambiente	Rede e certificados, Arquivo de modelos

`LIC` Licença

Exibido como LIC00n: <message>, seguido do caminho verificado e de como substituí-lo (DEVIN_LICENSE_FILE).

Código	Significado	O que fazer
`LIC001`	Arquivo de licença ausente ou ilegível em `/etc/devin/license.devin-onprem-license` (`C:\ProgramData\Devin\license.devin-onprem-license` no Windows) ou no caminho definido em `DEVIN_LICENSE_FILE`. No Windows, também é retornado quando um usuário padrão tenta substituir, pelo Desktop, uma licença pertencente a um administrador.	Instale o arquivo no caminho padrão ou defina `DEVIN_LICENSE_FILE`; verifique se o usuário que executa o Devin tem permissão de leitura.
`LIC002`	Arquivo malformado: não é um JWT EdDSA válido ou não há `kid` no cabeçalho.	Baixe a licença novamente no portal e transfira-a byte a byte (sem adicionar quebras de linha, quebra automática de texto nem alterar a codificação).
`LIC003`	Falha na verificação da assinatura.	O payload foi alterado após a assinatura. Baixe a licença novamente.
`LIC004`	`kid` desconhecido: nenhuma chave pública correspondente está incorporada neste build.	Execute a verificação do `kid`. A licença foi emitida por outro ambiente ou seu build é anterior a uma rotação de chave; instale a versão atual.
`LIC005`	Licença expirada há mais de 24 horas (fim do período de tolerância).	Renove a licença pelo portal.
`LIC006`	Ainda não válida: emitida com data mais de 24 horas no futuro.	Verifique o relógio do host; se estiver correto, entre em contato com sua equipe de suporte.
`LIC007`	Claim `product` incorreta (diferente de `devin-onprem`).	O arquivo não é uma licença do Devin air-gapped. Baixe-o novamente no portal.

Arquivo de modelos `MDL`

Reportados por devin models validate, devin airgap doctor, pelas configurações de modelos do Desktop e na inicialização do agente. Cada diagnóstico indica a entrada de modelo à qual se refere.

Código	Significado	O que fazer
`MDL001`	O arquivo não é um JSON válido para o schema v0, o que inclui campos desconhecidos.	Corrija o JSON; remova os campos que não constam no schema.
`MDL002`	`schema_version` não suportado.	Defina `"schema_version": 0`.
`MDL003`	`models` está vazio.	Adicione pelo menos uma entrada de modelo.
`MDL004`	Um modelo tem `name` vazio.	Atribua um `name` único a cada entrada.
`MDL005`	`name` de modelo duplicado.	Renomeie uma das entradas.
`MDL006`	`base_url` vazio.	Defina a URL do endpoint.
`MDL007`	`api_key.env` vazio.	Informe o nome da variável de ambiente que contém a chave.
`MDL008`	`max_context_tokens` é zero.	Defina a janela de contexto do modelo.
`MDL009`	Mais de um modelo marcado como `default`.	Mantenha `default: true` em apenas uma entrada.
`MDL010`	`base_url` não é uma URL `https://` com host (`http://` só é aceito para endereços de loopback).	Use `https://` ou um endereço de loopback para um servidor no mesmo host.
`MDL011`	`max_output_tokens` excede `max_context_tokens`.	Reduza `max_output_tokens`.
`MDL012`	O arquivo existe, mas não pôde ser lido (permissões ou UTF-8 inválido).	Corrija a permissão de leitura do usuário que executa o Devin; salve o arquivo em UTF-8.
`MDL013`	`max_output_tokens` é zero.	Remova o campo ou defina um valor positivo.
`MDL014`	O arquivo pertence a outro usuário, por isso o Desktop se recusa a substituí-lo.	Edite o arquivo no disco como proprietário dele ou aponte `DEVIN_MODELS_FILE` para um arquivo seu.

`IDP` SSO e provedor de identidade

Reportados por devin auth login, devin auth status, na inicialização do agente e pelo fluxo de login do Desktop. IDP004 e IDP005 também são gravados no registro de auditoria em eventos sso_login_denied, e qualquer código IDP pode aparecer em sso_revalidation_failed.

Código	Significado	O que fazer
`IDP001`	O arquivo de autenticação está ilegível ou é inválido.	Corrija `/etc/devin/auth.json` (`C:\ProgramData\Devin\auth.json` no Windows) ou o arquivo no caminho definido em `DEVIN_AUTH_FILE`; a mensagem indica o campo com problema.
`IDP002`	Não há login em cache para o emissor configurado.	Execute `devin auth login`.
`IDP003`	O login é inválido ou expirou e não pôde ser renovado em segundo plano (inclusive quando o IdP retorna `invalid_grant`).	Execute `devin auth login` novamente.
`IDP004`	O login foi feito, mas o usuário não é membro de `required_group`.	Adicione o usuário ao grupo no IdP ou corrija `required_group` / `groups_claim` no arquivo de autenticação.
`IDP005`	Não foi possível acessar o IdP, ou ele retornou um erro ou um ID token que não passou na validação.	Verifique a conectividade de rede, a confiança TLS (`DEVIN_CA_BUNDLE`), o valor de `issuer` e os logs do próprio IdP.
`IDP006`	O cache local de tokens SSO está ilegível, corrompido ou não é privado do usuário atual.	Execute `devin auth login`; um novo login regrava o cache com permissões restritas ao proprietário.

`NET` Rede

Reportados pelas sondagens de endpoint do devin airgap doctor e por requisições de inferência e ao IdP. Cada falha NET inclui a cadeia de erros subjacente.

Código	Significado	O que fazer
`NET001`	Falha na resolução DNS do host do endpoint.	Verifique o nome do host no arquivo de modelos ou no arquivo de autenticação, além do DNS da estação de trabalho.
`NET002`	Não foi possível estabelecer a conexão TCP (recusada, redefinida ou sem rota).	Verifique se o endpoint está escutando na porta e se as regras de firewall ou de proxy permitem que a estação de trabalho o acesse.
`NET003`	Falha no handshake TLS: certificado não confiável, expirado ou incompatível. O `devin airgap doctor` exibe o certificado apresentado pelo servidor (subject, emissor, validade), quando possível, e informa se o `DEVIN_CA_BUNDLE` estava em vigor.	Configure a confiança na CA privada com `DEVIN_CA_BUNDLE` ou corrija o certificado do servidor (nome, cadeia, validade).
`NET004`	O endpoint retornou um status HTTP de erro diferente de 401/403. Um `404` em `GET {base_url}/models` é reportado como aviso, já que alguns servidores compatíveis com OpenAI não implementam `/models`.	Verifique os logs do próprio endpoint e o caminho do `base_url` (por exemplo, a falta de `/v1`).
`NET005`	A requisição excedeu o tempo limite (10 s para as sondagens do doctor, 30 s para requisições ao IdP, 30 s de conexão / 300 s de leitura para inferência).	Verifique a carga no endpoint e em qualquer proxy intermediário; consulte tempos limite.
`NET006`	O endpoint rejeitou as credenciais configuradas (HTTP 401/403).	Verifique o valor na variável `api_key.env` e se a chave é válida para o endpoint.

Configuração `CFG`

Reportados pelo devin airgap doctor e na inicialização.

Código	Significado	O que fazer
`CFG001`	Um diretório de configuração ou de estado obrigatório está ausente ou sem permissão de escrita (`~/.config/devin`, `~/.local/share/devin` ou o diretório do produto `cli-federal`; no Windows, `%APPDATA%\devin` ou seu subdiretório `cli-federal`).	Crie o diretório ou corrija o proprietário e as permissões para o usuário que executa o Devin.
`CFG002`	Uma variável de ambiente referenciada pela configuração (o `api_key.env` de um modelo) não está definida no ambiente do agente.	Exporte a variável ou defina-a pela configuração `devin.acp.agentEnv` do Desktop; consulte Variáveis de ambiente da chave de API.
`CFG003`	O arquivo de modelos não foi encontrado em `/etc/devin/models.json` (`C:\ProgramData\Devin\models.json` no Windows) nem no override `DEVIN_MODELS_FILE`.	Instale o arquivo de modelos; consulte Arquivo de modelos.
`CFG004`	O arquivo `DEVIN_CA_BUNDLE` está ausente, ilegível ou não contém certificados PEM válidos.	Corrija o caminho ou o conteúdo do arquivo; consulte Rede e certificados.
`CFG005`	Não foi possível fazer o parsing da definição de um subagente personalizado (`agents/**/AGENT.md` ou um `agents/<name>.md` simples), geralmente por causa de frontmatter YAML inválido; o perfil é ignorado. Também é reportado como aviso quando uma definição declara chaves de frontmatter que o Devin não lê (por exemplo, `allowed_tools` em vez de `allowed-tools`); nesse caso, o perfil ainda é carregado.	Corrija o arquivo indicado e o erro de parsing exibido pelo `devin doctor`.
`CFG006`	Há uma variável de ambiente `OTEL_EXPORTER_OTLP_*` definida que a exportação OTLP ignora (qualquer campo diferente de `ENDPOINT`, `HEADERS`, `TIMEOUT` e `PROTOCOL`; qualquer variável `TRACES_`; ou um `PROTOCOL` não suportado). É apenas um aviso; o nome da variável é exibido, mas nunca o seu valor.	Remova ou corrija a variável.

CFG005 e CFG006 vêm das verificações padrão do devin doctor e não são exclusivos do build air-gapped.

Interpretando uma falha

Uma falha típica de validação:

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])

Localize o código nas tabelas acima, aplique a ação indicada e execute devin airgap doctor novamente até que todas as verificações sejam aprovadas. Se um código não estiver listado aqui, seu build é mais recente que esta página. Nesse caso, execute devin --version e inclua a mensagem completa na sua requisição de suporte, conforme descrito em Solução de problemas.

​LIC Licença

​Arquivo de modelos MDL

​IDP SSO e provedor de identidade

​NET Rede

​Configuração CFG

​Interpretando uma falha

`LIC` Licença

Arquivo de modelos `MDL`

`IDP` SSO e provedor de identidade

`NET` Rede

Configuração `CFG`

Interpretando uma falha