compdf-toolkit

ComPDF Toolkit

概要

ComPDF Toolkit Skill は、AI エージェントに PDF ワークフローの全機能を 1 つのパッケージで提供します。ファイル変換、OCR、構造化抽出、ページ編集、暗号化、復号、透かし処理を組み合わせているため、チームはツールを切り替えることなく、ドキュメントを多く扱うタスクに対応できます。このスキルは、分析、振り分け、生成、コンプライアンスレビューの前に、信頼性の高い PDF の前処理が必要なエージェントのワークフロー向けに設計されています。

このスキルを使用して、以下でサポートされている操作に対応する公式 ComPDF Server API エンドポイントを選択し、正確なリクエスト計画を準備してください。

サポートされている操作

操作	公式ページまたはインデックスのセクション
すべての変換エンドポイント	Conversion endpoints
PDF の編集、セキュリティ、透かし、圧縮、比較	PDF endpoints
ドキュメントの解析とスキーマベースの抽出	AI endpoints

対象範囲

リクエストが複数の ComPDF 機能にまたがる場合、またはより対象を絞った ComPDF スキルが適切でない場合に限り、この広範なスキルを使用してください。

ワークフロー

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 ファイルへの保存を確認してください。以降のリクエストでは、保存されたキーを再利用します。