Depois de uma sessao de troubleshooting real (schema errado, tipo de OCID
errado, credencial com valor velho, Application Settings do APEX
desincronizadas da tabela de config), formaliza cada um desses pontos como
uma checagem que roda imediatamente apos a etapa correspondente, em vez de
so aparecer como sintoma bem mais tarde:
- Entre Secao 1 e 2: confirma que a sessao trocou para AMPMINSIGHTS
(SELECT USER FROM DUAL) antes de continuar.
- Fim da Secao 2: confere que EMBEDDING_COMPARTMENT/OCI_TENANCY_OCID/
OCI_USER_OCID tem o PREFIXO de OCID certo (nao so que foram preenchidos) -
pega o caso real de hoje onde o OCID do Autonomous Database foi colado no
lugar do compartimento.
- Fim da Secao 3: lembrete de que a credencial precisa ser recriada se
EMBEDDING_COMPARTMENT mudar depois dela ja existir.
- Fim da Secao 7: confere STATUS = VALID dos 6 objetos novos antes de seguir
pra instalacao do APEX.
- docs/09: nova secao explicando que a lupa "AI Insight" le credencial/
compartimento/regiao das Application Settings do APEX (Shared Components),
nao da TB_26AI_TECH_PARAMS - as duas fontes precisam ser mantidas em
sincronia manualmente. Duas linhas novas no checklist de erros comuns.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Region estava fixa em us-chicago-1 em varios pontos (ACL, testes 5.1/5.2/5.3,
FNC_26ai_rag, fnc_26ai_tech_rag, fnc_26ai_embed, PRC_26AI_TECH). Tenancies com
escopo regional restrito (ex. America Latina) podem nao alcancar essa regiao,
mesmo com credencial/ACL/compartimento corretos - o sintoma e ORA-20404
"Object not found" com uma URL bem formada.
Novo parametro GENAI_REGION em TB_26AI_TECH_PARAMS (default us-chicago-1,
editavel) substitui o valor fixo em todos os pontos de chamada. Seção 1.6
(ACL) continua com host fixo por rodar antes da tabela de config existir,
mas o comentario agora aponta para o parametro. docs/09 ganhou uma entrada
de checklist nova: ORA-20404 com URL correta pode ser modelo aposentado
para uso on-demand na regiao (verificavel via
`oci generative-ai model-collection list-models`), nao so credencial/ACL.
Seções 6 e 7 de docs/04-passo-a-passo-banco.html tambem foram
resincronizadas com o sql/01_ampminsights_db_setup.sql atual (estavam
desatualizadas desde a adição do TB_26AI_TECH_LOG).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Estado na virada para versionamento: Secoes 1-5 do setup de banco
validadas ponta a ponta (ONNX CLIP corrigido - ORA-54426; regiao do
Generative AI corrigida na Secao 5.3 - ORA-20404), observabilidade de
IA adicionada (TB_26AI_TECH_LOG + PRC_26AI_TECH_LOG instrumentando
FNC_26ai_rag/fnc_26ai_tech_rag/fnc_26ai_embed/PRC_26AI_TECH), bug de
vazamento de sqlerrm em insight_report corrigido, job de geracao em
lote agora se autoencerra, e nova doc 09-operacao-observabilidade.html
com checklist de erros comuns e consultas de troubleshooting.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
