parallel-deep-research

詳細な調査

調査テーマ：$ARGUMENTS

テキスト出力とコンテキストの引き継ぎには、parallel-cli ≥ 0.3.0 が必要です。ドキュメントに記載されたコマンドやオプションが見つからない場合は、parallel-cli --version と該当コマンドの --help を確認し、Setup に記載されたインストール方法に応じたアップグレード手順に従ってください。API、認証、入力に関するエラーは、CLI が古いことの証拠にはなりません。

使用するタイミング（parallel-web-search との使い分け）

ユーザーが詳細または網羅的な調査を明示的に依頼した場合にのみ、このスキルを使用してください。プロセッサーとタスクによっては数分かかり、クイック検索よりもコストが高くなります。通常の「X を調査して」という依頼、簡単な検索、事実確認には、代わりに parallel-web-search を使用してください。

ステップ 1：調査を開始する

永続ディレクトリ内に、内容がわかる出力ベース名を選びます（例：reports/ai-chip-market-2026）。一意になるよう、返された実行 ID を含めてください。次に、ステップ 2 ではこのベース名を -o "$FILENAME" として使用します。保存する前に、既存の .json ファイルと .md ファイルがないか確認してください。

parallel-cli research run "$ARGUMENTS" --processor pro-fast --text --no-wait --json

--text フラグを指定すると、タスク完了時に API がデフォルトの構造化 JSON ではなく、インライン引用を含む Markdown レポートを返します。文章形式のレポートを求める依頼にはこのフラグを使用してください。これは、ユーザーが「詳細な調査」を依頼する際に最もよく求められる形式です。ユーザーが構造化 JSON 出力を明示的に希望する場合は、--text を省略してください。

--text と併用できるオプション：長さ、形式、焦点を指定するには、--text-description "Keep under 1500 words, focus on M&A activity" を渡します。

これがフォローアップで、以前のタスクから返された interaction_id がある場合は、コンテキストの引き継ぎを追加してください。Enrichment の taskgroup_id と Search／Extract の session_id は、タスクのインタラクション ID ではありません。非同期の Enrichment は新しいインタラクション ID を返さないため、以前のタスク ID を保持してください。Zero Data Retention（ZDR）アカウントではコンテキストの引き継ぎを利用できないため、その場合は省略し、必要なコンテキストを明示的に渡してください。

parallel-cli research run "$ARGUMENTS" --processor lite-fast --text --no-wait --json --previous-interaction-id "$INTERACTION_ID"

これにより、以前のタスクのコンテキストが再利用されます。焦点を絞ったフォローアップには、より軽量なプロセッサー（lite-fast または base-fast）が適する場合があります。すべてのフォローアップが簡単だと決めつけず、新しい質問の深さに応じて選択してください。

作成と、回数を制限したポーリングを分けるため、必ず --no-wait を使用してください。返された ID はすぐに保存します。作成が中断された場合や応答が失われた場合は、最初のタスクが作成されたか確認するまで、代わりのタスクを送信しないでください。

探索的な調査では、デフォルトで pro-fast を使用してください。インストール済み CLI のプロセッサー一覧とレイテンシの推定値を確認するには、parallel-cli research processors を実行してください。これらは期限を示すものではありません。ユーザーから明示的に依頼され、承認された予算の範囲内である場合に限り、ultra ティアを選択してください。固定のコスト倍率を引用するのではなく、現在の料金を確認してください。

高速版は速度を優先するため、より新しいインデックスデータの使用が少なくなる場合があります。鮮度が重要な作業には標準版が適する場合がありますが、どちらを選んでも、すべてのソースがリアルタイムで取得される保証はありません。調査プロンプトで関連する日付や鮮度の要件を明記し、返された根拠を確認してください。

JSON 出力を解析して、run_id、interaction_id、result_url を保存してください。すぐにユーザーへ次のことを伝えます。

• 詳細な調査を開始したこと
• 選択したプロセッサーの推定所要時間（利用可能な場合）
• 進捗を確認できるモニタリング URL

タスクはサーバー側で実行されます。保存した run_id を使って、後からポーリングを再開できます。

ステップ 2：結果をポーリングする

parallel-cli research poll "$RUN_ID" -o "$FILENAME" --timeout 60

重要：

• 各ポーリングの待機時間には上限を設けてください。--timeout 60 を指定すると、待機の合間に進捗を確認できます。
• 大きなレポートをポーリングする際は、--json を避けてください。-o フラグを指定すると、完全な結果がファイルに保存されます。
• -o "$FILENAME" を指定した場合：
  • $FILENAME.json は常に書き込まれます（メタデータ＋根拠）。
  • $FILENAME.md はテキスト出力が返された場合のみ書き込まれます。通常は --text で指定します。自動スキーマの結果は JSON のみになる場合があります。
  • テキスト出力の場合、JSON ではレポート本文を重複して格納せず、保存された JSON ファイルからの相対パスで output.content_file を参照します。
• エグゼクティブサマリーが出力された場合は、それを共有してください。成功した出力の中にはサマリーがないものもあります。サマリーを作り上げたり、ないことを失敗と見なしたりしないでください。
• 既存の出力ファイルは、--force を明示的に指定しない限り上書きされません。新しいベース名を使用してください。上書きする意図がある場合に限り、--force を使用してください。
• 実際に出力されたパスを確認してください。書き込みエラー時、CLI はシステムの一時ディレクトリにフォールバックする場合があり、書き込みが部分的な場合もあります。再試行する前に、両方の場所を確認してください。一時ストレージにある最終レポートは、永続的に保存されたものとして提示する前に、意図した保存先へコピーしてください。

ポーリングがタイムアウトまたは中断された場合

タイムアウト終了コード 5 または中断によって終了するのはローカルの待機であり、サーバー上のタスクとは限りません。保存済みのタスクを確認してください。

parallel-cli research status "$RUN_ID" --json

同じポーリングを再開するのは、タスクが保留中または実行中の場合に限ってください。完了した出力を取得し、失敗・キャンセル・action_required の状態は正確に報告してください。CLI のポーリングループは action_required を認識できない場合があるため、その状態を無期限にポーリングしないでください。ローカルの待機が終了したという理由だけで、タスクを作り直してはいけません。

回答形式

ステップ 1 の後： 進捗を追跡するためのモニタリング URL を共有します。

ステップ 2 の後：

1. エグゼクティブサマリーが出力された場合は共有します。出力されていない場合は、結果が保存されたことを伝え、必要に応じて、確認した出力だけに基づく簡潔な要約を提供します。
2. 生成されたファイルのパスを伝えます。
   • テキストレポートがある場合は、実際の .md パス
   • メタデータと根拠を含む実際の .json パス（JSON 出力の場合は構造化コンテンツも含まれます）
3. interaction_id を共有し、この調査をもとにした追加質問（例：「X をさらに詳しく調べて」「Y と比較して」）ができることを伝えます。

完了後は、モニタリング URL を繰り返すのではなく、保存したファイルへのリンクを提示してください。

要求された要約や追加質問に回答する際は、レポート全体をコンテキストに読み込まないでください。関連するセクションのみを読み、返された出典を引用してください。

interaction_id を忘れないでください： アカウントがコンテキストの引き継ぎに対応している場合、関連する調査や情報の補足にはこの ID を使用してください。

セットアップ

parallel-cli が見つからない場合は、インストールして認証してください。

/parallel:parallel-cli-setup

ドキュメントに記載されたオプションやコマンドが見つからない場合は、インストール方法を特定し、その方法でアップグレードしてください。単体インストールの場合は parallel-cli update、pipx の場合は pipx upgrade parallel-web-tools、uv の場合は uv tool upgrade parallel-web-tools、Homebrew の場合は brew upgrade parallel-web/tap/parallel-cli、npm の場合は npm update -g parallel-web-cli を実行します。再試行する前に、エージェントのターミナルでバージョンとヘルプを再確認してください。

認証エラーや API エラーが発生した場合は、返されたメッセージを確認してください。403 は権限、アカウントポリシー、または請求に関する問題を示している可能性がありますが、残高不足を証明するものではありません。該当する場合は、認証情報を公開せずに parallel-cli auth --json とその authenticated の真偽値を確認してください。残高を確認するのは請求に関するエラーが明示された場合に限り、資金の追加には明示的な確認が必要です。保存済みのタスク ID を再利用し、作成処理が曖昧な場合に自動で再試行しないでください。