Torna a regiao do Generative AI configuravel (GENAI_REGION)

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>
This commit is contained in:
2026-07-24 15:20:32 -03:00
parent 56c11d0715
commit 1e9af90582
4 changed files with 272 additions and 56 deletions

View File

@@ -98,6 +98,8 @@ Allow group ampminsights-app to read objects in compartment &lt;nome-do-comparti
<tr><td><code>OCI_REGION</code></td><td>Passo 4 acima (campo <code>region</code>), ex.: <code>sa-saopaulo-1</code>.</td></tr>
<tr><td><code>OS_NAMESPACE</code></td><td>Passo 6 acima. Só necessário se for usar o modelo ONNX (Seção 4 do script 1).</td></tr>
<tr><td><code>OS_BUCKET</code></td><td>Nome que você escolher para o bucket que vai criar na Seção 4 do script 1.</td></tr>
<tr><td><code>GENAI_REGION</code></td><td>Região do OCI Generative AI (Seção 5+) — pode ser diferente de <code>OCI_REGION</code>. Padrão <code>us-chicago-1</code>; troque se sua tenancy não alcançar essa região (ver <a href="09-operacao-observabilidade.html">Operação &amp; observabilidade</a>).</td></tr>
<tr><td><code>AI_LOG_RETENTION_DAYS</code></td><td>Preenchido automaticamente (90 dias) — dias de retenção do log de chamadas de IA/embeddings.</td></tr>
<tr><td>Chave privada (.pem)</td><td>Passo 7 acima — colada direto na Seção 3 do script 1, nunca na tabela de configuração.</td></tr>
<tr><td>Credenciais do export APEX (<code>apex_cred</code>, <code>RAG_CRED</code>, compartimento no remote server <code>apex_genai</code>)</td><td>Mesmos valores de tenancy/compartimento acima — preenchidos na importação do app (ver <a href="05-passo-a-passo-apex.html">Passo a passo: aplicação APEX</a>).</td></tr>
</table>