このガイドでは、Discourse で AI ボットと対話する際に、PDF やドキュメントの添付ファイルをネイティブにサポートを有効にして使用する方法を説明します。ユーザーは、AI エージェントとの会話の中で PDF やその他のドキュメントを直接アップロードできます。
必要なユーザーレベル：管理者
概要
Discourse AI では、ネイティブの添付ファイル処理がサポートされており、ユーザーは AI ボットとの会話中に PDF やその他のドキュメント形式を直接アップロードできます。AI はこれらの添付ファイルの内容を読み取り、理解できるため、ドキュメント分析、要約、アップロードされたファイルに基づく質問応答などのユースケースが可能になります。
この機能には、以下が必要です：
- LLM で設定された許可された添付ファイルタイプ
- ビジョンが有効なエージェント（これは、アップロードがメッセージに含まれるかどうかを制御します）
- サイトのアップロード設定で認証されているファイル拡張子
サポートされているプロバイダー
ネイティブ添付ファイルサポートは、以下のプロバイダーのモデルで動作します：
- Anthropic（Claude モデル）
- AWS Bedrock（Bedrock 経由の Claude モデル）
- Google（Gemini モデル）
- OpenAI（GPT モデル）
- Azure（OpenAI 互換モデル）
- OpenRouter（OpenAI 互換モデル）
各プロバイダーは API レベルで異なる方法で添付ファイルを処理しますが、Discourse AI はこれを自動的に管理します。異なるプロバイダーは、さまざまな添付ファイルタイプに対して異なるレベルのサポートを実装していることに留意してください。
サポートされている添付ファイルタイプ
AI 処理用に以下のドキュメントタイプを設定できます：
| タイプ | 拡張子 |
|---|---|
pdf |
|
| プレーンテキスト | txt |
| Microsoft Word | doc, docx |
| リッチテキスト形式 | rtf |
| HTML | html, htm |
| Markdown | md, markdown |
画像は「ビジョン有効」設定を通じて個別に処理され、添付ファイルタイプの設定は必要ありません。
設定
ステップ 1：アップロード用のファイル拡張子の認証
ユーザーが添付ファイルをアップロードする前に、サイト設定でファイル拡張子が認証されていることを確認してください。
- 管理 → ファイル に移動します
authorized extensions（認証済み拡張子）設定を探します- 許可したい拡張子を追加します（例：
pdf|txt|docx）
ステップ 2：LLM モデルの設定
- 管理 → プラグイン → Discourse AI → LLMs に移動します
- 設定したい LLM モデルを選択します（または新規作成します）
- Allowed attachments（許可された添付ファイル）フィールドで、モデルに受け入れさせたいファイル拡張子を選択または入力します（例：
pdf、txt、docx）
「Allowed attachments」フィールドを空欄のままにすると、そのモデルのドキュメント添付は無効になります。画像は「Vision enabled（ビジョン有効）」トグルによって個別に制御されます。
ステップ 3：エージェントの設定
- 管理 → プラグイン → Discourse AI → Agents に移動します
- エージェントを選択または作成します
- Vision enabled（ビジョン有効）がオンになっていることを確認します — これにより、アップロード（画像とドキュメントの両方）が LLM に送信されるメッセージに含まれるかどうかが制御されます
- Default model（デフォルトモデル）を、添付ファイルが設定されている LLM に設定します
仕組み
ユーザーが AI ボットとの会話でドキュメントをアップロードする場合：
- ドキュメントは標準的なアップロード処理を使用して Discourse にアップロードされます
- Discourse AI はドキュメントコンテンツをエンコードします（base64）
- エンコードされたコンテンツは、ユーザーのメッセージとともに LLM に送信されます
- LLM はテキストメッセージとドキュメントコンテンツの両方を処理します
- AI は統合されたコンテキストに基づいて応答します
技術的な詳細
- ドキュメントは base64 でエンコードされ、リクエストにインラインで送信されます
- 各プロバイダーは、ネイティブ形式で添付ファイルを受け取ります：
- Anthropic：base64 ソースを含む
documentタイプを使用します - Gemini：
inlineData形式を使用します - OpenAI（Chat Completions API）：base64 コンテンツを含む
file_dataを持つfileタイプを使用します - OpenAI（Responses API）：base64 コンテンツを含む
file_dataを持つinput_fileタイプを使用します
- Anthropic：base64 ソースを含む
- ファイルサイズの制限は、サイトの
max attachment size kb設定によって決定されます
ユースケース
ネイティブ添付ファイルサポートにより、以下のワークフローが可能になります：
- ドキュメント分析：契約書、レポート、研究論文をアップロードし、AI に要約させたり質問に答えさせたりします
- コンテンツレビュー：AI にドラフトドキュメントをレビューさせ、フィードバックを提供させます
- データ抽出：アップロードされたドキュメントから特定の情報を抽出します
- 翻訳支援：ある言語でドキュメントをアップロードし、コンテンツについて議論したり翻訳を依頼したりします
- 技術サポート：ユーザーはトラブルシューティング支援のためにログファイルや設定ファイルをアップロードできます
制限事項
- ファイルサイズ：添付ファイルは、サイトのアップロードサイズ設定と LLM ベンダーによって制限されます
- プロバイダーサポート：添付ファイルサポートには、ドキュメントを処理できるプロバイダー方言（Anthropic、AWS Bedrock、Google、OpenAI、Azure、OpenRouter）が必要です
- エージェントのビジョン要件：アップロードがメッセージに含まれるようにするには、エージェントで「Vision enabled」がオンになっている必要があります
- 拡張子の一致：ファイル拡張子は、サイトでのアップロード認証と、LLM の添付ファイルタイプ設定での許可の両方が必要です
- 結果の変動：LLM ベンダーと LLM がファイルを処理するため、コスト/精度および結果は変動します。Anthropic は、OpenAI や Google よりも分析により多くのトークンを使用する傾向があります。
- キャッシュの有効化：OpenAI の場合は、Response API を使用してください。これにより、キャッシュのより一貫したサポートが提供されます（思考機能が有効な場合）。Anthropic モデルの場合は、LLM 設定で明示的にキャッシュを有効にする必要があるかもしれません。これは、マルチターン会話を行う際に特に重要です。
トラブルシューティング
添付ファイルが処理されない場合
- ファイル拡張子がサイトの
authorized extensions設定に含まれていることを確認します - ファイルタイプが LLM の「Allowed attachments」設定にリストされていることを確認します
- エージェントで「Vision enabled」がオンになっており、正しく設定された LLM を使用していることを確認します
アップロードが失敗する場合
max attachment size kb設定を確認します- ファイル拡張子が認証されていることを確認します
- 非常に大きな PDF はサポートされていない場合があります。各 LLM ベンダーによって最大アップロードサイズが異なります。
AI がドキュメントを理解しない場合
- ドキュメント理解をサポートするモデルを使用していることを確認します
- より高性能なモデルを試してください（例：Claude Sonnet 4.5、GPT-5.1、Gemini Pro 3）
FAQ
ユーザーは 1 つのメッセージで複数のドキュメントをアップロードできますか？
はい、ユーザーは 1 つのメッセージに複数の添付ファイルを含めることができ、AI はそれらすべてにアクセスできます。
これは PM だけでなくチャットでも動作しますか？
はい、添付ファイルサポートは、AI ボットとのプライベートメッセージでも、チャット DM でも動作します。ただし、エージェントがそれらのインタラクション方法向けに設定されている必要があります。
これはエージェントの RAG アップロードとは異なりますか？
はい。RAG アップロードは、管理者がエージェントのナレッジベースに追加したドキュメントであり、インデックス化および検索されます。ネイティブ添付ファイルサポートにより、エンドユーザーは、インデックス化なしで即座に分析するために、会話中にドキュメントをアップロードできます。
アップロードされたドキュメントはどうなりますか？
ドキュメントは、サイトの標準的なアップロード処理および保持ポリシーに従って処理されます。通常 Discourse のアップロードとして保存されます。