Memory Explorer
Document ID: DASH-004
File Path: docs/10-dashboard/memory-explorer.md
Version: 1.0.0
Status: Draft
Owner: AI Platform Team
Last Updated: 2026-06-27
1. Purpose
Section titled “1. Purpose”This document specifies the Memory Explorer — the UI for browsing, searching, inspecting, and managing agent memory. It is the visual front end over the Memory (Management) API and the Memory Engine.
2. Surfaces
Section titled “2. Surfaces”| View | Purpose |
|---|---|
| Namespaces | Browse/manage namespaces and retention |
| Browser | List/filter records by type, scope, tags, tier, age |
| Search | Hybrid query with ranked, explainable results |
| Record detail | View content, metadata, versions, mentions |
| Graph view | Visualize the knowledge graph |
| Admin | Purge, reindex, export |
3. Search & Ranking Transparency
Section titled “3. Search & Ranking Transparency”The search box runs a hybrid query and shows,
for each result, the score and score_breakdown
(relevance/recency/importance). Users can
adjust ranking weights live to understand and tune retrieval.
Query → results with: title · type · scope · score (relevance/recency/importance)A degraded banner appears if retrieval fell back (e.g. vector store unavailable).
4. Record Inspection
Section titled “4. Record Inspection”For a selected record:
- Full content and metadata (tags, labels, source, confidence)
- Version history with diffs (versioning)
- Linked knowledge-graph entities and the memories that mention them
- Tier and retention status
5. Knowledge Graph View
Section titled “5. Knowledge Graph View”An interactive graph renders entities and relationships (knowledge graph):
- Click an entity to see neighbors and mentioning memories
- Expand N hops; filter by relationship type
- Trace paths between two entities
The view is bounded (max nodes) to stay responsive, mirroring the engine’s traversal limits.
6. Management Actions
Section titled “6. Management Actions”| Action | API |
|---|---|
| Edit/delete a record | PATCH/DELETE /memory/records |
| Purge by filter | :purge |
| Reindex namespace | :reindex (async) |
| Export | :export |
Destructive and admin actions require elevated scope and confirm dialogs; reindex and export surface as operations with progress.
7. Governance & Privacy
Section titled “7. Governance & Privacy”- Only records within the user’s scopes are visible.
- PII-tagged content is masked unless the user has the required scope.
- Exports are audited with the filter used.
8. Cost & Footprint
Section titled “8. Cost & Footprint”The explorer surfaces namespace size, tier distribution, and embedding/index footprint so operators can manage growth and retention.
9. Dependencies
Section titled “9. Dependencies”10. Related Documents
Section titled “10. Related Documents”11. Revision History
Section titled “11. Revision History”| Version | Date | Description |
|---|---|---|
| 1.0.0 | 2026-06-27 | Initial Memory Explorer specification |