# search

Pesquise na memória autorizada quando a redação ou o registro relevante não for conhecido de antemão.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/search
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: e4c087a8f0e12c7c67bbf556d6d2f73b0e61a736a9b8686e77e1b181a14238a7
- Edition-Digest: b574aba6237b5720a93da1860f579ac23eec3ab1ad14e44573cd5e3c90e8cb30
- Source-Revision: sha256:0f9b76db3972abc862d49a83f61e83eed6529dc4507a3c290949f892dcaa48f9

## Tool Reference: `search_memory`

### Purpose

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.

### Parameters

- `query` (string, required): Tópico ou redação exata a ser correspondida.
- `limit` (integer, optional, default: 5): Quantidade de resultados.
- `path_filter` (string, optional, default: %): 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, optional, default: %): 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, optional, default: false): Somente no perfil de plugin do Claude: coloque o estado de trabalho ativo antes dos resultados vetoriais.

### Returns

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.

### Errors

- 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.

### Examples

#### Consulta estrita com escopo de projeto



```typescript
search_memory({
  query: "token identity fallback",
  limit: 5
})
```

### Related Tools

- [recall](/docs/tools/recall): Use recuperação tolerante baseada no melhor esforço quando a correspondência estrita não for necessária.
- [recall_context](/docs/tools/recall-context): Use recuperação limitada de várias memórias para contexto de prompt.
- [forget](/docs/tools/forget): Remova um registro exato somente depois de revisar a referência retornada.

## 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.

```ts
search_memory({
  query: "token identity fallback",
  limit: 5
})
```