# recall

Recupere contexto duradouro relevante quando um agente precisar de uma resposta focada. O recall pesquisa todas as suas memórias por padrão; na superfície completa de ferramentas MCP, passe bucket para pesquisar apenas um bucket.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/recall
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: a5f520ad1f7164b71407d71502e21638cd59fcf0e2c2b3e0226ca364286b5bb5
- Edition-Digest: 4c3ef6e2a97b7e6b69b510f5ba72be1b4584125519d42fe87a7697133bbc3b52
- Source-Revision: sha256:27b29297ea0ca25f76efcb7223face20624379ddfff4699feaaedd6ba1f0fe42

## Tool Reference: `recall`

### Purpose

Faça uma consulta leve e tolerante, baseada no melhor esforço, e retorne as poucas memórias salvas mais relevantes antes de responder.

### Parameters

- `query` (string, required): Pergunta ou tópico em linguagem natural para recuperar.
- `limit` (integer, optional, default: 5): Quantidade pequena de resultados; mantenha-a limitada para uma consulta rápida.

### Returns

Uma resposta de texto classificada contendo a referência, a localização, o conteúdo e o limite de atribuição disponível de cada memória. Resultados vazios são uma resposta válida quando não há correspondência, não um sinal de autorização.

### Errors

- 401/403: a solicitação não tem um bearer token válido ou não possui memory:read.
- Falha de validação: a sintaxe de query, limit ou dos filtros é inválida.
- Incompatibilidade de escopo ou equipe: o owner autenticado não pode visualizar o limite solicitado.

### Examples

#### Recuperação rápida baseada no melhor esforço



```typescript
recall({
  query: "current MCP authentication decision",
  limit: 3
})
```

### Related Tools

- [search_memory](/docs/tools/search): Use correspondência estrita e direcionada com filtros de projeto/equipe.
- [recall_context](/docs/tools/recall-context): Use um pacote de contexto limitado com várias memórias.
- [remember](/docs/tools/remember): Persista um fato ou uma decisão explicitamente duradoura.

## Diferencie um resultado vazio de uma falha

Um resultado vazio é uma resposta válida quando não há correspondência. Uma credencial ausente ou insuficiente falha com 401 ou 403.

```ts
recall({ query: "a topic that was never saved", limit: 3 })
// -> empty result set, HTTP 200
```