記憶とナレッジベース利用ガイド

AI社員は自分で物事を記憶しますが、あなたの指示どおりに知識をページとして整理することもできます。この2つはダッシュボードの同じ「記憶とナレッジ」ページに表示されますが、裏側ではまったく別の2つのシステムが動いており、使い方もタイミングも異なります。このページで両方の使い方を詳しく説明します。

一言で言うと:

記憶：AI社員が自分で記録するもの。何も言わなくても、内容のある会話は自動的に要点を抽出して保存されます。
ナレッジベース：まるごと残しておく文書。定款、SOP、仕様書のような長期的な参照資料を貼り付けると自動的に1ページへ整理されます。「ナレッジベースに記録して」と明示的に伝えることもできます。ナレッジベースはwikiと同じもので、呼び方が違うだけです。

1. 両者の違い

	記憶	ナレッジベース（wiki）
蓄積のされ方	自動的に蓄積、指示不要	定款／SOP／仕様書のような文書を貼ると自動作成；「ナレッジベースに書いて」と明示することも可能
保存形式	1件ずつの事実	1ページずつのMarkdown文書
分類方法	システムが内容からトピックを自動分類	ディレクトリ（フォルダ）＋あなたが指定するページパス
古い情報の扱い	同じ事実の新バージョンが自動的に置き換わり、履歴は保持される	ページ全体を上書き；自動作成されたページはページ末尾に1行の改訂履歴を残す（2.4参照）、手動作成のページには残らない
思い出されるタイミング	3種類が自動的に注入される、それ以外は能動的に調べる必要あり	L0/L1は毎回自動注入、L2/L3は能動的な検索が必要
閲覧できる範囲	このAI社員だけ	個人ナレッジベースは本人のみ；共有ナレッジベースは全社員が閲覧可能
向いている内容	会話中にふと出てくる断片的な事実・好み・決定事項	返品ルール、見積もりフロー、製品仕様など長期的に参照する内容

選び方はシンプルです。検索できる、編集できる、他人に見せる必要がある内容はナレッジベースへ。それ以外は記憶に任せておけばよい。

2. ナレッジベースの使い方

2.1 ページの作成：会話でそのまま伝える

ダッシュボードを開いて編集する必要はなく、構文を覚える必要もありません。接続済みの任意のチャネル（LINE／Telegram／Discord／Slack／Web チャット）でAI社員にこう伝えるだけです。

幫我把退貨規則記到知識庫：七天內未拆封可退，運費由買方負擔。

今天查到的三篇論文重點整理成一頁放知識庫，標題叫「RAG 檢索方法比較」。

AI社員は1つのMarkdownページを作成し、インデックス _index.md を自動更新し、_log.md に1件の操作記録を残します。

「ナレッジベース」と言わなかったらどうなるか？ 内容次第です。貼り付けた内容が定款、標準作業手順、仕様書、規程のような長期的な参照資料であれば、AI社員が自分で判断してページを作成します（2.4参照）。通常の会話、質問、その場限りの指示は記憶としてのみ保存されます。この判断は保守的です。雑談を文書化してしまうより、ページを作らずあなたにもう一言頼ませるほうを選びます。「ナレッジベースに記録して」と明示すれば常に有効です。この経路は変わっていません。

2.2 分類：自動選択、または指定可能

すべてのナレッジベースにはデフォルトで4つのディレクトリがあり、AI社員は書き込み時に内容から自動で選びます。

ディレクトリ	保存する内容	例
`entities/`	人物、企業、製品、顧客	`entities/wang-ming.md`
`concepts/`	ドメイン概念、プロセス、原則	`concepts/return-policy.md`
`sources/`	一次資料の要約	`sources/2026-07-30-rag-papers.md`
`synthesis/`	複数トピックにまたがる分析・比較・傾向	`synthesis/vendor-comparison.md`

自分で指定したいときは「concepts/ の下に、ファイル名は return-policy で」のように伝えます。指定がなければ上表のとおりに分類され、ファイル名はkebab-caseになります。

2.3 レイヤー：ページが「どれだけ思い出されるか」を決める

すべてのページのYAML frontmatterには layer フィールドがあり、これがナレッジベース全体で最も重要な設定です。

レイヤー	値	動作
L0 Identity	`identity`	毎回の会話に自動注入
L1 Core	`core`	毎回の会話に自動注入
L2 Context	`context`	自動注入されない、検索時のみ使われる
L3 Deep	`deep`	自動注入されない、検索時のみ使われる（デフォルト）

layer が指定されていないページは一律L3扱いになります。「書き込んだのに使われている様子がない」ページの多くは、L3のまま止まっているケースです。毎回思い出させたいときは、会話で「このページをコア層に設定して」または「layer を core にして」と伝えてください。

すべてのページには trust（0.0〜1.0の信頼度スコア）もあり、検索順位はこのスコアで重み付けされるため、人手でレビュー済みの内容が上位に来ます。

2.4 自動作成：何も言わなくても進むルート

文書を貼り付け、AIが「了解しました、記録しました」と返す。これまでは、それだけで何も残りませんでした。今はまず、そのテキストが長期的な参照資料かどうかを判断し、そうであれば自動的に1ページへ整理します。

判断基準（すべて満たしたときのみ作成、あえて高めのハードルに設定）：文書性のある名詞（定款、規程、規範、SOP、仕様書、マニュアル…）、条項番号や箇条構造、十分な長さ、タイトル行。逆に、一人称の好み（「私は〜が好き」）、時限的な依頼（「明日リマインドして」）、連続した質問はすべて減点対象になり、文書としては扱われません。

自動作成されたページの保存先：このAI社員自身のナレッジベース内、auto/ の下にタイプ別で5つのディレクトリに分かれます。定款 auto/charter/、手順 auto/sop/、仕様 auto/spec/、規程 auto/policy/、その他 auto/reference/。あなたが手動で整理するディレクトリ（entities/、concepts/、sources/、synthesis/）に自動作成が触れることは決してありません。

自動作成ページと確認済みページの違い：

ページの冒頭に、これが自動整理されたもので人の確認を経ていない旨の注記が入ります。
内容は原文をそのまま保持し、書き換えられることはありません（定款や契約書のような文書は、文言が変わることの代償が大きすぎるためです）。
会話に自動注入されることは一切ありません。 自動作成ページはL2 Contextレイヤーに留まるため、AIが能動的に検索しなければ見えません。判断を誤っても、毎回の回答が汚染されることはありません。
検索順位の重みも、人手で書いたページよりはるかに低く設定されます。

同じ文書を2回目に貼った場合は同じページが更新されるだけで、2つ目のページは作られません。末尾の「改訂履歴」に1行追加されます。

管理場所：ダッシュボード「記憶とナレッジ → キュレーション → 自動作成」。各ページで次の操作ができます。

操作	効果
表示	ページ全体の内容と改訂履歴を確認
正式な知識として承認	このページが承認済みコンテンツに昇格し、毎回自動的に会話へ注入されるようになる
共有ナレッジベースへ共有	共有エリアへ複製し、他のAI社員も読めるようにする
削除	ナレッジベースから消え、アーカイブへ移動する（復元可能）

自動作成を完全に無効化したい場合：そのAI社員のナレッジベースディレクトリに .scope.toml を置き、[namespaces.auto] mode = "operator_only" を宣言します。これ以降は手動での書き込みのみが通ります。

2.5 個人ナレッジベースと共有ナレッジベース

個人ナレッジベース：~/.duduclaw/agents/<社員>/wiki/、このAI社員だけが読めます。
共有ナレッジベース：~/.duduclaw/shared/wiki/、全社のAI社員が読めます。社内規程、共通SOP、製品仕様はここに置きます。

共有エリアに書き込みたいときは明示的に伝えます。「これは共有ナレッジベースに置いて、みんなが見られるようにして」のように。

パーソナル版はナレッジベースが1つしかないため、ダッシュボードに「個人／共有」タブの切り替えは表示されません。

3. ナレッジベースがいつ使われるか

ここが最も誤解されやすい部分です。取得経路は2種類あります。

自動注入（L0 + L1）：会話が始まるたびに、システムはIdentityレイヤーとCoreレイヤーのページを現在の質問との関連度で並べ替え、6 KBの予算内でシステムプロンプトに詰め込みます。同じ会話セッション内では、選ばれたページは15分間固定され、変わりません。こうすることでprompt cacheが効きます。あなたは何もする必要がありません。

能動検索（L2 + L3）：それ以外のページは、AI社員自身が「この質問はナレッジベースを調べるべきだ」と判断し、検索ツールを呼び出すことに依存します。検索は全文検索で、信頼度スコアと情報源の種類で重み付けされます。

では、こちらから念押しすべきか？ 通常は不要です。L0/L1の内容は毎回AI社員に見えていますし、L2/L3の内容も、質問にキーワードが含まれていれば大抵は自分から調べに行きます。

念押しする価値があるのは次の2つの場合です。

回答が間違っている、あるいは曖昧なとき、かつナレッジベースに正しい答えがあると分かっているとき → 「ナレッジベースを調べてから答えて」と伝えます。
質問の言い回しがページの言い回しとかけ離れているとき（例えば、ページには「返品ポリシー」と書いてあるのに「これいらなくなったらどうすればいい？」と聞く場合）→ ページ名を直接伝えるのが一番早い方法です。

4. 記憶の使い方

4.1 自動的に記憶される内容

ソース	記憶する内容	ダッシュボード上の分類
会話蒸留	実質的な会話中の事実、決定、好み	内容に応じて「仕事／顧客／好み」（工作／客戶／偏好）に分類
キーファクト	複数の会話にまたがって繰り返し出てくる要点	「観察とインサイト」（觀察洞察）タブ
学習シグナル	期待と実際の結果のズレ（回答の出来を示す）	「学習シグナル」（學習訊號）
利用フットプリント	アプリの利用時間とアクティブな時間帯（オプトイン）	「利用フットプリント」（使用足跡）
ミス汎化	同種のミスが積み重なって導き出されたルール	「ルールと意思決定」（規則與決策）

記憶されないもの：挨拶、「了解」「OK」のような短い相づち、実質的な内容のない雑談。コストゼロの分類器がまずこれらを除外します。

重複も二度と記憶されません（v1.53以降）：セマンティック層への新しい書き込みは、まず既存の記憶と類似度を比較され、ほぼ同じ内容であれば書き込みが拒否されテレメトリとして記録されます。これにより、同じ事実が何十件もの近似記憶として積み重なり検索品質を薄めることを防ぎます。既存の記憶への通常の更新（言い直しによる置き換え、再確認）はこの影響を受けません。あなたがダッシュボードで手動整理する記憶もこのゲートを通りません。無効化したい場合は config.toml に [memory] novelty_gate = false を設定します（デフォルトは有効）。

4.2 いつ思い出されるか

3種類の内容が毎回の会話でシステムプロンプトに自動注入されます。

あなたに関するキーファクト（プライベートな会話でのみ注入。グループで共有されるセッションではブロックされ、個人情報が公開の場に持ち込まれるのを防ぎます）
過去に犯したミス（未解決の同種のミス）
学習済みルール（ミスから汎化され、観察期間を通過したルール、最大3件。v1.53以降、実際のツール実行の証拠が伴うミス記録のみが汎化の対象になります。AI社員が「それは自分のミスだった」と自己申告しても、対応するツール記録が見つからなければルール生成には使われません）

それ以外の記憶は、AI社員が必要と判断して検索を実行する必要があります。検索順位は関連度、重要度、「最後に思い出されてからの経過時間」を総合的に見ており、頻繁に参照される記憶ほど長く生き残ります。

4.3 記憶は自動的に更新される

同じテーマについて新しい発言があると、古いほうは「取って代わられた」とマークされ、新しいほうに引き継がれます。どの記憶を展開しても完全な置き換えチェーンを確認でき、「ある時点での答えは何だったか」を調べることもできます。そのため、言い直すときに古いものを先に削除する必要はなく、新しいことをそのまま伝えるだけで構いません。

4.4 記憶の削除

記憶一覧で任意の項目にマウスを乗せると右側にゴミ箱アイコンが現れ、2回クリック（2回目が確認）すると削除されます。削除された記憶は検索、閲覧、会話への注入から即座に消えます。

内部的には論理削除です。データはアーカイブテーブルへ移動し、管理者はデータベースから復元できますが、保持期間を過ぎると完全に消去されます。

5. どちらを使うべきか

やりたいこと	方法
短い返答を好むことを覚えさせたい	そのまま伝える。自動的に記憶される
毎回同じ返品ポリシーに従わせたい	ナレッジベースに書き、`layer: core` を設定する
今日調べた論文の要点を整理したい	ナレッジベースに書き、`sources/` に置く
全社のAI社員が従うべき規程	共有ナレッジベースに書く
覚え違いを訂正したい	正しい内容を伝えるだけ。古いものは自動的に置き換わる
誤った記憶を1件削除したい	記憶一覧でマウスを乗せてゴミ箱アイコンをクリック
ある文書全体を忘れさせたい	ナレッジベースからそのページを削除する
会社の定款を貼って後で調べられるようにしたい	そのまま貼るだけで自動作成される。キュレーションで正式な知識として承認すれば毎回注入される
自動作成されたページを1件削除したい	キュレーション → 自動作成 → 削除

6. よくある質問

Q：ナレッジベースとwikiは別物ですか？ 同じものです。インターフェース上は「ナレッジベース」と表示されますが、内部のファイル構造とMCPツール名は引き続き「wiki」を使っています。

Q：AI社員に「ナレッジベースに書いて」と言う必要はありますか？ 定款、SOP、仕様書のような文書であれば不要です。自動的に作成されます（2.4参照）。それ以外の場合は伝える必要があります。判断に迷うときは作成しない方向に傾くため、確実にページを残したいなら明示的に伝えるのが一番早い方法です。

Q：ナレッジベースは分類できますか？それとも自動分類ですか？ 両方成り立ちます。4つのデフォルトディレクトリは内容から自動的に選ばれますが、パスを自分で指定することもできます。レイヤー（L0〜L3）はデフォルトでL3ですが、明示すれば変更できます。

Q：どんなときにナレッジベースが使われますか？念押しは必要ですか？ L0/L1は毎回の会話に自動注入され、L2/L3はAI社員が自分で検索するかどうかに委ねられます。通常は念押し不要です。回答が間違っているときや言い回しが大きくずれているときは「ナレッジベースを調べて」と一言伝えるのが最も効果的です。

Q：記憶とナレッジベースの内容が重複したらどうなりますか？ ナレッジベースが優先されます。内容を注入する際にシステムが重複を確認し、すでにナレッジベースのページに含まれている事実は記憶から重ねて注入されません。

Q：記憶は際限なく増え続けますか？ いいえ。長期間思い出されず重要度の低い記憶は徐々にアーカイブされていきます。頻繁に参照される記憶は残り続けます。