> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ドキュメント知識

> AI エージェントのデータソースをアップロードする

<img src="https://mintcdn.com/lovi/7OwZqv3QR8HsQ0sP/images/DocumentsModule.png?fit=max&auto=format&n=7OwZqv3QR8HsQ0sP&q=85&s=5fa2ebd69291040a8200d1b666254916" alt="ドキュメントモジュールビュー" width="1920" height="1440" data-path="images/DocumentsModule.png" />

*クローラー* が公共図書館の本（ウェブ）である場合、**ドキュメント** はオフィスのプライベートファイルです。

ここでは、機密の手順、Excel 価格表、または内部 PDF ガイドをアップロードします。特定のファイルにエージェントに直接アクセスを提供し、それが*あなたの*ビジネスの即時専門家になるようにします。

### 📥 ここに何をアップロードできますか？（魔法のフォーマット）

あなたのエージェントは多言語で、ほとんど何でも読み取れます：

* 📄 **PDF：** マニュアル、カタログ、パンフレット。
* 📊 **XLSX / CSV：** 価格表、在庫リスト、シンプルなデータベース。
* 📝 **TXT / JSONL：** クイックノート、ログ、または構造化データ。

***

### ⚙️ ファイルを管理する方法（アップロードゾーン）

<img src="https://mintcdn.com/lovi/dTYJfVAlcmM4kvAj/images/UploadDocs.png?fit=max&auto=format&n=dTYJfVAlcmM4kvAj&q=85&s=9b10427ef895121397df03ad9dd32838" alt="ドキュメントのアップロードと管理" width="1683" height="315" data-path="images/UploadDocs.png" />

見た目と同じくらい簡単です：

1. **ドラッグ＆ドロップ：** ファイルをボックスにドラッグするか、クリックしてコンピュータを閲覧します。
2. **処理：** システムはテキストを読み取ります（"解析"）ので、エージェントが理解できます。
3. **準備完了！** 処理されると、下のリストにファイルが表示されます。

#### リストコントロール：

* **名前：** ファイル名。明確に保ちます（例: `Prices_2024.pdf` ではなく `doc1.pdf`）。
* **トグル（スイッチ）：** 最も便利な機能。

  * 🔵 **オン：** エージェントは読み取り、使用します。
  * ⚪ **オフ：** ファイルは保存されますが、エージェントによって無視されます。ドラフトや完全に削除したくない古いバージョンに最適です。
* **ビン 🗑️：** エージェントの記憶からファイルを完全に削除します。

***

### ⚠️ 黄金ルール（何をすべきでないか）

すべてがスムーズに実行されるように、これを心に留めておいてください：

#### 1. 空のファイル = エラー 🚫

スキャンされた画像（選択可能なテキストなし）のみを含む PDF や破損したファイルをアップロードすると、 `[MARKITDOWN] pdf is empty` のようなエラーが表示されます。

> **解決策：** PDF に実際のテキスト（OCR）が含まれているか、Excel ファイルに実際のデータがあることを確認してください。

#### 2. サイズに注意（分割してください！）✂️

ファイルごとに単語制限があり、エージェントの脳を過負荷にしないようにします。

* *マニュアルに 500 ページありますか？* 1 つのファイルとしてアップロードしないでください。
* **分割：** `Manual_Part1.pdf`、`Manual_Part2.pdf` などとしてアップロードします。
* エージェントはスマートで、すべてのアクティブファイルから情報を組み合わせて一貫した回答を提供します。

***

### 🧠 エージェントがこのデータでどのように推論するか？

3 つのファイルをアップロードし、**オン** に切り替えたと想像してください：

1. `Washing_Machine_Manual.pdf`
2. `Spare_Parts_Prices.xlsx`
3. `Warranty_Policy.txt`

今、ユーザーが *"部品 X の価格と保証がカバーされますか？"* と尋ねた場合、エージェントは：

1. **Excel** で価格を検索します。
2. **TXT** で条件を読みます。
3. 両方を組み合わせて返答します："部品の価格は £20 で、はい、条項 3 でカバーされます。" 🤯

***

### 🎓 ベストプラクティス要約（チートシート）

* **説明的な名前：** エージェント（と自分自身）が中身を理解するのに役立ちます。`Wedding_Menu.pdf` は `scan001.pdf` より良いです。
* **更新：** 新しいバージョン（`Prices_V2.xlsx`）をアップロードする場合、古いバージョン（`Prices_V1.xlsx`）をオフに切り替えたり削除したりすることを忘れないでください。そうしないとロボットが 2 つの異なる価格で混乱します。
* **クリーンデータ：** 数千の空行がある Excel ファイルや重い透かしがある PDF をアップロードしないでください。テキストがきれいであるほど、回答がスマートになります。

エージェントの脳に最高のドキュメントを入力し始めましょう！📂✨
