parallel-findall

FindAll：エンティティの検出

検索対象：$ARGUMENTS

FindAll の完全な機能を利用するには parallel-cli ≥ 0.3.0 が必要です。オプションの entity-search の経路には ≥ 0.6.0 が必要です。記載されているコマンドやオプションが見つからない場合は、この CLI で使用したインストール方法に従って更新し、再試行してください。https://docs.parallel.ai/integrations/cli を参照してください。

このスキルを使う場面

説明に一致するエンティティの構造化されたリストが必要な場合は、FindAll を使用してください。ウェブページの検索や簡単な回答には parallel-web-search、文章形式の分析には parallel-deep-research、ユーザーがすでに持っているリストへの項目追加には parallel-data-enrichment を使用してください。

包括的な非同期処理の findall run をデフォルトで使用してください。一致条件、除外、エンリッチメント、エビデンスに対応し、企業や人物以外のエンティティタイプも扱えます。「すべてを検索」しても、インターネット上の情報を網羅できるとは限りません。

ユーザーが企業または人物の簡易的なリストを明示的に求め、個々の検証なしの結果を受け入れる場合に限り、同期処理の entity-search の経路を使用してください。エンティティタイプが対応しているという理由だけで選択しないでください。この経路には除外、ジェネレーターの選択、エンリッチメント、FindAll の条件やエンリッチメントに関する引用機能はありません。

Step 1：実行を開始して記録する

保存する JSON ファイルに、未使用で説明的な実行固有の $FILENAME を選びます。ユーザーの目的は、シェルで評価されないように引用符で囲んだ単一の引数として渡してください。

parallel-cli findall run "$ARGUMENTS" --no-wait --json -o "/tmp/$FILENAME-create.json"

デフォルトのジェネレーターは core、一致件数の上限は 10 です。一致するエンティティを最大 50 件取得するには -n 50 を使用します。指定できる上限は 5～1000 です。ユーザーが別のトレードオフを希望しない限り、core を使用してください。pro はより広範囲を検索しますが、処理に時間がかかり、コストも高くなります。base は、ユーザーが簡易スキャンを明示的に求めた場合に使う、より高速で品質の低い選択肢です。特に base では、バッチ、年、地域などの具体的な主張を、利用可能なエビデンスに照らしてスポットチェックしてください。

除外条件が指定されている場合：

parallel-cli findall run "$ARGUMENTS" --no-wait --json \
    --exclude '[{"name":"Google","url":"google.com"},{"name":"OpenAI","url":"openai.com"}]' \
    -o "/tmp/$FILENAME-create.json"

目的を明確にする必要がある場合は、parallel-cli findall ingest "$ARGUMENTS" --json を実行すると、推定されたエンティティタイプ、条件、推奨されるエンリッチメントをプレビューできます。これは API を呼び出すため、オフラインまたは無料のテストではありません。推定された条件がユーザーの意図と異なる場合は、実行を作成する前に目的を調整してください。

返された findall_id をただちに取得し、目的、ジェネレーター、一致件数の上限、除外条件とともに記録してください。実行が開始されたことを伝え、実際に返された場合に限り、監視用 URL を提示してください。URL や完了予定時刻を推測してはいけません。作成レスポンスが失われた場合は、再送信する前に既存のジョブを確認してください。

Step 2：要求された項目を明示的に追加する

--no-wait はデータを取り込み、実行を作成しますが、推奨されたエンリッチメントは適用しません。CEO の氏名や従業員数など、要求された出力項目には別途エンリッチメントのリクエストが必要です。目的に記載するだけでは不十分です。

parallel-cli findall enrich "$FINDALL_ID" \
    '{"type":"object","properties":{"ceo":{"type":"string","description":"CEO name"},"employee_count":{"type":"number","description":"Number of employees"}}}' \
    -p core --json

完全な取り込みエンベロープではなく、ユーザーが要求した項目を記述する JSON Schema オブジェクトを使用してください。複数のリクエストを使用した場合も含め、実行 ID とともに、実際に送信したスキーマとプロセッサをそのままローカルに保存してください。後からスキーマの要約を使って再構成しようとしてはいけません。エンリッチメントはブール値以外の出力データを追加しますが、一致条件は変更しません。

エンリッチメントは、実行中または完了後に追加できます。終了状態になった実行でも、項目を処理するために再キューイングできます。作成、エンリッチメントの受け付け、結果への反映はそれぞれ別の状態です。エンリッチメントのレスポンスを受け取っただけ、またはポーリングが完了しただけで、項目が利用可能になったと主張してはいけません。

ステップ 3：ステータスを確認し、結果を取得する

parallel-cli findall status "$FINDALL_ID" --json
parallel-cli findall poll "$FINDALL_ID" -o "/tmp/$FILENAME.json" --timeout 60
parallel-cli findall result "$FINDALL_ID" -o "/tmp/$FILENAME-snapshot.json"

待機時間には上限を設けてください。タイムアウト（終了コード 5）や割り込みはローカルでの待機の終了であり、キャンセルではありません。実行がアクティブな間は、ユーザーの待機時間内にステータスを確認し、同じ ID で再開してください。別の実行を送信してはいけません。共有ポーラーは互換性ステータス action_required を認識しません。そのステータス、failed、cancelled、または未完了かつ非アクティブな状態が表示された場合は、自動待機を停止し、対応が必要な状態と保存済み ID を報告してください。

result はスナップショットを返すもので、完了を証明するものではありません。status と is_active をあわせて確認してください。エンリッチメント後は、一致した各候補の output を確認し、要求されたすべてのフィールドがあるか調べてください。フィールドが欠けている場合は、最初のポーリングで完了と表示されていても、上限のある待機時間内に追加の結果スナップショットを取得してください。欠落値、null 値、失敗した値は作り上げず、そのまま報告してください。待機時間が終了した場合は、部分的な結果と再開用の ID を返してください。一致する候補が空でも、エンリッチメントの成功を証明するものではありません。

大規模な結果セットでは --json を避けてください。-o は完全な JSON を保持します。これらのコマンドは指定したファイルを上書きすることがあるため、この実行用のパスを使用してください。生の候補リストとステータスを保持してください。/tmp は一時的な場所です。必要に応じて、要求された成果物をユーザーの永続的な保存場所にコピーしてください。

一致候補と根拠を提示する

match_status: "matched" の候補のみを一致候補として提示してください。生成済み、不一致、破棄済みの候補は生ファイルに保持してください。クエリをそのまま反映した明らかなプレースホルダーや、裏付けのない項目を確認し、すべての候補を実体として扱わないでください。

エンティティの文脈で URL を確認してください。LinkedIn のプロフィールが人物を正しく特定する場合や、YC または Crunchbase のプロフィールが企業を特定する場合もあります。エンティティがそのドメインを所有していないという理由だけで、これらを破棄しないでください。URL がない場合や検証できない場合は、その旨を示し、利用可能な根拠に基づいて不確実性を解消してください。

事実に関する主張には、根拠とエンリッチメントの根拠をその出典 URL とともに使用してください。エンティティの主 URL と、裏付けとなる引用元は異なる場合があります。属性に関する主張を裏付けない限り、主 URL やプロフィール URL をその属性の根拠として示さないでください。

提示する一致エンティティの件数を最初に示し、除外した項目や未解決の項目があれば記載してください。名前、URL、要求されたフィールドを表またはリストで提示してください。保存済みの生の結果のパス、実行 ID、現在の状態、不完全なフィールドを記載してください。結果が少ない、またはノイズが多い場合は、目的やジェネレーターの修正を提案するのが妥当です。代わりとなる有料の実行を自動的に作成してはいけません。

一致候補を追加で取得する

ユーザーが追加の一致候補を要求した場合にのみ拡張してください。

parallel-cli findall schema "$FINDALL_ID" --json
parallel-cli findall extend "$FINDALL_ID" 50 --json

50 は追加数であり、新しい合計数ではありません。既知の作成上限または現在のスキーマを確認し、過去の拡張分も含めて、拡張後の合計が 1000 以下になるようにしてください。プレビュー実行は拡張できません。完了済みの実行を拡張できるのは、終了理由が match_limit_met の場合に限られます。CLI のステータス／結果にはこの理由が表示されないため、それだけでは適格性を証明できません。上限内の拡張を明示的に要求された場合は、API に適格性を検証させ、新しい実行を自動作成することなく、拒否された場合はその内容を提示してください。

更新後の上限を保持し、新しい結果を得るために同じ ID をポーリングしてください。要求されたエンリッチメントフィールドを再確認してください。既存のエンリッチメントを再適用する必要がある場合は、保持している元のリクエストペイロードとプロセッサーを使用し、ユーザーが許可した範囲内で行ってください。

高速エンティティ検索

明示的に速度重視または大まかな一覧を求めており、エンティティタイプが companies または people の場合にのみ使用してください。これは同期処理で、findall_id や検証済み候補ではなく、entity_set_id とランク付けされた entities を返します。

parallel-cli findall entity-search "$ARGUMENTS" -t companies -n 10 -o "/tmp/$FILENAME.json"

-n の上限は 5～1000 で、既定値は 10 です。ユーザーの依頼に応じた上限を選択してください。この方法では、条件を過度に絞り込まないでください。結果の後半ほど関連性が低下する場合があります。個々の条件の確認や情報の補完が必要な場合は、通常の FindAll を使用してください。

有効なディレクトリリンクやプロフィールリンクは残し、空の URL やクエリをそのまま反映した名前がないか確認してください。これらは未検証の手がかりとして提示し、エンティティへのリンクとして引用してください。FindAll による根拠や検証がないものについて、そのような根拠や検証があるかのように記載しないでください。保存先のパスと返された件数を報告してください。entity_set_id を FindAll の poll/status/result/enrich/extend に渡してはいけません。ユーザーが後からそれらの機能を求めた場合は、別途通常の実行が必要であることを説明し、元の高速検索の結果はそのまま保持してください。

セットアップ

インストール済みで認証された parallel-cli が必要です。parallel-cli --version と parallel-cli auth --json を確認してください。認証コマンドは、authenticated が false でも正常終了する場合があります。バイナリがない場合、コマンドまたはオプションがサポートされていない場合、認証に失敗した場合では、それぞれ必要な対処が異なります。順に、インストール、既存のインストール方法によるアップグレード、ターミナルでのログインが必要です。https://docs.parallel.ai/integrations/cli を参照してください。認証に失敗した場合は、該当する依頼の処理を停止してください。チャットでシークレットを尋ねたり、セットアップのブロックを回避するためにアカウントポリシーを変更したりしないでください。