Files
ampmInsights/docs/08-glossario-roadmap.html
Antonio Sergio Rodrigues Figueiredo 32b3c23362 Adiciona guia de carga de CMDB/Vulnerabilidades + templates sanitizados
Nova pagina docs/10-carga-cmdb-vulnerabilidades.html documentando como
filtrar e mapear novas cargas de CMDB (ServiceNow) e vulnerabilidades
(Tenable) pra manter o ambiente com dados exclusivos da AM/PM - o export
bruto do grupo Ultrapar traz Ipiranga/Ultrapar/Iconic misturados, e a
coluna "company"/"empresa" do export nao e confiavel (~40% das linhas
marcadas AMPM tinham nome de servidor de outra empresa); o criterio usado
e o prefixo do nome do servidor (AM...).

Inclui os dois templates finais ja sanitizados e com cabecalho mapeado
pro formato esperado pelos perfis de carga do APEX (DL_TECH_CMDB_V1 e
DL_TECH_VULNERABILIDADE_V2): Artefatos/template_limpo_ampm/*_AMPM.xlsx.

.gitignore atualizado pra nunca versionar os exports brutos/intermediarios
(contem dados reais de outras empresas do grupo) - so os *_AMPM.xlsx finais
sao rastreados.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-31 17:11:18 -03:00

85 lines
5.5 KiB
HTML

<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>ampmInsights &middot; Glossário & roadmap</title>
<meta name="description" content="Glossário de termos técnicos e roadmap da jornada Agentic AI para o ambiente ampmInsights.">
<link rel="stylesheet" href="assets/main.css">
</head>
<body>
<div class="layout">
<aside class="sidebar">
<div class="brand">
<span class="oracle">ORACLE</span>
<span class="name">ampmInsights</span>
</div>
<button class="menu-toggle" type="button">Menu &#9776;</button>
<div class="kicker">Documentação V1 &middot; AM/PM</div>
<ul class="nav-list">
<li><a class="" href="index.html"><span class="step-no">1</span>Visão geral</a></li>
<li><a class="" href="02-arquitetura.html"><span class="step-no">2</span>Arquitetura</a></li>
<li><a class="" href="03-pre-requisitos-credenciais.html"><span class="step-no">3</span>Pré-requisitos & credenciais</a></li>
<li><a class="" href="04-passo-a-passo-banco.html"><span class="step-no">4</span>Passo a passo: banco de dados</a></li>
<li><a class="" href="05-passo-a-passo-apex.html"><span class="step-no">5</span>Passo a passo: aplicação APEX</a></li>
<li><a class="" href="06-validacao-testes.html"><span class="step-no">6</span>Validação & testes</a></li>
<li><a class="" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
<li><a class="active" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
<li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
</ul>
<div class="sidebar-footer">
Vulnerability &amp; Audit AI Insights<br>
Oracle AI Database 26ai &middot; AI Vector Search<br>
Versão V1 &middot; ambiente reprodutível do cliente
</div>
</aside>
<main class="content">
<p class="page-kicker">Referência</p>
<h1>Glossário & roadmap</h1>
<p class="lede">Termos usados neste pacote, limitações conhecidas herdadas do ambiente original e como este V1 se encaixa na jornada Agentic AI.</p>
<h2>Glossário</h2>
<div class="table-wrap">
<table>
<tr><th>Termo</th><th>Significado</th></tr>
<tr><td>RAG</td><td>Retrieval-Augmented Generation — busca os trechos mais relevantes (por similaridade vetorial) e usa esse contexto para o LLM responder com evidências.</td></tr>
<tr><td>Embedding</td><td>Representação numérica (vetor) de um texto, usada para medir similaridade semântica.</td></tr>
<tr><td>Chunk</td><td>Trecho de texto em que um documento/relatório é dividido antes de ser vetorizado.</td></tr>
<tr><td>ONNX</td><td>Formato aberto de modelo de IA; usado aqui para carregar um modelo de embeddings local (opcional) no banco.</td></tr>
<tr><td>SELECT AI</td><td>Recurso do Autonomous Database (<code>DBMS_CLOUD_AI</code>) que traduz perguntas em linguagem natural para SQL sobre um conjunto de objetos aprovado.</td></tr>
<tr><td>MCP</td><td>Model Context Protocol — padrão para expor funções/dados como ferramentas de um agente de IA externo.</td></tr>
<tr><td>VPR</td><td>Vulnerability Priority Rating (Tenable) — pontuação de priorização de risco de uma vulnerabilidade.</td></tr>
<tr><td>CMDB</td><td>Configuration Management Database — inventário de ativos/servidores e seus atributos.</td></tr>
<tr><td>ACL de rede</td><td>Regra do Autonomous Database que autoriza um schema a chamar um host externo específico.</td></tr>
<tr><td>ORDS</td><td>Oracle REST Data Services — expõe o schema via REST.</td></tr>
</table>
</div>
<h2>Limitações conhecidas (herdadas do ambiente original)</h2>
<ul>
<li>Vetores em <code>TB_26AI_TECH_VECTOR</code> não são removidos automaticamente ao reprocessar um insight já existente — avaliar rotina de limpeza antes de reprocessar em massa.</li>
<li>A carga de dados atual é "append": recarregar um arquivo já carregado pode duplicar linhas e afetar contagens/indicadores. Um processo de MERGE/UPSERT é uma evolução recomendada.</li>
</ul>
<h2>Roadmap (jornada Agentic AI &mdash; documento em construção)</h2>
<p>O parceiro <strong>V8 Solution</strong> está estruturando a evolução deste ambiente como uma
jornada em movimentos, documentada em <em>Jornada_AgenticAI.pptx</em> (versão ainda em construção).
Este pacote V1 corresponde ao <strong>Level Zero</strong> dessa jornada: provisionar o Autonomous
Database 26ai, organizar schema/segurança/acesso e deixar o ambiente pronto para os movimentos
seguintes (novas integrações de fontes, agentes especialistas por stack e relatórios técnicos/gerenciais).</p>
<div class="callout info">
<div class="callout-title">Atenção a uma divergência de nome</div>
<p>O rascunho da jornada referencia o schema como <code>DEMO_AMPM</code>. Esta documentação e os
scripts desta pasta padronizaram o schema como <code>AMPMINSIGHTS</code>, conforme solicitado para
este pacote. Alinhe com a V8 Solution qual nome deve prevalecer antes de consolidar a versão final
da jornada.</p>
</div>
<div class="pillnav"><a class="prev" href="07-seguranca-boas-praticas.html">&larr; Segurança & boas práticas</a><a class="next" href="09-operacao-observabilidade.html">Operação & observabilidade &rarr;</a></div>
</main>
</div>
<script src="assets/main.js"></script>
</body>
</html>