Overview
Use governed memory instead of unreviewed vector memory for persistent agent facts.
Facts carry scope, subject, trust level, source, approval state, and lifecycle state.
Capabilities can recall only facts that satisfy trust and scope rules. Pending facts stay out of normal recall until approved.
Memory policies let teams define evidence requirements, approval thresholds, conflict handling, supersession, recall limits, and forget behavior for a subject type.
Memory can be written through SQL, SDK helpers, or the memory JSON API. Prefer proposals when a remembered claim could affect future customer-visible decisions.
Developer notes
- Scope memory by tenant and subject.
- Keep pending memory out of normal recall.
- Use handles-only recall when a capability only needs evidence references.
- Retire stale facts instead of silently overwriting them.
- Use forget only for deletion/removal cases that should no longer appear in replayable memory lookup.
- Record source evidence and approval reason for every persistent claim.