시작하기가이드메모리 수정

Concept

메모리 수정

버전이 관리되는 update 경로로 영구 레코드를 수정하고 provenance와 conflict 신호를 보존합니다.

모순을 덧붙이지 말고 레코드를 수정하세요

수정은 PATCH /v1/memories/{memory_id}를 통해 기존 메모리를 변경합니다. MemoryUpdateRequest의 모든 필드는 선택 사항이며 content, path, metadata, source, provenance, memory_type, status, expires_at, scope, team_id가 포함됩니다. 따라서 수정 사항은 동일한 memory reference에 연결되고 서버가 versioning 경로를 적용할 수 있습니다.

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
}

버전 및 conflict 제어는 요청의 일부입니다

update contract에는 merge_metadata, merge_provenance, detect_conflicts가 포함되며 모두 기본값은 true이고 supersession_reason도 있습니다. persistence 경로는 memory version을 증가시키고 public memory contract에 status/superseded_by/conflict evidence를 보존합니다. 반환된 implementation data를 현재 결과로 읽되, OpenAPI response는 typed가 아닙니다.

  • 수정으로 기존 evidence를 유지해야 한다면 metadata와 provenance를 merge하세요.
  • 동시 수정이나 경쟁 버전이 중요하면 detect_conflicts를 활성화된 상태로 유지하세요.
  • 수정이 이전 버전을 의도적으로 대체한다면 supersession_reason을 사용하세요.

수정된 scope 확인하기

수정 후 scoped read를 수행하고 반환된 version, status, provenance 및 conflict field를 확인하세요. Retrieval은 인증된 scope와 memory status filter를 계속 따릅니다. PATCH 성공만으로 의도한 scoped 결과가 현재 표시된다는 증거가 되지는 않습니다.

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

페르소나 흐름

ChatGPT 사용자

채팅에 전달자 토큰을 붙여넣지 않고도 XMemo 기본 설정, 프로젝트 사실, 결정 및 TODO에 대한 지속 가능한 액세스를 ChatGPT에 부여하세요.

종합 기본 설정이나 프로젝트 노트를 저장하고 새 채팅을 시작한 다음 작업을 계속하기 전에 XMemo를 통해 ChatGPT에 이를 불러오도록 요청하세요.

부조종사/Codex 개발자

IDE와 CLI 에이전트 간에 리포지토리 결정, 코딩 규칙, 버그 수정 메모, 작업 기록을 전달합니다.

코드베이스 결정이나 버그 수정을 기록한 후 편집하기 전에 다음 IDE 또는 CLI 에이전트에게 관련 XMemo 컨텍스트를 기억하도록 요청하세요.

팀/엔터프라이즈 파일럿 소유자

계정 제어, 소스 속성, 내보내기/삭제 워크플로, 검토자에게 안전한 설정 증거를 통해 공유 메모리를 평가합니다.

파일럿 멤버에게 가상 팀 메모리를 저장하고 XMemo에서 소스 속성을 확인한 다음 삭제/내보내기 및 지원 경로를 검토하도록 합니다.

출처: Memory Console 컨트롤