ComeçarGuiasCorreção de memória

Concept

Correção de memória

Corrija um registro duradouro pelo caminho de atualização versionado, preservando a proveniência e os sinais de conflito.

Corrija o registro; não acrescente uma contradição

Uma correção altera a memória existente por meio de PATCH /v1/memories/{memory_id}. MemoryUpdateRequest torna todos os campos opcionais e inclui content, path, metadata, source, provenance, memory_type, status, expires_at, scope e team_id. Assim, a correção permanece associada à mesma referência de memória e o servidor pode aplicar seu caminho de versionamento.

PATCH /v1/memories/<memory-id>
X-API-Key: <your-assigned-api-key>
Content-Type: application/json

{
  "content": "The corrected deployment decision was verified on 2026-09-02.",
  "provenance": {
    "correction": "owner-confirmed"
  },
  "merge_provenance": true,
  "detect_conflicts": true
}

Versionamento e controles de conflito fazem parte da requisição

O contrato de atualização inclui merge_metadata, merge_provenance e detect_conflicts, todos com valor padrão true, além de supersession_reason. O caminho de persistência incrementa a versão da memória e mantém status/superseded_by/evidências de conflito no contrato público de memória; leia os dados de implementação retornados como resultado atual, enquanto a resposta OpenAPI continua sem tipagem.

  • Mescle metadados e proveniência quando a correção deve manter as evidências existentes.
  • Mantenha detect_conflicts habilitado quando edições concorrentes ou versões conflitantes forem relevantes.
  • Use supersession_reason quando a correção substituir intencionalmente uma versão anterior.

Verifique o escopo corrigido

Depois de uma correção, faça uma leitura com escopo e examine os campos de versão, status, proveniência e conflito retornados. A recuperação continua seguindo o escopo autenticado e os filtros de status da memória; um PATCH bem-sucedido, por si só, não prova que o resultado no escopo desejado está visível.

GET /v1/memories/search?query=corrected%20deployment%20decision&scope=memory-os&status=active&limit=5
X-API-Key: <your-assigned-api-key>

Fluxos de personas

Usuário do ChatGPT

Dê ao ChatGPT acesso duradouro às suas preferências do XMemo, fatos do projeto, decisões e TODOs sem colar tokens bearer no chat.

Salve uma preferência de teste ou anotação de projeto, inicie um novo chat e peça ao ChatGPT para recuperá-la via XMemo antes de prosseguir.

Desenvolvedor Copilot / Codex

Transfira decisões do repositório, convenções de código, notas de correção de bugs e histórico de tarefas entre agentes de IDE e CLI.

Registre uma decisão da base de código ou correção de bug e peça ao próximo agente de IDE ou CLI para recuperar o contexto relevante do XMemo antes de editar.

Líder de piloto de equipe / corporativo

Avalie a memória compartilhada com controles de conta, atribuição de origem, fluxos de exportação/exclusão e evidências de configuração seguras para revisores.

Peça para um membro do piloto salvar uma memória de equipe de teste, confirme a atribuição de origem no XMemo e revise os caminhos de exclusão/exportação e suporte.

Origem: API de memória