PDF Toolkit
PDF ツールキットはエージェントに PDF 固有のツールを与えます：テキスト抽出、ページの画像化、プレーンテキストまたは画像からの PDF 生成。接続も API キーも不要です。
エージェントの Toolkits タブで追加し、エージェントが PDF を扱うべきときはペルソナプロンプト内で @ を使ってツールを参照します。
前提条件
- 編集できるエージェント
- 抽出またはページ変換には：チャットアップロード、Knowledge Base ファイル、公開 HTTPS URL、または base64 の PDF データ URL
- 画像から PDF への変換には：base64 データ URL または HTTPS URL（JPEG、PNG、GIF、WebP）の画像
利用可能なツール
| ツール | 説明 |
|---|---|
| Extract Text | PDF の全ページからテキストを抽出し、ページ数と文字数を含む結合テキストを返す。 |
| Convert to Image | PDF の1ページを PNG 画像に変換。ページ番号（1始まり）と任意の DPI（デフォルト 200）を設定。 |
| Text to PDF | プレーンテキストから折り返しとページ送り付きの PDF を生成。ファイル名は任意（デフォルト output.pdf）。 |
| Image to PDF | 画像を画像サイズに合わせた1ページの PDF に埋め込み。ファイル名は任意（デフォルト output.pdf）。 |
PDF 入力の解決方法
Extract Text と Convert to Image でエージェントが渡せるもの：
- 現在の会話のチャット添付ファイル名
- 現在のプロジェクト内の Knowledge Base ファイルの名前またはパス
- PDF への
https://URL - base64 データ URL（
data:application/pdf;base64,…）
複数のチャットまたは KB ファイルが同じ名前を持つ場合は、正確なファイル名または KB のフルパスを指定してください。
Image to PDF は base64 または HTTPS の画像 URL のみを受け付けます（チャット/KB のファイル名解決は不可）。
ユースケース
- 会話中にアップロードされたポリシー PDF から条項や目次を引き出す
- 表紙ページや図のページをレビューまたは追加分析のために画像に変換する
- エージェントが生成したテキストから短い PDF のサマリーやレシートを生成する
- 生成したチャートやスクリーンショットをダウンロード用の1ページ PDF にまとめる
ヒント
- 検索可能なテキスト PDF には Extract Text を優先。スキャン画像のみの PDF はほとんど、あるいは全くテキストを返さない場合があります — それらには Knowledge Base の取り込みや OCR を別の場所で使用してください。
- Convert to Image は1回の呼び出しで1ページを処理します。複数ページ出力では次のページ番号で繰り返してください。
- 生成された PDF と画像は会話へのデータとして返されます — Knowledge Base ドキュメントとして自動保存されません。保存されたファイルフローが必要な場合は Document Manager または File Helpers を使用してください。
- 汎用のファイル読取/保存（DOCX、XLSX、CSV、再エンコード）には File Helpers を使用してください。
トラブルシューティング
| 症状 | 確認すること |
|---|---|
| 抽出テキストが空、または乏しい | PDF がスキャン/画像のみの可能性；テキストベースの PDF か OCR 付きの KB 取り込みを試す |
| ファイル名があいまい | 複数のチャットまたは KB が一致；正確な名前またはフルパスを使用 |
| Convert to Image が失敗 | ページ番号が PDF の範囲内か確認；ページが非常に大きい場合は低い DPI を試す |
| Image to PDF がファイルを拒否 | base64 データ URL または HTTPS 画像 URL を使用（チャット/KB のファイル名のみは不可） |
| Document Manager と混同 | Document Manager はチャット内 markdown ドキュメントを作成/編集；PDF ツールキットは PDF ファイルを扱う |