ai-pdf-filler-cli

AI PDF Filler CLI

インストール済みの simplicity-cli コマンドを使用して、PDF の自動入力ワークフローを実行します。 このスキルが適用される場合は、手動で API を呼び出すよりも、コマンドを直接実行してください。

基本的なワークフロー

1. simplicity-cli --help を実行して、simplicity-cli がインストールされていることを確認します。
2. インストールされていない場合は、CLI をインストールします。

• 推奨：uv tool install ai-pdf-filler
• 代替：python3 -m pip install ai-pdf-filler
• simplicity-cli --help を再実行して確認します。

3. 認証情報を用意します（https://simplicity.ai でアカウントを作成し、API キーを取得してください）。

• 推奨：simplicity-cli login を実行し、非表示のプロンプトにキーを貼り付けます。
• 非対話型の場合：printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin。
• または、環境変数 SIMPLICITY_AI_API_KEY を設定します。

4. 自動入力の方法を選択します。

• 新しい PDF フォーム：simplicity-cli new を使用します。
• 既存のフォーム ID：simplicity-cli existing FORM_ID を使用します。

5. ユーザーが非同期での実行を明示的に希望している場合を除き、完了するまで待ちます。
6. 結果のタスク ID、フォーム／ドキュメント ID、ダウンロードした出力ファイルのパスを返します。

コマンドのパターン

API キーを保存する

simplicity-cli login

printf '%s' "$SIMPLICITY_AI_API_KEY" | simplicity-cli login --api-key-stdin

ファイルとコンテキストから新しいフォームを作成する

simplicity-cli new \
  --form-file ./form.pdf \
  --context "name: John Doe; dob: 1990-07-07"

ファイルとソースドキュメントから新しいフォームを作成する

simplicity-cli new \
  --form-file ./form.pdf \
  --source-file ./w2.pdf \
  --source-file ./id.pdf

URL から新しいフォームを作成する

simplicity-cli new \
  --form-url "https://example.com/form.pdf" \
  --source-url "https://example.com/source.pdf"

既存のフォーム ID

simplicity-cli existing FORM_ID --context "first_name: John; last_name: Smoke; dob: 1990-07-07"

--context は、フォームのフィールドへの入力に使用するソースデータです。 --instructions は、自動入力の動作に関する任意のガイダンスを指定する場合にのみ使用してください。

タスクの監視

simplicity-cli status TASK_ID
simplicity-cli wait TASK_ID --poll-interval-seconds 2 --max-wait-seconds 1800

ルールと検証

• new では、--form-file と --form-url のどちらか一方だけを指定してください。
• new では、少なくとも 1 つのソース（--source-file／--source-url）またはコンテキスト（--context／--context-file）が必要です。
• --context と --context-file は相互排他的として扱います。
• --instructions と --instructions-file は相互排他的として扱います。
• --no-download が設定されている場合は、--output を拒否します。

実行時の推奨事項

• 対話的な実行では、人間向けの出力モードを使用します。
• 自動化する場合、または機械で解析可能な出力が求められる場合は、--json を使用します。
• ユーザーが非同期での引き継ぎを希望する場合にのみ --no-wait を使用し、それ以外の場合は完了まで待ちます。
• ユーザーが明示的なファイルパスを指定した場合は、--output を使用します。

失敗時の対応

• simplicity-cli が見つからない場合は、まず ai-pdf-filler をインストールしてから再試行します。
• 認証情報がない場合は、simplicity-cli login（または --api-key-stdin）を実行するか、SIMPLICITY_AI_API_KEY を設定するよう案内します。
• タスクが失敗した場合は、タスク ID と失敗メッセージを報告し、API エラーの詳細を隠さないでください。
• タスクが正常に完了した後にダウンロードが失敗した場合も、タスク／フォームの識別子を返します。
• スクリプト実行環境では、--json を指定して再実行し、error.code と error.message を提示します。

参考資料

簡潔なテンプレートとオプションの確認には、references/commands.md を使用してください。