ナレッジエディターの使い方

ナレッジエディターの使い方

URL: /knowledge/{agentCode}/{knowledgeId}

1 つのナレッジを編集する画面です。Editor.js のブロックエディタでの本文編集、テーブル形式 JSON の編集、セクションの並べ替え、タグの管理、関連ナレッジへのリンク、コメント、変更履歴と過去バージョンへの復元を行えます。本文は内部的に Markdown として保存されます。

新規ナレッジの作成はこの画面ではなく、ナレッジ一覧の「新規」ボタンから行います。

画面の見方

• サイドバー: 上部にエージェント行（クリックでナレッジ一覧へ）、下にセクション目次。ドラッグ＆ドロップまたはキーボードで並べ替え可能。コメントが付いているセクションには目次の右端に件数バッジが表示され、クリックで該当セクションへ移動できます。
• ヘッダー: 戻る（history.back() で直前のページへ。履歴なしの場合はフォールバック）・タイトル・ダウンロード・参照元・共有・更新・コピー・削除・ユーザーメニュー。
• メタ行・タグ行: トークン数・「関連ナレッジ」ボタン・「変更履歴」ボタン・「レビュー済み」ボタン（オーナーのみ）、タグチップと新規タグ入力欄。

閲覧専用モード（メンバー・パブリック非オーナー・未ログイン）では、ダウンロード・参照元・共有のみ表示され、更新・コピー・削除・変更履歴ボタンは非表示になります。

【オーナー向け】基本操作

以下の編集系操作はオーナーのみ。画面全体の保存ボタンはなく、タイトル・No・タグ・セクションの並べ替えなどは操作ごとに即時保存 されます。ただし、本文（セクション）の編集モードとテーブル形式 JSON の編集には「保存』「キャンセル」バーが表示され、「保存」を押したときに反映されます。

• タイトル編集: ヘッダー中央のタイトルをクリックしてインライン入力。
• No（章/節/項番号）編集: タグ行の上の No 入力行でドット区切り数字（例 1.2.3、最大 5 階層 / 20 文字）を編集。
• 本文編集（セクション単位）: 各セクションの「編集」アイコンで Editor.js のブロックエディタに切り替わります。見出しは上部のタイトル入力欄で編集し、下部の保存／キャンセルバーで確定します。
• セクション追加: 本文側の「追加」アイコン（直下に新規セクション、自動で編集モード）またはサイドバーの ⋮ メニュー。
• タグ編集: タグ行の入力欄で同じエージェント内の既存タグが候補表示されます。
• テーブル形式 JSON: 表組みデータのナレッジは Markdown ではなく表形式エディタで編集します（保存／キャンセルバーあり）。

【オーナー向け】レビュー済み操作

メタ行の「レビュー済み」ボタン（オーナーのみ表示）は、本文を変えずに reviewed_at（最終確認日時）を更新する操作です。

• 目的: 内容は正しいが更新履歴が古いために「要レビュー（陳腐化）」と判定されているときに、確認済みとして解消する
• 鮮度の判定: max(updated_at, reviewed_at) で計算されるため、本文を直接変更しなくても鮮度がリセットされる
• 変更履歴への影響: レビュー操作は変更履歴（メンテナンスログ）には残らない（楽観ロックも発火しない）
• 利用分析の「フィードバック・未回答質問」カードや「ナレッジ閲覧」カードの各行にも同じ「レビュー済み」アイコンがあり、そこからも操作できる

【オーナー向け】AI で修正

セクションの編集中、AI 修正バーの「AI で修正」で Markdown（セクション本文）の修正を LLM に依頼できます（表形式ナレッジは対象外）。対象セクションの非孤立コメントが自動で指示文末尾に合成されます。

【オーナー向け】変更履歴・バージョン復元

メタ行の「変更履歴」ボタンで右ドロワーが開き、created / updated / deleted / restored の操作種別・実行者・タイムスタンプが並びます。スナップショット付きの updated 行はクリックで過去バージョンをプレビューし、「復元する」で現在のナレッジを上書きできます。同じ実行者・同じ操作元の連続編集は既定 5 分のウィンドウ内で 1 件に集約されます。

同時編集と競合（version_conflict）

本文保存は expected_version（updated_at）による 楽観ロック です。自分の連続編集では通常競合しませんが、別ユーザー・MCP・別ブラウザタブ で先に保存されると 409 version_conflict となり、「他の場所で更新されました」ダイアログが表示されます。

セクションコメントの追加・削除は updated_at を進めないため、コメントだけでは競合しません。

保存が「コンテンツポリシーに抵触」でブロックされる場合は No.8.6。編集後にチャットで効かないときは No.5.9。

共有（QR・URL）

ヘッダーの 共有 ボタンで、このナレッジエディターへの QR と URL をコピーできます（閲覧専用モードでも利用可）。詳細は「ナレッジを共有する — QR・URL」（No.4.6）。流入は利用分析の ナレッジ QR / ナレッジリンク に集計されます（No.3.4）。

関連ナレッジを管理する

メタ行の「関連ナレッジ」ボタンで右ドロワーが開き、同じエージェント内の別ナレッジへのリンク（無向・種類なし）を張れます。A→B にリンクを張ると B 側でも A へのリンクとして見えます。別のエージェント配下のナレッジへはリンクできません。

リンク一覧は No（章/節/項番号）の昇順で並び（No 未設定は末尾）、No が設定されたナレッジはタイトルの先頭に番号が表示されます。

セクションコメント

各セクション直下の「コメント」パネルからコメントを追加できます。追加はパブリックなら認証ユーザー全員、プライベートはメンバー以上。削除は オーナーのみ（自分のコメントでも非オーナーは不可）。コメントは見出しテキストにアンカーし、見出しを書き換えると孤立コメントになります。

コメントの見落とし防止のため、コメントが付いているセクションは サイドバー目次の件数バッジ と コメント欄ヘッダーの件数表示 で一目で分かります。コメントが 1 件以上あるセクションのコメントパネルは初期表示で自動的に開きます。

【オーナー向け】画像・ファイルの添付

本文の編集中に、画像やドキュメントを ドラッグ＆ドロップ／ペースト／ブロックメニュー から挿入できます。

• 最大 10MB / ファイル、許可形式は 14 種類。
• アップロードはオーナーのみ（編集権限保持者）。メンバー・閲覧者は添付の追加不可。
• 閲覧権限: パブリックエージェントの添付は未ログインでも閲覧可。プライベートエージェントの添付はオーナー・メンバーのみ（URL を知っていても認可なしでは 403）。
• 添付ファイルは CDN/R2 を経由せず、Laravel コントローラで認可チェック付き配信されます。

制約・上限