TuaGPT: Cartelle ricorsive e perimetro progetto: segmentare le chat e focalizzare la ricerca

Da gruppi piatti a cartelle gerarchiche

In passato le conversazioni potevano appartenere a un gruppo singolo. Oggi TuaGPT usa cartelle gerarchiche: ogni cartella può avere una cartella madre, fino a profondità arbitraria. Le chat sono collegate con un indice; la radice virtuale raccoglie tutto ciò che non ha cartella assegnata.

La gestione è centralizzata dal menu contestuale sulla lista chat: Gestisci cartelle… apre un form dedicato (con albero, creazione, rinomina, spostamento). Puoi anche spostare una chat con Sposta nella cartella o riportarla in radice. L’archivio conversazioni rispetta la stessa gerarchia, così backup e consultazione restano allineati all’organizzazione quotidiana.

Le etichette colorate restano un canale separato: servono a evidenziare visivamente una chat, non a definire il perimetro di ricerca. Per delimitare ambiti di lavoro conta la cartella (e, se attivo, il perimetro).

Cartelle ricorsive nella finestra principale

Organizzare su cartelle non basta se non vedi chiaramente cosa c’è dentro ogni ramo. Dalla release 2.4.1.1 l’elenco chat supporta la navigazione ricorsiva:

• Aprendo una cartella madre compaiono le sottocartelle e le chat direttamente in essa contenute.
• Le righe cartella mostrano metadati utili, ad esempio Chat contenute e Cartelle contenute (solo se i conteggi sono maggiori di zero), senza appesantire il titolo.
• Quando una chat ha chat correlate nelle sottocartelle, puoi vedere il segnale Chat nelle sottocartelle nei metadati.
• La risalita è esplicita: Risali su: <nome cartella madre>, oltre alle voci Radice e al filtro Visualizza tutto (icona disco, distinta dalle cartelle).

Il combo Filtra per cartella resta indentato: «Cartella madre» ti permette di salire di un livello senza perdere il contesto. Il filtro data dell’elenco chat continua a valere per quali conversazioni vedi; quando il perimetro progetto è attivo, lo stesso filtro data partecipa anche al calcolo delle chat cercabili (con l’eccezione degli agenti in background, vedi sotto).

Perché segmentare le attività con le cartelle

Pensare una cartella come un progetto (cliente, prodotto, ricerca, reparto) è il modo più semplice per tenere ordine senza micro-gestire ogni conversazione.

Le chat lasciate in radice restano utili per domande generiche o prove rapide: non sono «sbagliate», semplicemente non appartengono a un progetto delimitato. Per una chat senza cartella il perimetro è la radice, che comprende tutte le chat non archiviate (con l’eventuale filtro data); il RAG segue le regole descritte più avanti.

Il perimetro progetto: circoscrivere la ricerca

Il perimetro progetto (riga «Perimetro progetto (cartella della chat)» in Opzioni Ricerca Unificata) non è un filtro salvato nella chat. Si ricalcola all’inizio di ogni ricerca con il pulsante Cerca o di ogni invio in cui il modello usa i tool di ricerca. Conta la cartella della chat su cui stai lavorando, non la cartella che stai solo sfogliando nell’elenco.

Regola geometrica del perimetro:

1. Parti dalla cartella della chat corrente.
2. Includi tutte le sottocartelle, a qualunque profondità.
3. Non includere le cartelle superiori (madri o antenate).
4. Considera le chat non archiviate in quelle cartelle; la chat su cui lavori è sempre inclusa, anche se il filtro data dell’elenco la escluderebbe momentaneamente dalla vista.

Se sposti la chat in un’altra cartella, dalla ricerca successiva il perimetro cambia automaticamente. Navigare l’elenco su un altro ramo non sposta il perimetro finché non cambi la chat attiva.

Nei risultati compare una riga esplicativa, ad esempio:

Perimetro progetto: cartella «Clienti / Rossi» e sottocartelle, filtro data «Chat ultima settimana», 12 chat; documenti RAG ammessi: 4.

Se il database non permette di calcolare il perimetro, TuaGPT adotta un comportamento fail-closed: le sorgenti legate alle conversazioni e l’archivio RAG non vengono interrogati e la riga del perimetro lo segnala, invece di espandere silenziosamente la ricerca a tutto l’archivio.

Cosa include il perimetro e cosa resta globale

Il tetto sui file contestuali con perimetro attivo è deliberato: un progetto con molti allegati non deve riempire il contesto del modello con decine di estratti da 200 caratteri ciascuno. Per il lavoro documentale strutturato restano RAG e cartella sicura.

Due colonne indipendenti in Opzioni ricerca ti permettono di separare i ruoli:

• Utente — pulsante Cerca (inserisce i risultati in chat).
• LLM — tool global_search, rag_vector_search e agenti FN in background.

Entrambe le caselle del perimetro sono disattivate per default: il comportamento resta quello globale delle versioni precedenti finché non le abiliti esplicitamente.

RAG nel perimetro e agenti che restano nel progetto

Corpus RAG per ramo

Con il perimetro attivo, i tool RAG non usano più solo il filtro della singola chat: riportano nel perimetro i documenti RAG disponibili in ogni chat del ramo, nello stato in cui si trovano (una query aggregata, ricalcolata a ogni ricerca o invio). Una chat con Abilita dati RAG attivo porta i documenti del suo filtro («Filtra dati RAG») oppure tutti i documenti indicizzati se non ha filtro; una chat con il RAG spento non porta nulla, anche se conserva un filtro. Se nessuna chat del ramo ha il RAG attivo con documenti indicizzati, i tool non restituiscono chunk e lo dichiarano nel risultato e nel prompt. Quando il catalogo RAG entra nel system prompt, con perimetro attivo il modello vede l’elenco dei documenti ammessi (fino a 30 nomi) o un avviso che non ce ne sono.

Buona pratica: una chat «Riferimento RAG» nel ramo del progetto, con Abilita dati RAG attivo e Filtra dati RAG puntato ai documenti di quella commessa. Le altre chat dello stesso cliente ereditano il corpus senza duplicare la configurazione: in quelle lascia il RAG spento oppure imposta un filtro, perché basta una chat del ramo con il RAG attivo e senza filtro per aprire il progetto a tutti i documenti indicizzati.

I risultati condivisi della ricerca ibrida restano esclusi quando il perimetro (o un filtro documenti stretto) è attivo, così non si aggira il confine con identificativi remoti non allineati ai documenti locali.

Agenti FN e Planner

Un agente in background lavora sulla sua chat target. Se il perimetro LLM era attivo al lancio del job, il perimetro viene calcolato da quella chat e bloccato per tutta l’esecuzione anche se nel frattempo apri altre conversazioni, cambi filtro data o disattivi l’opzione nell’interfaccia. Vale anche per i lanci automatici del Planner. Sul perimetro agente non si applica il filtro data dell’elenco: l’automazione deve poter ritrovare tutto il materiale del progetto, non solo la settimana corrente.

Il perimetro calcolato al lancio è tracciato nel log applicativo insieme alle altre voci dell’agente, utile per diagnosticare ricerche «vuote» o troppo ampie.

Come attivare il perimetro

1. Tasto destro sul pulsante Cerca → Opzioni Ricerca Unificata.
2. Nella tabella Sorgenti di ricerca, riga Perimetro progetto (cartella della chat), spunta la colonna Utente e/o LLM secondo chi deve rispettare il confine.
3. Abilita le altre sorgenti che ti servono (chat, note, RAG, file, ecc.) come già facevi: il perimetro restringe le sorgenti attive, non ne attiva di nuove da solo.
4. Conferma con Salva.

Organizza prima le cartelle (menu contestuale → Gestisci cartelle…), sposta le chat nei rami corretti, poi attiva il perimetro quando vuoi che Cerca e il modello smettano di attingere all’intero archivio. Il tooltip del pulsante Cerca riporta se il perimetro è attivo per Cerca e per i tool LLM.

Schema pratico: un cliente, tre livelli

Radice
└── Clienti
    └── Rossi
        ├── Offerte 2026      ← chat operative sulle offerte
        ├── Contratti         ← chat legali / revisioni
        └── _RAG Rossi        ← RAG attivo, filtro su tutti i PDF del cliente

Se lavori in una chat dentro Offerte 2026 con perimetro attivo, le ricerche non vedono le chat di altri clienti né quelle in radice. Se lavori in Rossi (cartella madre), il perimetro include anche Offerte, Contratti e la chat RAG di riferimento. Se lavori in una chat senza cartella, il perimetro è l’intera radice (tutte le chat non archiviate); per avere un confine netto, assegna sempre una cartella al progetto.

Domande frequenti (sintesi)

Riepilogo

Le cartelle ricorsive trasformano l’elenco chat in una mappa del tuo lavoro: progetti, clienti, fasi, corpus documentali. Il perimetro progetto collega quella mappa alla ricerca globale, così il modello e il pulsante Cerca attingono a messaggi, note, fonti web e RAG solo dove ha senso per la commessa in corso. Meno rumore tra progetti, meno token sprecati, risposte più aderenti all’ambito che hai definito tu — senza micro-configurazioni per ogni conversazione.