120 lines
3.1 KiB
Markdown
120 lines
3.1 KiB
Markdown
# 05 - Legacy App AI Extension
|
|
|
|
## Objetivo
|
|
|
|
Demonstrar como uma aplicacao legada pode ser ampliada com um agente AI sem reescrever toda a autorizacao da aplicacao.
|
|
|
|
## O Que Este Lab Mostra
|
|
|
|
Antes do Oracle Deep Data Security, um agente AI conectado ao mesmo schema do legado pode consultar clientes, margem, contratos, clausulas legais e tickets privados. Depois dos data grants, o agente recebe apenas os dados permitidos para a persona propagada.
|
|
|
|
## Personas
|
|
|
|
- `joao`: vendedor regional.
|
|
- `ana`: gerente comercial Brasil.
|
|
- `maria`: atendimento ao cliente.
|
|
- `sofia`: juridico.
|
|
- `legacy_app`: conta tecnica da aplicacao existente.
|
|
- `ai_agent_app`: conta tecnica do novo agente AI.
|
|
|
|
## Onde Executar Os Comandos
|
|
|
|
Execute os comandos a partir da raiz do repositorio:
|
|
|
|
```powershell
|
|
cd C:\Users\rodrigo\Documents\Codex\oracle-deep-data-security-lab
|
|
```
|
|
|
|
Conecte no banco com SQLcl ou SQL*Plus:
|
|
|
|
```bash
|
|
sql "<connect_string>"
|
|
```
|
|
|
|
Exemplo:
|
|
|
|
```text
|
|
ADMIN/<senha>@ddslab_high
|
|
```
|
|
|
|
Se estiver usando Autonomous Database com wallet, configure `TNS_ADMIN` apontando para o diretorio da wallet antes de conectar.
|
|
|
|
## Passo A Passo - Antes, Ambiente Vulneravel
|
|
|
|
1. Acesse o banco:
|
|
|
|
```bash
|
|
sql "<connect_string>"
|
|
```
|
|
|
|
2. Limpe qualquer execucao anterior:
|
|
|
|
```sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/99_reset.sql
|
|
```
|
|
|
|
3. Crie o dataset legado, contratos, tickets e personas:
|
|
|
|
```sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/00_schema.sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/01_seed_data.sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/02_identities.sql
|
|
```
|
|
|
|
4. Simule a pergunta do agente AI:
|
|
|
|
```text
|
|
Liste todos os clientes de alto risco, margem, renovacoes, clausulas legais e notas privadas de atendimento.
|
|
```
|
|
|
|
5. Execute as queries amplas que representam a resposta do agente:
|
|
|
|
```sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/04_test_queries.sql
|
|
```
|
|
|
|
Resultado esperado antes: o agente consegue juntar dados comerciais, juridicos e de atendimento alem do necessario.
|
|
|
|
## Passo A Passo - Depois, Com Deep Data Security
|
|
|
|
1. Aplique os data grants:
|
|
|
|
```sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/03_data_grants.sql
|
|
```
|
|
|
|
2. Execute novamente as mesmas queries:
|
|
|
|
```sql
|
|
@scenarios/05-legacy-app-ai-extension/sql/04_test_queries.sql
|
|
```
|
|
|
|
3. Repita a demonstracao simulando as personas `joao`, `ana`, `maria` e `sofia`.
|
|
|
|
Resultado esperado depois:
|
|
|
|
- `joao` ve sua carteira sem margem nem legal hold.
|
|
- `ana` ve clientes Brasil e metricas comerciais regionais.
|
|
- `maria` ve tickets operacionais, sem clausulas juridicas ou notas privadas.
|
|
- `sofia` ve contratos e clausulas juridicas autorizadas.
|
|
- A modernizacao com AI acontece sem expor o schema inteiro.
|
|
|
|
## Execucao Automatizada Opcional
|
|
|
|
Windows:
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File .\scripts\run-scenario.ps1 -Scenario 05-legacy-app-ai-extension -ConnectString "<connect_string>"
|
|
```
|
|
|
|
Linux/macOS:
|
|
|
|
```bash
|
|
./scripts/run-scenario.sh 05-legacy-app-ai-extension "<connect_string>"
|
|
```
|
|
|
|
## Detalhes Da Demo
|
|
|
|
Veja o passo a passo completo, evidencias e referencias oficiais em [RUNBOOK.md](RUNBOOK.md).
|
|
|