# recall_context

Restaure o contexto recente do projeto e do agente necessário para continuar o trabalho entre sessões.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/recall-context
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 0767dc0a1fcb4e59857a76cce464ac0c81e3dccf483200c4310a35325dccee22
- Edition-Digest: e86e120527c787e751a4d102c4f0b9ec132b947b2ca3fb0c9494ddef03505c83
- Source-Revision: sha256:0000db16929d847dd06d0f100593276843962eb54fb925e1a5f66997e039974c

## Tool Reference: `recall_context`

### Purpose

Leia um pacote de contexto com várias memórias dentro de limites, com itens estruturados e texto sujeito a orçamento de tokens; nada é alterado.

### Parameters

- `query` (string, required): Consulta em linguagem natural para a qual o pacote de contexto é montado.
- `max_items` (integer, optional, default: 8): Número máximo de memórias no pacote (1-50).
- `max_tokens` (integer, optional, default: 1500): Tamanho máximo do contexto renderizado em tokens (1-12000).

### Returns

O perfil MCP público retorna texto, não um objeto estruturado. Ele começa com um cabeçalho '### XMemo Context' e uma linha 'Items: <n>', adiciona uma linha 'Budget: ...' quando resultados são descartados ou encurtados, depois uma linha por item no formato literal 'Reference: <id> | Type: <type> | Location: <path>' e, por fim, o rótulo 'Context:' seguido do corpo de contexto limitado. Quando nada corresponde, informa 'No matching XMemo memory was found.'. Trate a referência como um identificador opaco. Perfis não públicos podem retornar o pacote estruturado (version, retrieval_plan, budget, items, context_text).

### Errors

- 401/403: a solicitação não possui memory:read ou, quando aplicável, a capacidade de leitura de memória temporária.
- 422: max_items, max_tokens ou um limit explícito está fora dos limites de orçamento ou de candidatos aceitos.
- Falha de validação: query ou um dos filtros opcionais está malformado.

### Examples

#### Restaure o contexto antes de uma tarefa



```typescript
recall_context({
  query: "recent decisions on the memory-os project",
  max_items: 6,
  max_tokens: 1200
})
```

### Related Tools

- [recall](/docs/tools/recall): Escolha o caminho leve de melhor esforço para uma resposta rápida.
- [search_memory](/docs/tools/search): Escolha correspondência estrita quando resultados fracos forem inseguros.
- [remember](/docs/tools/remember): Persista novo contexto duradouro depois que a política de captura o aprovar.

## Confira o orçamento realmente utilizado

A resposta informa used_items e used_tokens, separando uma resposta realmente pequena de uma resposta truncada.

```ts
recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })
```