melhorias de ferramentas
This commit is contained in:
parent
9947cc7e51
commit
2a029d126b
1 changed files with 63 additions and 0 deletions
|
|
@ -220,6 +220,7 @@ curl -s -X POST "https://memoria-ia.idz.one/api/tags/populares" \
|
||||||
|
|
||||||
| Rota | Finalidade |
|
| 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` | Busca full-text em todas as memórias |
|
||||||
| `POST /api/busca/rapida` | Busca simplificada (títulos e resumos) |
|
| `POST /api/busca/rapida` | Busca simplificada (títulos e resumos) |
|
||||||
| `POST /api/memorias/criar` | Criar nova memória |
|
| `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/buscar` | Buscar por código |
|
||||||
| `POST /api/memorias/listar` | Listar com filtros e paginação |
|
| `POST /api/memorias/listar` | Listar com filtros e paginação |
|
||||||
| `POST /api/memorias/excluir` | Exclusão lógica |
|
| `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/criar` | Criar vínculo entre memórias |
|
||||||
| `POST /api/vinculos/listar` | Listar vínculos de uma memória |
|
| `POST /api/vinculos/listar` | Listar vínculos de uma memória |
|
||||||
| `POST /api/vinculos/excluir` | Excluir vínculo |
|
| `POST /api/vinculos/excluir` | Excluir vínculo |
|
||||||
| `POST /api/categorias/listar` | Listar categorias disponíveis |
|
| `POST /api/categorias/listar` | Listar categorias disponíveis |
|
||||||
| `POST /api/tags/listar` | Listar todas as tags |
|
| `POST /api/tags/listar` | Listar todas as tags |
|
||||||
| `POST /api/tags/populares` | Tags mais usadas |
|
| `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
|
## Boas práticas
|
||||||
|
|
||||||
1. **Buscar antes de criar** — evitar duplicatas na base
|
1. **Buscar antes de criar** — evitar duplicatas na base
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue