ファイルをテキストとしてアップロード

PDF、コードファイル、あるいはスプレッドシートをAIに渡して、ただ「これを読んで」と言うだけで済ませたいと思ったことはありませんか？それこそが、Upload as Text（テキストとしてアップロード）の機能です。

ファイルを添付すると、LibreChatがそのファイルからテキストを抽出し、その内容全体が会話に直接貼り付けられます。AIはプラグインやベクトルデータベース、追加のサービス設定を必要とすることなく、その内容をすべて読み取ることができます。箱から出してすぐに動作します。

How to use it

内部の仕組み

この方法でファイルをアップロードすると、LibreChatは単に生のバイトデータをプロンプトに流し込むだけではありません。処理パイプラインを通じて、クリーンで読み取り可能なテキストを抽出します。

1. MIME type detection — LibreChatは、アップロードされたファイルの種類（PDF、画像、音声、ソースコードなど）をMIMEタイプを検査することで確認します。
2. メソッドの選択 — ファイルの種類と利用可能なサービスに基づいて、以下の優先順位で最適な抽出メソッドを選択します。

3. トークンの切り詰め — 抽出されたテキストは fileTokenLimit（デフォルト: 100,000トークン）に合わせてトリミングされるため、モデルのコンテキストウィンドウを超えることはありません。
4. プロンプトインジェクション — テキストは、あなたのメッセージと並んで会話コンテキストに含まれます。

サポートされているファイル形式

テキストとしてアップロード vs. その他のアップロードオプション

LibreChatには、ファイルをアップロードする方法が3つあります。それぞれ動作が異なり、状況に応じて使い分けることができます。

クイック決定ガイド:

context 機能

内部的には、Upload as Textは**context capability**によって駆動されています。これが、チャットUIにこの機能を表示するかどうかを制御しています。

endpoints:
  agents:
    capabilities:
      - "context"  # This is what enables "Upload as Text"

同じ context 機能は、Agent File Context（Agent Builder を通じてファイルをアップロードし、エージェントのシステム指示にテキストを埋め込む機能）も支えています。違いは、そのテキストが最終的に どこ に配置されるかという点です。

トークン制限と切り捨て (Truncation)

ファイルが長すぎてモデルのコンテキストウィンドウに収まらない場合、LibreChatは抽出されたテキストを切り詰めて制限内に収めます。これは自動的に行われるため、ユーザーが気にする必要はありませんが、仕組みを理解しておくと役立ちます。

fileConfig:
  fileTokenLimit: 100000  # Default: 100,000 tokens

経験則:

• 100kトークン ≈ 300ページの書籍1冊分（ほとんどのユースケースで十分な量）
• 非常に大きなファイルを扱う場合は、すべてをコンテキストに詰め込むのではなく、関連するセクションのみを取得する File Search (RAG) の利用を検討してください。

オプション: OCRによる抽出の強化

テキスト解析は、デジタル作成されたドキュメント（Wordから保存されたPDF、コードファイル、プレーンテキスト）では問題なく動作します。しかし、スキャンされたドキュメント、ページの写真、またはテキストを含む画像をアップロードする場合、組み込みのパーサーでは良好な結果が得られません。

そこでOCRの出番です。設定が完了すると、LibreChatはOCRの恩恵を受けるファイルタイプに対して自動的にOCRを使用します。ユーザー側で特別な操作を行う必要はありません。

ファイル処理設定リファレンス

このセクションは、どのファイルタイプをどのメソッドで処理するかを制御したい管理者向けです。デフォルト設定で十分に機能するため、動作を微調整したい場合のみ変更してください。

トラブルシューティング

関連情報

• OCR for Documents — 画像やスキャンデータに対する光学式文字認識（OCR）を設定します
• RAG API (Chat with Files) — 大規模なドキュメントコレクションに対するセマンティック検索
• Agents — File Context — ファイルの内容をエージェントのシステム指示に埋め込む
• File Config reference — ファイル処理のための完全なYAMLスキーマ