메모리를 변경하기 전에 미리 보기
dry_run=true를 사용해 다섯 가지 제공 reflection action, 각 count 및 candidate 세부 정보를 확인한 후 summary, promotion, expiry, decay 또는 archive write를 허용합니다.
공개 MCP 도구
reflect
목적
bounded Dream/Reflection maintenance pass를 실행하여 consolidation 및 memory-lifecycle 결정을 보고하고, 선택적으로 지정된 write를 적용합니다.
사용 시점
- authorized operator 또는 maintenance worker가 최근 episodic memory를 semantic reflection record로 요약해야 할 때 사용합니다.
- 반복된 episodic evidence를 검토한 뒤 durable semantic fact로 만들지 결정해야 할 때 사용합니다.
- authorized owner/team/scope 경계에서 명시적이고 제한된 expiry, importance-decay 또는 archive pass가 필요할 때 사용합니다.
사용하지 않을 시점
- 일반적인 사용자 요청 durable fact에는 사용하지 않습니다. remember 또는 SDK capture helper를 사용합니다.
- general search, context-recall 또는 hard-delete 도구로 사용하지 않습니다. recall_context, search_memory 또는 governed forget surface를 사용합니다.
- caller가 candidate만 평가하거나 memory를 변경할 명시적 권한이 없을 때 dry_run을 생략하지 않습니다.
- 이 도구를 더 넓은 Light/REM/Deep Dream design이나 autonomous scheduler로 설명하지 않습니다. 제공되는 surface는 이 다섯 가지 action뿐입니다.
필수 스코프
- dry_run=true에는 memory:read가 필요하고 write run에는 memory:write가 필요합니다.
- catalog는 reflect를 minimal public marketplace-app tool이 아닌 internal maintenance surface로 분류합니다. authorized maintenance 또는 direct MCP context에서만 사용합니다.
- owner, bucket, scope, team, bound-space 및 agent authorization은 server가 확인하며 caller filter는 그 경계를 넓힐 수 없습니다.
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
actions_csv | string · 기본값: summarize,promote,expire,decay,archive | 쉼표로 구분한 action입니다. 제공되는 action은 summarize, promote, expire, decay 및 archive이며 summary, promotion, expiry 및 importance_decay 같은 alias는 compactor가 normalize합니다. |
dry_run | boolean · 기본값: false | true이면 consolidation 또는 lifecycle write 없이 candidate와 count를 계산합니다. review에는 이를 우선합니다. |
time_window_hours | number · 기본값: 24.0 | episodic summarize/promote 선택에 사용하는 양수 lookback window이며, 지정하면 since가 이를 대신합니다. |
since / until | string · 기본값: empty | reflection window의 선택적 ISO 8601 경계이며, 잘못된 timestamp는 거부됩니다. |
path_filter / owner_filter | string · 기본값: % / authenticated owner | logical path와 owner filter입니다. server가 owner filter를 인증된 context에 맞춰 확인합니다. |
bucket / scope / team_id | string · 기본값: % / empty / empty | 선택적 memory boundary filter이며, 명시한 team_id는 bound/authenticated team context와 일치해야 합니다. |
limit | integer · 기본값: 500 | compactor에 전달하는 최대 candidate budget이며 implementation이 지원 범위로 제한합니다. |
반환 스키마
compactor는 dry_run, normalized actions, filters, summaries, promotions, lifecycle details, counts.summarized/promoted/expired/decayed/archived 및 audit_record_ids가 있는 report를 만듭니다. MCP text response는 '### Memory Reflect Report'로 시작하며 Dry Run, Actions, 다섯 가지 count, Audit Records 및 처음 20개의 Audit ID까지 표시합니다.
예제
reflect({
actions_csv: "summarize,promote,expire,decay,archive",
dry_run: true,
time_window_hours: 24,
limit: 500
})reflect({
actions_csv: "archive",
dry_run: false,
bucket: "personal",
limit: 100
})오류
- 401/403: caller가 dry_run에 필요한 read scope 또는 mutating run에 필요한 write scope가 없거나 요청한 owner/team/bound space가 승인되지 않았습니다.
- Validation failure: action이 지원되지 않거나 time_window_hours가 양수가 아니거나 since/until이 ISO 8601이 아니거나 boundary/limit 값이 유효하지 않습니다.
- Team authorization failure: 권한이 없는 team lifecycle mutation은 조용히 적용하지 않고 거부합니다.
- Concurrency or audit failure: memory가 변경되었거나 status transition이 완료되지 않았거나 consolidation audit가 실패하면 rollback하거나 error로 보고합니다.
관련 도구
- recall_context — maintenance가 필요한지 결정하기 전에 bounded context pack을 읽습니다.
- remember — consolidation pass 없이 명시적으로 요청된 durable fact 하나를 저장합니다.
- search_memory — lifecycle maintenance가 아니라 retrieval이 필요할 때 승인된 memory를 검색합니다.