melhorias de ferramentas

This commit is contained in:
Luiz Silva 2026-06-24 10:50:32 -03:00
parent 9947cc7e51
commit 2a029d126b

View file

@ -220,6 +220,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/tags/populares" \
| Rota | Finalidade |
|------|-----------|
| `GET /api/status` | Checar healthcheck da API da memória |
| `POST /api/busca` | Busca full-text em todas as memórias |
| `POST /api/busca/rapida` | Busca simplificada (títulos e resumos) |
| `POST /api/memorias/criar` | Criar nova memória |
@ -227,12 +228,17 @@ curl -s -X POST "https://memoria-ia.idz.one/api/tags/populares" \
| `POST /api/memorias/buscar` | Buscar por código |
| `POST /api/memorias/listar` | Listar com filtros e paginação |
| `POST /api/memorias/excluir` | Exclusão lógica |
| `POST /api/memorias/mesclar` | Fundir duas memórias e inativar a origem |
| `POST /api/memorias/sinalizar` | Marcar memória como obsoleta ou que precisa de revisão |
| `POST /api/memorias/batch` | Operações em lote (criar e editar múltiplos registros) |
| `POST /api/memorias/historico` | Ver histórico de alterações de uma memória |
| `POST /api/vinculos/criar` | Criar vínculo entre memórias |
| `POST /api/vinculos/listar` | Listar vínculos de uma memória |
| `POST /api/vinculos/excluir` | Excluir vínculo |
| `POST /api/categorias/listar` | Listar categorias disponíveis |
| `POST /api/tags/listar` | Listar todas as tags |
| `POST /api/tags/populares` | Tags mais usadas |
| `POST /api/contextos/listar` | Listar todos os contextos existentes |
---
@ -295,6 +301,63 @@ curl -s -X POST "https://memoria-ia.idz.one/api/vinculos/excluir" \
---
## PASSO 7 — Operações de Manutenção e Qualidade
Para garantir a qualidade da rede de conhecimento a longo prazo:
### Sinalizar como obsoleta ou em revisão
Se uma memória não faz mais sentido ou o código mudou, sinalize-a (não exclua, a menos que seja lixo):
```bash
curl -s -X POST "https://memoria-ia.idz.one/api/memorias/sinalizar" \
-H 'Content-Type: application/json' \
-H "CHAVE: banana" \
-d '{
"codigo": 42,
"obsoleto": true,
"motivo": "Este padrão foi refatorado e substituído pelo novo helper",
"sinalizado_por": "@ag-back"
}'
```
### Mesclar memórias duplicadas
Se houver duas memórias sobre o mesmo assunto:
```bash
curl -s -X POST "https://memoria-ia.idz.one/api/memorias/mesclar" \
-H 'Content-Type: application/json' \
-H "CHAVE: banana" \
-d '{
"codigo_origem": 10,
"codigo_destino": 5,
"acao_origem": "sinalizar",
"realizado_por": "@ag-memoria"
}'
```
*(As tags e vínculos da origem irão para o destino. A origem será sinalizada ou excluída de acordo com `acao_origem`)*
### Operações em Lote (Batch)
Se precisar importar ou registrar múltiplas memórias rapidamente:
```bash
curl -s -X POST "https://memoria-ia.idz.one/api/memorias/batch" \
-H 'Content-Type: application/json' \
-H "CHAVE: banana" \
-d '{
"criar": [
{ "titulo": "Regra 1", "conteudo": "...", "resumo": "...", "categoria": "regras-negocio", "criado_por": "@ag-memoria" }
],
"editar": [
{ "codigo": 8, "tags": ["nova-tag"], "atualizado_por": "@ag-memoria" }
]
}'
```
---
## Boas práticas
1. **Buscar antes de criar** — evitar duplicatas na base