添付ファイル設定
添付ファイル(Attachments)は、エージェントに固定された参照ファイルで、毎回の対話に自動的に含まれます。
いつ使用するか
- エージェントが特定のドキュメントを固定的に参照する必要がある場合
- ナレッジベースに適さない小規模データ
- エージェントが優先的に参照すべき内容
添付ファイル vs ナレッジベース
| 添付ファイル | ナレッジベース | |
|---|---|---|
| 容量 | 最大5ファイル | 大量のデータを接続可能 |
| 使用方法 | 毎回の対話に自動的に含まれる | エージェントがクエリするかどうかを決定 |
| 適したコンテンツ | コアルール、重要情報 | 大量の参照資料 |
使用推奨事項:
- 添付ファイル: エージェントが知っておくべきコアルールを配置
- ナレッジベース: クエリが必要な詳細データを配置
設定手順
ステップ1: 添付ファイルエリアを見つける
Agent Editorの左パネルの高度な設定エリア(グレー背景エリア)で、「添付ファイル」ブロックを見つけます。
ステップ2: ファイルをアップロード
「添付ファイルを追加」またはクリップボタンをクリックすると、アップロードダイアログが開き、次のことができます:
- ローカルアップロード: 「ファイルを選択」ボタンをクリックするか、アップロードエリアにファイルをドラッグ
- クラウドから選択: 接続されたデータソース(GitHub、Notion、Google Driveなど)からファイルを選択
サポートされているファイルタイプ:
- ドキュメント: PDF、Word (.doc, .docx)、テキストファイル (.txt)
- プレゼンテーション: PowerPoint (.pptx)
- マークアップ言語: Markdown (.md)、HTML (.html)
- 画像: JPEG (.jpg, .jpeg)、PNG (.png)、GIF (.gif)、WEBP (.webp)
ファイルサイズ制限:
- 単一ファイル最大 50 MB
- 制限を超えるファイルはアップロードできません
ステップ3: 添付ファイルを管理
アップロード後、次のことができます:
- アップロードされたファイルのリストを表示
- アップロード添付ファイルの残りクォータを表示
- 不要な添付ファイルを削除
数量制限
- 最大 5個 の添付ファイル
- この制限は、エージェントがコンテンツを効果的に処理できることを保証するためです
ファイルサイズ制限
- 単一ファイル最大 50 MB
- この制限は、アップロードと処理の効率を保証するためです
- ファイルが大きすぎる場合は、次のことをお勧めします:
- ファイルを複数の小さなファイルに分割
- コンテンツを簡素化してからアップロード
- 大規模データを保存するためにナレッジベースを使用
使用シナリオの例
コア製品仕様
添付ファイル: product-specs.pdf
内容: 製品の完全な仕様表
Core Instructionsと連携:
「製品仕様の質問に答えるときは、添付ファイルの仕様表を優先的に参照してください」
応答ガイドラインマニュアル
添付ファイル: response-guidelines.md
内容: 標準応答フォーマット、用語規範、禁止用語
Core Instructionsと連携:
「すべての応答は、添付ファイルの応答ガイドラインマニュアルに従う必要があります」
よくある質問リスト
添付ファイル: faq.md または faq.txt
内容: 構造化されたQ&A対照表(Markdownまたはプレーンテキスト形式を使用)
Core Instructionsと連携:
「よくある質問を受け取ったら、FAQ添付ファイルの標準回答を直接引用してください」
ベストプラクティス
コンテンツを簡潔に
添付ファイルは毎回の対話で処理されます。大きすぎるファイルは:
- 処理時間を増加させる
- より多くのリソースを消費する
- モデルの処理制限を超える可能性がある
推奨: 大規模データはナレッジベースに配置し、添付ファイルにはコアエッセンスのみを配置します。
ファイルサイズの推奨事項:
- 個々の添付ファイルは 10 MB以内 に抑えることをお勧めします(処理速度を確保するため)
- 10 MBを超えるファイルはアップロード可能ですが(上限50 MB)、応答速度に影響する可能性があります
- コンテンツが多い場合は、次のことを検討してください:
- ファイルを複数の添付ファイルに分割(最大5個)
- 詳細なコンテンツをナレッジベースに移動し、添付ファイルには要約または重要情報のみを保持
Core Instructionsで添付ファイルと各ファイルの用途に言及
エージェントに添付ファイルの存在と用途を知らせます:
## 参考資料
次の添付ファイルを参照できます:
- product-specs.pdf: 製品仕様表
- response-guidelines.md: 応答ルール
製品の質問に答えるときは、仕様表を最初に確認してください。
すべての応答は応答ルールに準拠する必要があります。
定期的な更新
添付ファイルは更新頻度の低いコンテンツに適していますが、コンテンツが正確であることを確認してください:
- 製品仕様が変更されたら更新
- ポリシーが調整されたら更新
- エラーが見つかったらすぐに修正
よくある質問
添付ファイルとナレッジベースを同時に使用できますか?
はい!これは推奨されるアプローチです:
- 添付ファイル: コアルール、必須知識
- ナレッジベース: 詳細データ、クエリが必要なコンテンツ
エージェントは両方を同時に参照できます。
添付ファイルを更新した後、エージェントを再保存する必要がありますか?
はい、添付ファイルはエージェント設定の一部です。添付ファイルを更新した後は、変更を有効にするために保存する必要があります。
ユーザーは添付ファイルのコンテンツを見ることができますか?
ユーザーは添付ファイルを直接ダウンロードできませんが、エージェントが応答するときに添付ファイルのコンテンツを引用する可能性があります。機密情報を削除するか、Core Instructionsで引用方法を制限することをお勧めします。
5個を超える添付ファイルがある場合はどうすればよいですか?
次のことを検討してください:
- 関連ファイルを統合
- 一部のコンテンツをナレッジベースに移動
- コンテンツを簡素化し、最もコアな情報のみを保持
ファイルサイズが50 MBを超える場合はどうすればよいですか?
ファイルが50 MBの制限を超える場合は、次のことを検討してください:
- ファイルを分割: 大きなファイルを複数の小さなファイルに分割(各50 MBを超えない)
- コンテンツを簡素化: 不要なコンテンツを削除し、コア情報のみを保持
- ナレッジベースを使用: 大きなファイルをナレッジベースにアップロードし、添付ファイルには要約またはインデックスのみを保持
- ファイルを圧縮: 画像ファイルの場合、適切に圧縮してからアップロード