ナレッジへの画像・ファイル添付
ナレッジへの画像・ファイル添付
ナレッジエディターでは、本文中に 画像やファイル を添付できます。
添付方法
ドラッグ&ドロップ
エディター内にファイルをドラッグ&ドロップすると自動アップロードされます。
ツールバーから
エディターのツールバー → 画像/ファイル追加 ボタン → ファイルを選択
ペースト
クリップボードの画像を 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 だけ知っていれば閲覧できる、ということはありません。
添付後の表示
- 画像 — 本文内にインライン表示
- PDF 等 — ダウンロードリンクとして表示(paperclip アイコン付き)
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 します。
注意点
- アップロードしたファイルは アイノウに紐づく — アイノウ削除で失われます
- 大きな画像は表示速度に影響するため、適切なサイズにリサイズ推奨
- 著作権・個人情報に注意