Diagnóstico e troubleshooting
Um roteiro para investigar ausência de modelos, runs incompletas, baixa confiança, falhas de webhook e controles Enterprise indisponíveis.
Como interpretar este documento
Este conteúdo descreve o comportamento técnico e metodológico implementado ou explicitamente planejado no produto. Quando um controle depende de configuração, provider, secret, contrato ou aprovação jurídica, essa dependência deve permanecer visível.
Modelos não aparecem
Verifique se ModelConfig está enabled, se o modelo suporta a metodologia escolhida, se o provider está acessível e se o plano permite a quantidade ou capacidade solicitada.
Run não conclui
Analise MeasurementJobs, estado da fila, heartbeats, erros de provider e limites de entitlement. Não marque manualmente uma run como concluída apenas para liberar análises.
Confidence Insufficient
Confirme prompts únicos, modelos distintos, tamanho efetivo de amostra e completude. A solução preferida é melhorar desenho e execução, não esconder o warning.
Source Intelligence vazio
Confirme que a metodologia gera evidência web, que fontes estruturadas foram capturadas e que a run possui respostas Grounded válidas.
Webhook indisponível
Confirme WEBHOOK_SIGNING_SECRET e política API-1.0. Registro deve permanecer bloqueado quando assinatura segura não puder ser garantida.
Integração não conecta
Diferencie connector disponível de OAuth autorizado. Verifique tenant safety, entitlement integration_hub, autorização do provider, scopes concedidos e configuração específica como site_url ou property_id.
Integration Hub bloqueado por tenant safety
Em app_shared_single_tenant, mais de uma Organization bloqueia uso de connector app-scoped. Migre para estratégia tenant_dedicated_external ou isolamento equivalente antes de sincronizar dados.
SSO/SCIM indisponível
EID-1.0 exige provider, verified domain e secrets específicos. A existência do control plane não significa que o tenant está configurado.
Go-live bloqueado
Abra o gate GLR-1.0 e corrija checks críticos antes de liberar rollout. Warning deve ser compreendido e documentado, não simplesmente ignorado.