Files

T

enne2 f6d9c5872d feat: min_score anti-rumore nella ricerca + igiene metadata

- gateway v2.2.0: SearchIn.min_score → score_threshold a livello Qdrant (filtra sotto soglia), audit e risposta con min_score
- estensione v1.2.0: qmem_search con min_score default 0.45 (guida punteggi in descrizione), marker ⚠️ per score<0.60, messaggio dedicato quando 0 risultati rilevanti
- dati: eliminato record rumore ('valuta preferita EUR'), assegnati project_id mancanti via supersede (domotics, pi-qmem x2, agy-pi)
- AGENTS.md: sezione interpretazione punteggi

2026-08-13 13:02:37 +02:00

2.3 KiB

Raw Blame History

pi-qmem

Memoria centralizzata e condivisa per agenti AI — estensione per pi.

Salva e cerca record semantici (fatti, decisioni, preferenze, episodi) in un Memory Gateway (FastAPI + Qdrant + BGE-M3) ospitato su un server remoto raggiungibile via VPN. Nessun LLM in scrittura: l'agente salva record deliberati e strutturati; il retrieval è vettoriale + filtri metadata.

Installazione

pi install git:git.enne2.net/enne2/pi-qmem

Oppure copia extensions/index.ts in ~/.pi/agent/extensions/pi-qmem/.

Tool

Tool	Descrizione
`qmem_store`	Salva un record di memoria (text, kind, agent_id, scope, project_id, source, expires_at, supersedes_id, supersede_reason)
`qmem_search`	Ricerca semantica su tutta la conoscenza condivisa (query, kind, project_id, scope, top_k, include_superseded, min_score)
`qmem_correct`	Corregge una memoria falsa: crea un nuovo record che supersede il vecchio (che resta in archivio marcato superseded)

Comando

/qmem:config — menu interattivo (TUI):

🌐 Imposta URL gateway
🔑 Cambia API key
🔌 Test connessione (verifica URL + validità chiave)
📋 Mostra configurazione
↩️ Annulla

Modalità CLI rapida: /qmem:config url <URL> | apikey <KEY> | test

Config salvata in ~/.config/pi-qmem/config.json (0600):

{
  "url": "http://10.8.0.3:8082",
  "apiKey": "..."
}

Gateway (componente server)

La cartella gateway/ contiene il Memory Gateway FastAPI da deployare sul server (Docker Compose con Qdrant 1.19 + Ollama BGE-M3). Vedi gateway/README.md per il deploy.

Architettura

pi (estensione) ──HTTPS/VPN──▶ Memory Gateway (FastAPI) ──▶ Qdrant 1.19
                                      │
                                      └──▶ Ollama BGE-M3 (embedding locale)

Accesso condiviso: una chiave API con accesso completo in lettura/scrittura
agent_id è solo metadata di provenienza, non isolamento
Rate limit, audit log, cleanup automatico dei record scaduti
Correzioni: i record sono immutabili; correggere una memoria falsa = nuovo record che supersede il vecchio (qmem_correct o qmem_store con supersedes_id). Il vecchio resta in archivio con superseded_by, escluso dalla ricerca di default (include_superseded=true per la lineage)

Licenza

MIT

2.3 KiB Raw Blame History