Memory Console ガイド

ユーザーの目標とコンソールの概要

Memory Console は、/me (/memory-console というエイリアスもあります) でメモリレコード、エージェント接続、プロジェクト、およびセキュリティ設定を確認、検索、管理するための視覚的な Web インターフェースを提供します。CLI コマンドや MCP ツールのみを介して操作する代わりに、開発者やチームメンバーはコンソールを使用して、エージェントが記録した内容の監査、不正確なメモリの修正、エージェント帰属の検査、API トークンの管理、データのエクスポートと削除の制御を行います。

利用資格と前提条件

Memory Console は、認証されたユーザー向けに最新のブラウザで利用できます。コンソールのレイアウトは、サイドバーナビゲーションおよび直接の URL ハッシュアンカーを介してアクセスできる個別のワークスペースセクションとアクセスセクションに機能を体系化しています:

• 認証要件: アクティブなユーザーセッションが必要です。未認証のアクセスは /login (サインインページ) にリダイレクトされます。
• 概要 (#overview): 個人メモリワークスペース、最近のアクティビティ、接続されたエージェント、およびストレージシグナルのクイックサマリー。
• メモリ (#memory): 全文検索、タイプフィルター、およびソースフィルターを使用したメモリレコードの検索、絞り込み、確認、および編集。
• Knowledge (#knowledge): 承認されたエージェントが参照できるナレッジドキュメントの表示と維持管理。
• プロジェクト (#projects): プロジェクトワークスペース、コンテキストノート、およびプロジェクト関連のメモリの閲覧。
• Cloud Skill (#skills): 手続き型クラウドスキルの作成、インポート、および管理。Preview バッジが表示され、アカウントで有効化されている場合に利用可能です。
• Dream (#dream): 永続メモリになる前に、定期的なパターンと統合の提案を確認。Preview バッジが表示され、アカウントで有効化されている場合に利用可能です。
• エージェント (#agents): このワークスペースに接続されているエージェントの表示、最後のアクティブタイムスタンプの確認、および権限の検査。
• チーム (#teams): チームの作成と管理、メンバーの招待、およびチームワークスペースロールの設定。Preview バッジが表示され、アカウントで有効化されている場合に利用可能です。
• プロフィール (#profile): アカウントのID、メール確認ステータス、および個人の設定。
• セッション (#sessions): アクティブなサインインセッションと接続されたデバイスの確認。
• API キー (#api-keys): CLI、エージェント、および自動化のためのスコープ付きアクセストークンの発行、ローテーション、および失効。
• 設定 (#memory-settings): プライバシー態勢、セキュリティモード、データエクスポートリクエスト、およびメモリ削除コントロール。

一連の完全なタスク: 合成メモリの検査と修正

このウォークスルーでは、クイックスタートガイド中に保存された合成規約メモリを見つけ、そのエージェント帰属を検査し、コンソールでそのテキストを修正し、更新を確認して、個人ワークスペースの境界を確かめます。

1. メモリパネルで合成メモリを見つける

/me に移動し、サイドバーで Memories をクリックするか #memory に移動してメモリパネルを開きます。検索バーに "demo project timestamp format" と入力するか、Facts カテゴリで絞り込みます。一覧には、概要コンテンツ、作成時刻、および可視性バッジを示す一致するメモリカードが表示されます。

# Access personal workspace
https://xmemo.dev/me#memory

# Access team workspace with explicit team context
https://xmemo.dev/me?space=<team_id>#memory

2. エージェントの帰属とメタデータを検査する

メモリカードをクリックして Explain パネルを展開します。コンソールには、書き込み時に取得された来歴と帰属の詳細が表示されます:

• 書き込み者の種類とエージェントID: メモリがエージェント、人間のユーザー、またはインポートされたスクリプトのいずれによって書き込まれたかが、エージェント名およびIDとともに表示されます。
• エージェントインスタンスの表示: 同じエージェントの個別の実行を区別するために、明確なエージェントインスタンス識別子 (agent_instance_display) が表示されます。
• デバイスとトランスポート: デバイスラベル (device_label) と、書き込みが送信されたトランスポートチャネルが表示されます。
• 可視性とスコープ: レコードが個人用かチーム共有 (team_id) かが、プロジェクトおよびバケットの割り当てとともに示されます。
• バージョン履歴: 現在のリビジョン番号が表示され、バージョン系統ドロワーへのリンクが表示されます。

3. メモリコンテンツをインラインで修正する

メモリカードの Edit ボタンをクリックして、インラインエディタを開きます。改良されたプロジェクト規約を反映するようにコンテンツを更新し、Save をクリックします:

• 更新されたコンテンツ: "demo project timestamp format" を "Demo project timestamps use UTC with ISO 8601 formatting." に変更します。
• 保存アクション: コンソールは CSRF 保護付きの認証済み更新リクエストを発行し、リビジョンカウンターをインクリメントします。
• 競合保護: エージェントがメモリを同時に更新した場合、コンソールはリビジョンの不一致 (HTTP 409) を検出し、上書きする前に最新のコンテンツを確認するよう "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." と促します。

4. コンソールとエージェントのリコールで更新を確認する

保存後、コンソールに成功通知が表示され、メモリカードが更新されます。バージョン系統ドロワーには、以前のリビジョンが新しいリビジョンに置き換えられたことが示されます。接続されたエージェントが修正を即座に認識することを確認するには、ターミナルで recall を実行します:

node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" --limit 1

観察可能な結果

コンソールでの修正が成功すると、Web UI およびエージェントインターフェース全体で観察可能な変化が生じます:

• Web コンソールトースト: 画面下部に確認トースト ("Memory updated") が表示されます。
• カードの表示: カードには、更新されたテキスト、更新されたタイムスタンプ、およびインクリメントされたリビジョンインデックスが即座に表示されます。
• 系統ドロワー: バージョン系統ドロワーには、以前のリビジョンと更新されたテキストを比較する単語レベルの差分が表示されます。
• エージェントリコール出力: "demo project timestamp format" に対するクエリは、最新のリビジョン参照とともに更新されたテキストを返します。

エージェントがアクセスできる範囲

エージェントとコンソールユーザーは、別個の認証および権限境界のもとで動作します:

• コンソール権限: コンソールユーザーは、CSRF 検証を伴うブラウザクッキーを介してデータにアクセスします。コンソール内のアクションは、ログインしているユーザープロフィールを反映します。
• エージェント権限: エージェントは、API キーパネル (#api-keys) で発行されたスコープ付き API キーまたは OAuth トークンを使用して認証します。許可されるトークンスコープには、memory:read、memory:write、knowledge:read、ledger:read、ledger:write、および read:audit が含まれます。
• エージェントの可視性境界: エージェントはアカウントのパスワード、アクティブなブラウザセッション、または請求の詳細を表示できません。個人トークンを発行されたエージェントは、個人のメモリと公開されたナレッジのみをクエリできます。そのチームに明示的にバインドされていない限り、チームワークスペースを検査することはできません。

共有とストレージの境界

Memory Console は、個人データとチームワークスペースの厳格な分離を強制します:

• スペースの選択: スペースセレクターは、クエリパラメータ ?space=<team_id> (useSpaceContext によって管理) を介して個人メモリとチームワークスペースを切り替えます。パラメータを省略するか ?space=personal を設定すると、表示が個人メモリに限定されます。
• 設定の分離: 設定パネル (#memory-settings) は、テナント間の設定ドリフトを防ぐために、チームスペースの閲覧時には自動的に非表示になります。チームスペースにいる間に設定を開こうとすると、アクティブなスペースが Personal にリセットされます。
• データエクスポートの境界: 設定 (#memory-settings) から、ユーザーは機密を保護したエクスポートアーカイブ (/api/v1/me/export-requests) を要求できます。個人エクスポートには、個人メモリレコード、バージョン系統、個人元帳トランザクション、および個人ドキュメントが含まれます。チームメモリは個人エクスポートから厳格に除外されます。
• エクスポートダウンロード認証: 生成されたエクスポートアーカイブは、xmemo-personal-export.zip を取得する前に一時的なダウンロード認証トークンを取得するための sudo チャレンジが必要です。エクスポート成果物はいつでも取り消して削除できます。
• メモリ削除コントロール: ユーザーは確認の上で個々のメモリを削除したり、すべてのメモリを消去したり、アカウントのメールアドレスを確認して確認フレーズ "RESET MY XMEMO MEMORY" を入力してメモリをリセットしたりできます。セルフサービスによるアカウントの閉鎖では、削除前に所有するチームを移譲する必要があります (HTTP 409)。
• TODO エントリポイント: コンソールは、プロジェクト (#projects) のプロジェクトカード内に集計カウンターとして TODO を公開し、各ワークスペースに関連付けられた未完了のアクションアイテム数を表示します。
• 元帳エントリポイント: 元帳レコードはメモリ (#memory) の下で絞り込み可能なタイプカテゴリとして表示され、API キー (#api-keys) の下で API トークン (ledger:read、ledger:write) にスコープでき、個人データエクスポートアーカイブに含まれます。

障害復旧

次の手順を使用して、一般的なコンソールエラーとアクセス問題を解決します:

• 検索でメモリが見つからない: スペースセレクターが正しいスペース (Personal 対 Team ?space=<team_id>) に設定されているか確認してください。ツールバーのアクティブなフィルタードロップダウン (Type や Visibility など) をクリアして、検索結果を広げてください。
• 同時編集エラー (HTTP 409): 編集を開いている間にエージェントまたは別のタブがメモリを更新した場合、コンソールに "CAS version conflict: Data has been updated elsewhere. Please refresh and try again." と表示されます。リストを更新し、新しいリビジョンを確認して、変更を再適用してください。
• サイドバーに設定オプションが表示されない: チームスペースを表示している場合、設定は非表示になります。サイドバーのスペースドロップダウンを開き、Personal ワークスペースに戻して、設定 (#memory-settings) へのアクセスを復元してください。
• エクスポートダウンロード認証の期限切れ: sudo ダウンロード認証トークンは短命です。ダウンロードプロンプトでアカウントの認証情報を再入力し、新しいダウンロード認証を生成してください。

関連リファレンス

基盤となるメカニズムおよび API コントラクトについては、関連する概念およびツールのドキュメントを参照してください:

• クイックスタート: 初期設定と合成メモリ作成については /docs/quickstart を参照してください。
• メモリ修正: リビジョン履歴と置換セマンティクスについては /docs/concepts/memory-correction を参照してください。
• メモリ削除: 論理削除とツームストーンのライフサイクルについては /docs/concepts/memory-deletion を参照してください。
• 来歴と帰属: エージェントインスタンスおよび書き込み者の種類の仕様については /docs/concepts/provenance-attribution を参照してください。
• プロジェクト: プロジェクトワークスペースの境界とコンテキストスコープについては /docs/concepts/projects を参照してください。
• チーム: チームワークスペースの作成、ロール、およびコラボレーションについては /docs/capabilities/teams を参照してください。
• ナレッジベース: ドキュメントベースと公開ルールについては /docs/concepts/knowledge-bases を参照してください。
• Cloud Skills: 手続き型クラウドスキルの作成については /docs/concepts/cloud-skills を参照してください。
• Dream リフレクション: パターン分析の概念については /docs/concepts/dream-reflection を参照してください。
• ガバナンスと保持: 保持ポリシーと DSAR コントロールについては /docs/concepts/governance-retention を参照してください。
• データ境界: 暗号化、マルチテナンシー、および分離については /docs/security/data-boundary を参照してください。
• TODO ツール: エージェントタスク追跡ツールのパラメータについては /docs/tools/todos を参照してください。
• 元帳ツール: 財務取引ツールのパラメータについては /docs/tools/ledger を参照してください。