Skip to main content

ナレッジへの画像・ファイル添付

ナレッジへの画像・ファイル添付

ナレッジエディターでは、本文中に 画像やファイル を添付できます。

添付方法

ドラッグ&ドロップ

エディター内にファイルをドラッグ&ドロップすると自動アップロードされます。

ツールバーから

エディターのツールバー → 画像/ファイル追加 ボタン → ファイルを選択

ペースト

クリップボードの画像を Ctrl+V(Cmd+V) で直接ペーストできます。

制限

項目 制限
1ファイルあたり 10MB
対応形式 jpg / jpeg / png / gif / webp / pdf / docx / pptx / xlsx / csv / md / txt / json / html(これ以外は 422)
アップロードできる人 オーナーのみ
保存先 プライベートディスク(storage/app/private/knowledge-attachments/)
配信 /api/v1/knowledge/attachments/{hash}.{ext} 経由(認可チェック付き)

CDN/R2 について

ナレッジ添付は Cloudflare R2 や CDN 経由では配信されません。アバター等の public ディスク資産とは異なり、Laravel が権限を確認したうえでストリーム配信します。プライベートアイノウの添付が URL だけ知っていれば閲覧できる、ということはありません。

添付後の表示

MCP から添付する(Cursor / Claude)

ブラウザを開かずに、MCP からでも添付できます(いずれも オーナーのみ)。

方法 使いどころ
append-knowledge の attachments=[{data, filename}] デコード後合計 3MB 以下・最大 10 件 の小さな添付なら、base64 を渡すだけで保存と本文への埋め込みが完結する
create-attachment-upload-url → アップロード 3MB を超える場合。有効 15 分 の署名付き URL を発行し、そこへファイルを POST(1 リクエスト最大 10 件)。その後 append-knowledge の attachments=[{url}] で本文に埋め込む

保存先・重複排除・配信の仕組みはエディターからのアップロードと同じです。MIME は実バイト列から検証されるため、拡張子だけを差し替えても通りません。

重複排除

同一ファイル(SHA-256 ハッシュ一致)は実体を 1 つに dedup します。

注意点