Pesquisa de sessões

sessions_search pesquisa o texto do usuário e do assistente em suas próprias sessões anteriores. Cada resultado inclui uma sessionKey, um carimbo de data/hora, uma função e um breve trecho correspondente. Passe a sessionKey retornada para sessions_history quando precisar do contexto da conversa.

Visibilidade e saída

A pesquisa usa as mesmas regras de visibilidade de sessão que sessions_history. Os resultados fora da árvore de sessões visível para o chamador são removidos antes da aplicação dos limites de resultados. Agentes em sandbox permanecem limitados às sessões que iniciaram quando a visibilidade de sessões iniciadas está habilitada.

Os trechos são editados para ocultar informações sensíveis antes de serem retornados ao modelo. Os resultados também são limitados por quantidade, tamanho dos trechos e tamanho total da resposta.

Ciclo de vida do índice

O OpenClaw armazena um índice de texto completo junto às linhas da transcrição no banco de dados SQLite de cada agente. Novas mensagens do usuário e do assistente são indexadas na mesma transação que as persiste, portanto o índice nunca fica defasado em relação às conversas em andamento; resultados de ferramentas, blocos de raciocínio e imagens são excluídos. Somente a ramificação ativa da transcrição pode ser pesquisada.

Transcrições anteriores à criação do índice (por exemplo, sessões importadas por openclaw doctor) e sessões cuja ramificação ativa foi retrocedida são reindexadas por uma reconciliação em segundo plano que começa na próxima pesquisa. Portanto, uma resposta com indexing: true pode estar incompleta; tente novamente após a conclusão da indexação. A exclusão de uma sessão remove suas entradas do índice na mesma transação.

Atualmente, a pesquisa usa o tokenizador de palavras Unicode do SQLite com remoção de diacríticos. A tokenização por trigramas para correspondência de substrings em CJK é uma melhoria futura.

Pesquisa de sessões em comparação com pesquisa de memória

Use sessions_search para palavras ou frases exatas das transcrições brutas das sessões. Use memory_search para arquivos de memória persistente e recuperação semântica. O corpus experimental de memória de sessões é o complemento semântico desta pesquisa exata de transcrições.