概要

Q&A の 4 つの状態、公開状態と同期ステータスの違い、2 つの管理ページの役割分担

ナレッジベースでは、よくある質問、注意事項、ポリシーなどの Q&A を管理します。各 Q&A は質問、回答、カテゴリの 3 つの必須項目からなり、タグと参考リンクも追加できます。

追加・編集しただけでは反映されません

保存すると下書きとして書き込まれるだけです。Q&A は同期してはじめて検索インデックスに入り、チャットで見つかるようになります。

2 つのページの役割分担

ページ	パス	担当
一覧ページ	`/knowledge-base`	閲覧、絞り込み、一括操作、インポート、状態の切り替え
編集ページ	`/knowledge-base/{id}/edit`	1 件ずつの内容の編集、AI による補助、削除

同期、公開、非公開の 3 つの操作は、どちらのページでもできます。一覧ページは複数件をまとめて処理するのに、編集ページは内容を直したついでに同期するのに向いています。

「同期ステータス」列には、その Q&A と検索インデックスの関係が表示されます。

状態	表示	意味
下書き	下書き	管理画面にだけあり、まだ検索インデックスが作られていません
インデックス作成済み	同期未完了	一括同期が途中で完了しませんでした。一括処理を再実行する必要があります
同期済み	同期済み	インデックスが作成され、内容も最新です
変更あり	要再同期	同期したあとに内容を変更したため、インデックスが古いままです

このほか特別なケースとして、ゴールデン質問テンプレートを適用して作った Q&A は、回答を入力するまで 回答待ち と表示され、同期できません。

「同期未完了」の状態になるのは、一括同期が中断した場合だけです。1 件ずつの操作でこの状態になることはありません。この状態になったら一括同期を再実行してください。1 件ずつの同期では解消しません。

一覧ページには、混同しやすい 2 つの列があります。

Q&A は「同期済み」でも「非公開」になり得ます。インデックスはあっても、意図的に検索されないようにしている状態です。Q&A を削除せずに一時的に使わないようにしたいときは、非公開にします。

下書きは公開中になりません

公開状態が「公開中」になるのは、インデックスが作成済み、同期済み、非公開にされていない、の 3 つがそろったときです。下書きは、一度も非公開にしていなくても常に非公開と表示されます。そもそも検索されるインデックスがないためです。

回答が上限を超える場合は、編集ページの「分割案を生成」で、AI が長い回答を複数の独立した Q&A に分ける案を作ります。

管理画面での操作のほかに、外部の AI ツール（Claude Code、Codex、claude.ai など）から MCP で接続してナレッジベースを管理することもできます。 Q&A、カテゴリ、タグの照会、下書きの作成・変更・削除、同期、公開・非公開ができます。

外部ツールが接続するときにはキーが必要で、MCP サーバーキーページで発行します。発行時に、そのキーで使える機能を限定できます。たとえば、AI ツールには下書きの作成だけを許可し、同期するかどうかは人が決める、といった使い方です。 MCP で同期した内容も、同期前の内容審査を受けます。