> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisa de sessões

# 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`](/pt-BR/concepts/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.