Arquitetura
Como as peças se conectam
Do dado bruto ao insight de IA vetorizado e pesquisável — os componentes técnicos do ambiente e o papel de cada objeto de banco.
As três fontes acima chegam por Data Load da própria aplicação APEX (upload de planilha/CSV)
e alimentam as tabelas técnicas do schema AMPMINSIGHTS.
Componentes principais
| Componente | Papel no fluxo |
|---|---|
| Autonomous Database 26ai | Hospeda o schema AMPMINSIGHTS: tabelas, view, PL/SQL, credencial OCI e o job de geração de insights. |
AI Vector Search (DBMS_VECTOR / DBMS_VECTOR_CHAIN) | Gera embeddings (Cohere embed-v4, ou ONNX local opcional) e realiza a busca por similaridade usada no RAG. |
| OCI Generative AI | Modelo meta.llama-4-maverick-17b-128e-instruct-fp8 para geração de texto/insight e cohere.embed-v4.0 para embeddings. |
DBMS_CLOUD_AI (SELECT AI) | Permite perguntas em linguagem natural diretamente sobre V_26AI_TECH e TB_26AI_TECH_CMDB. |
| APEX — ampmInsights (app 100) | Interface web: cadastro/carga de dados, tabela de achados, chat RAG, disparo do job de geração de insights em lote. |
DBMS_SCHEDULER | Job criado dinamicamente pela própria aplicação (botão "Gerar Insights em Lote") para processar os registros pendentes. |
Objetos de banco (nomes preservados)
Os nomes abaixo são referenciados diretamente, em dezenas de pontos, pelo export da aplicação
APEX (02_ampminsights_apex_app.sql). Por isso eles não foram renomeados
nesta versão V1 — apenas o schema/usuário que os contém mudou de nome.
| Objeto | Tipo | Uso |
|---|---|---|
TB_26AI_TECH_PARAMS | Tabela | Parâmetros (nome da credencial e OCID do compartimento) lidos por todo o PL/SQL e pelo job em lote. |
TB_26AI_TECH_CMDB | Tabela | Ativos/servidores (CMDB). |
TB_26AI_TECH_V2 | Tabela | Achados de vulnerabilidade (fonte principal) + insight gerado. |
TB_26AI_TECH | Tabela | Tabela legada, ainda usada por uma carga/página mais antiga da aplicação. |
TB_26AI_TECH_SYS | Tabela | Eventos de syslog (opcional) + insight gerado. |
TB_26AI_TECH_CHAT | Tabela | Histórico de interações do chat "fale com os dados". |
TB_26AI_TECH_VECTOR | Tabela | Vetores/chunks usados na busca semântica (RAG). |
V_26AI_TECH | View | Junta vulnerabilidades + CMDB; usada pela aplicação e pelo profile de SELECT AI. |
SEQ_26AI_TECH / BIU_TB_26AI_TECH_V2 | Sequence / Trigger | Gera o identificador sequencial de insight (ID_INSIGHT). |
PL/SQL de geração de insights e RAG
| Rotina | Função |
|---|---|
fnc_26ai_embed | Gera o embedding de um texto (COHERE via OCI Generative AI, ONNX local, ou vLLM self-hosted opcional). |
fnc_26ai_tech_rag | Busca os trechos mais similares em TB_26AI_TECH_VECTOR e monta a resposta aumentada (RAG) via Llama 4. |
FNC_26AI_TECH_MCP_V1 | Wrapper de fnc_26ai_tech_rag pensado para exposição como ferramenta MCP a um agente externo. |
FNC_26ai_rag | Chamada genérica ao OCI Generative AI (chat) usada tanto pelo RAG quanto pela geração de insight. |
prc_26ai_tech | Gera o insight (análise/diagnóstico/recomendações/plano de ação) para um registro e cria o vetor correspondente. |
Não existe um DBMS_SCHEDULER.CREATE_JOB estático no script de setup: o job
(JOB_26AI_TECH_VULNERABILIDADE / equivalente para syslog) é criado em tempo de
execução pela própria aplicação APEX, quando o usuário aciona o botão de processamento em
lote. O job lê o nome da credencial e o OCID do compartimento diretamente de
TB_26AI_TECH_PARAMS — por isso preencher essa tabela corretamente (SEÇÃO 2 do script 1,
a tabela de configuração) é o passo mais crítico de toda a configuração.