Pular para conteúdo

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.