Ricerca nelle sessioni

sessions_search cerca nel testo dell'utente e dell'assistente delle proprie sessioni passate. Ogni risultato include un sessionKey, un timestamp, un ruolo e un breve estratto corrispondente. Passare il valore sessionKey restituito a sessions_history quando è necessario il contesto della conversazione.

Visibilità e output

La ricerca usa le stesse regole di visibilità delle sessioni di sessions_history. I risultati al di fuori dell'albero delle sessioni visibile al chiamante vengono rimossi prima di applicare i limiti ai risultati. Gli agenti in sandbox rimangono limitati alle sessioni che hanno generato quando la visibilità delle sessioni generate è abilitata.

Gli estratti vengono oscurati prima di essere restituiti al modello. I risultati sono inoltre limitati per numero, lunghezza degli estratti e dimensione totale della risposta.

Ciclo di vita dell'indice

OpenClaw archivia un indice full-text accanto alle righe delle trascrizioni nel database SQLite di ciascun agente. I nuovi messaggi dell'utente e dell'assistente vengono indicizzati nella stessa transazione che li rende persistenti, quindi l'indice non rimane mai indietro rispetto alle conversazioni attive; i risultati degli strumenti, i blocchi di ragionamento e le immagini sono esclusi. È ricercabile solo il ramo attivo della trascrizione.

Le trascrizioni precedenti alla creazione dell'indice (ad esempio, le sessioni importate da openclaw doctor) e le sessioni il cui ramo attivo è stato riavvolto vengono reindicizzate tramite una riconciliazione in background che inizia con la ricerca successiva. Una risposta con indexing: true può quindi essere incompleta; riprovare al termine dell'indicizzazione. L'eliminazione di una sessione rimuove le relative voci dall'indice nella stessa transazione.

Attualmente la ricerca usa il tokenizzatore di parole Unicode di SQLite con rimozione dei segni diacritici. La tokenizzazione tramite trigrammi per la corrispondenza di sottostringhe CJK è un miglioramento futuro.

Ricerca nelle sessioni e ricerca nella memoria

Usare sessions_search per parole o frasi esatte tratte dalle trascrizioni non elaborate delle sessioni. Usare memory_search per i file di memoria persistenti e il richiamo semantico. Il corpus sperimentale della memoria delle sessioni è il complemento semantico di questa ricerca esatta nelle trascrizioni.