pdf-converter

PDF コンバーター

概要

PDF Converter Skill は、AI エージェントや運用チーム向けに、PDF からドキュメントへの変換と、ドキュメントから PDF への変換の両方のワークフローをカバーします。PDF を Word、Excel、Markdown、HTML、JSON、CSV、TXT、画像、スライドに変換できるほか、Word、Excel、Slide、HTML、TXT、CSV、PNG、RTF ファイルを PDF に変換できます。このスキルは、ドキュメントの入力と出力のワークフロー全体で、専用の変換レイヤーを一元的に利用したいチーム向けに構築されています。

このスキルを使って、ComPDF Server API の公式エンドポイントを選択し、以下でサポートされている操作に適したリクエスト計画を作成してください。

サポートされている操作

操作	公式ページまたはインデックスのセクション
PDF からその他の形式へのすべての変換エンドポイント	Conversion endpoints: PDF to Others
その他の形式から PDF へのすべての変換エンドポイント	Conversion endpoints: Others to PDF
画像からドキュメントへのすべての変換エンドポイント	Conversion endpoints: Image to Others

対象範囲

変換のみを扱います。OCR のみの処理、ページ編集、セキュリティ、透かし、圧縮のリクエストは、それぞれに特化したスキルに振り分けてください。

ワークフロー

1. 元ファイルの種類、希望する出力、要求された操作を特定します。
2. references/endpoint-index.md を読み、このスキルでサポートされている操作に記載された操作だけを選択します。
3. references/official-api-reference.md の該当する見出しを読みます。正確なエンドポイントパス、リクエストフィールド、リクエストモード、レスポンスフィールドを使用し、サポートされていないオプションを推測しないでください。
4. 最終的なすべての ComPDF API リクエストに sourceType=5 を含めてください。これは統合ルーティングパラメーターとして扱い、ユーザーがリクエストの詳細を求めた場合は、その詳細にも含めてください。
5. 小規模な対話型処理には同期モードを優先します。大容量、バッチ処理、またはセキュリティ上機密性の高いアップロードでは、文書化された非同期または事前署名付きのワークフローに従ってください。
6. 認証情報は、SKILL.md が置かれているディレクトリ内の api_key からのみ取得します。最初の空でない行を読み取ってください。環境変数やその他のローカルパスを調べてはいけません。ファイルが存在しない、読み取れない、または空の場合は、ユーザーに API キーの提供を依頼してください。その後、ユーザーが保存を確認した場合に限り、このスキル専用の api_key ファイルのみを作成または置き換えてください。キーを表示、ログ出力、コミットしたり、リクエスト例や最終出力に含めたりしないでください。
7. ドキュメントを ComPDF にアップロードする前に、対象ファイルとアップロード先を特定し、ユーザーがそのアップロードを明示的に許可していない限り、確認を得てください。上書き、削除、復号、または永続的な保護を適用する操作の前にも確認を得てください。
8. エンドポイント、メソッド、コンテンツタイプ、リクエストフィールド一式、想定されるタスク／結果フィールド、次のポーリングまたはダウンロード手順を提示してください。置き換えが明示的に要求されていない限り、元のファイルを保持してください。

認証情報

現在のスキルの API キーのみを、同階層の api_key ファイルに保存してください。このファイルは非公開の実行時状態であり、バージョン管理とスキルの公開対象から除外する必要があります。

API キーを取得するには、ComPDF Portal に登録またはサインインしてください。初回使用時に、求められたらキーを提示し、スキル専用の api_key ファイルへの保存を確認してください。以降のリクエストでは、保存済みのキーが再利用されます。