Troubleshooting — IA¶
| Sintoma / mensagem | Causa | Ação |
|---|---|---|
| “O assistente de IA está desativado” | ai.enabled = falso |
Configurações › Inteligência artificial |
IA generativa desabilitada (Configurações > Inteligência artificial) (HTTP 400) |
idem | — |
chave de API do provedor de IA não configurada |
provedor anthropic sem ai.api_key |
informe a chave |
informe a URL base do endpoint compatível com OpenAI |
openai_compatible sem ai.base_url |
ex.: https://meu-vllm.empresa.local/v1 |
falha ao consultar o provedor de IA: … (HTTP 502) |
rede/proxy, chave inválida, modelo inexistente, timeout do provedor | logs da API; teste a saída: docker compose exec api curl -I https://api.anthropic.com (com HTTPS_PROXY se houver) |
| “Não consegui concluir a análise dentro do limite de consultas” | mais de 8 rodadas de ferramentas | pergunte de forma mais específica (objeto + período) |
| resposta sem dados ou genérica | modelo sem suporte confiável a ferramentas | use um modelo com tool use (Claude, GPT-4 class, Llama 3.1+ instruct etc.) |
nomes aparecem como OBJ-001 na resposta |
anonimização ligada e o modelo reescreveu o apelido | normal quando o modelo altera o texto do apelido. Prefira perguntas com o nome original |
| resumo diário sem texto da IA | falha no provedor; a engine mantém a versão determinística | log da engine: resumo com IA falhou, mantendo versão da engine |
| timeout no navegador | resposta > 300 s | proxy_read_timeout do nginx/Ingress; reduza ai.max_tokens |
GET /api/v1/ai/status mostra se a IA está habilitada e pronta, o provedor, o modelo e a anonimização.