Restrinja uma busca que retorna resultados demais
Adicione os filtros de escopo e path antes de aumentar o limite; um limite maior em uma consulta sem escopo retorna mais ruído, não mais sinal.
search_memory({
query: "token identity fallback",
limit: 5
})Ferramenta MCP pública
search_memory
Finalidade
Pesquise memórias autorizadas do XMemo com semântica estrita de correspondência direcionada, para que correspondências fracas não sejam tratadas silenciosamente como resposta.
Quando usar
- O chamador conhece o projeto, a equipe, o path ou o tipo de memória relevante e precisa de uma consulta direcionada.
- Uma correspondência semântica fraca seria enganosa ou insegura como resultado.
- Você precisa de filtros explícitos de escopo/equipe, explicações da recuperação ou de um conjunto maior de resultados controlado.
Quando NÃO usar
- Não use para uma consulta rápida, tolerante e sem escopo; use recall.
- Não use para montar um pacote de contexto com várias memórias para um prompt; use recall_context.
- Não use para alterar ou remover uma memória.
- A API REST aceita um conjunto de campos mais amplo que a ferramenta MCP pública; consulte /docs/api/memory para os filtros de scope, bucket, team e provenance.
Escopo necessário
- memory:read é obrigatório; os filtros de scope e team_id não podem ampliar o limite de autorização do chamador.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
query | string · obrigatório | Tópico ou redação exata a ser correspondida. |
limit | integer · padrão: 5 | Quantidade de resultados. |
path_filter | string · padrão: % | Somente no perfil de plugin do Claude: filtro ILIKE de caminho lógico. Não é aceito no perfil público genérico. |
memory_type | string · padrão: % | Somente no perfil de plugin do Claude: filtro de tipo de memória. Não é aceito no perfil público genérico. |
prefer_working | boolean · padrão: false | Somente no perfil de plugin do Claude: coloque o estado de trabalho ativo antes dos resultados vetoriais. |
Esquema de retorno
Uma resposta de texto classificada com referências opacas, localizações, conteúdo e metadados opcionais de explicação ou limite do agente. O resultado continua limitado às memórias autorizadas.
Exemplos
search_memory({
query: "token identity fallback",
limit: 5
})Erros
- 401/403: a solicitação não possui memory:read ou não pode acessar o escopo/equipe selecionado.
- Falha de validação: query, limit, padrão de path ou tipo de memória é inválido.
- Resposta sem correspondência: nenhum resultado forte satisfaz o alvo e os filtros autorizados; os chamadores não devem substituir silenciosamente a semântica de recall.
Ferramentas relacionadas
- recall — Use recuperação tolerante baseada no melhor esforço quando a correspondência estrita não for necessária.
- recall_context — Use recuperação limitada de várias memórias para contexto de prompt.
- forget — Remova um registro exato somente depois de revisar a referência retornada.
Origem: Superfície de ferramentas MCP