Confira o orçamento realmente utilizado
A resposta informa used_items e used_tokens, separando uma resposta realmente pequena de uma resposta truncada.
recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })Ferramenta MCP pública
recall_context
Finalidade
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.
Quando usar
- Restaure o contexto de projeto, tarefa e agente necessário para continuar o trabalho entre sessões.
- Monte várias memórias relacionadas para construir um prompt dentro de um limite explícito de itens e tokens.
- Use no início da sessão ou da tarefa quando um único resultado rápido não for suficiente.
Quando NÃO usar
- Não use para uma consulta rápida e tolerante; use recall.
- Não use quando somente uma correspondência estrita e direcionada deve ser aceita; use search_memory.
- Não solicite uma exportação de histórico sem limite; max_items e max_tokens protegem o orçamento e a qualidade do contexto.
- 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 limites de escopo, bucket, equipe e agente continuam sendo aplicados pelo servidor.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
query | string · obrigatório | Consulta em linguagem natural para a qual o pacote de contexto é montado. |
max_items | integer · padrão: 8 | Número máximo de memórias no pacote (1-50). |
max_tokens | integer · padrão: 1500 | Tamanho máximo do contexto renderizado em tokens (1-12000). |
Esquema de retorno
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).
Exemplos
recall_context({
query: "recent decisions on the memory-os project",
max_items: 6,
max_tokens: 1200
})Erros
- 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.
Ferramentas relacionadas
- recall — Escolha o caminho leve de melhor esforço para uma resposta rápida.
- search_memory — Escolha correspondência estrita quando resultados fracos forem inseguros.
- remember — Persista novo contexto duradouro depois que a política de captura o aprovar.