データ エンリッチメント

エンリッチメント: $ARGUMENTS

開始前に

ユーザーに対して、行数とリクエストされたフィールド数に応じて、エンリッチメントに数分かかる可能性があることを通知してください。

オプション: 出力列の提案

ユーザーの意図が曖昧な場合（「これらの企業を有用な情報で充実させて」など）で、どの列を追加するかが不確かな場合は、実行を開始する前に API に提案を求めてください:

parallel-cli enrich suggest "Find CEO and recent funding info" --json

レスポンスはエンベロープ形式です: {title, processor, enriched_columns, warnings}。enriched_columns 配列（エンベロープ全体ではなく）のみを抽出し、それを enrich run の --intent の代わりに --enriched-columns の値として渡してください。この 2 つのフラグは組み合わせではなく、何をエンリッチするかを指定するための代替方法です。suggest が processor を返した場合は、run 呼び出しで --processor を使用して明示的に渡してください（スキーマのための調整済み推奨事項です）。ユーザーが既に追加したいフィールドを指定している場合は、このセクション全体をスキップしてください。

enrich suggest には parallel-cli ≥ 0.3.0 が必要です。no such command / No such command / unknown command のようなエラーで失敗する場合は、中止せず 提案ステップをスキップし、--intent を使用してステップ 1 に進み、実行を完了してください。最終応答で parallel-cli update（または pipx upgrade parallel-web-tools）を記載すれば、ユーザーは次回このフィーチャーを利用できるようになります。

ステップ 1: エンリッチメントを開始する

以下のコマンドパターンの 1 つを使用してください（ユーザーの実際のデータに置き換えてください）:

インラインデータの場合:

parallel-cli enrich run --data '[{"company": "Google"}, {"company": "Microsoft"}]' --intent "CEO name and founding year" --target "output.csv" --no-wait --json

CSV ファイルの場合:

parallel-cli enrich run --source-type csv --source "input.csv" --target "output.csv" --source-columns '[{"name": "company", "description": "Company name"}]' --intent "CEO name and founding year" --no-wait --json

これが以前のリサーチタスクのフォローアップであり、その interaction_id がある場合は、コンテキストチェーンを追加してください:

parallel-cli enrich run --data '...' --intent "..." --target "output.csv" --no-wait --json --previous-interaction-id "$INTERACTION_ID"

エンリッチメントは、その前のリサーチの完全なコンテキストで実行されます。そのため、既に見つかった内容を再度述べることなく、以前発見されたエンティティをエンリッチできます。注意: エンリッチメント自体は新しい interaction_id を生成しないため、その後のフォローアップをエンリッチメントの対象にすることはできません。

重要: ブロックされずに即座にコマンドが戻るように、常に --no-wait を含めてください。

--json 出力をパースして taskgroup_id と url を抽出してください。出力は {taskgroup_id, url, num_runs} です。interaction_id フィールドはありません。探さないでください。ユーザーに直ちに以下を伝えてください:

• エンリッチメントが開始されたこと
• 進行状況を追跡できるモニタリング URL

ポーリングステップをバックグラウンドで実行しながら作業を続けることができることをユーザーに伝えてください。

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

具体的な出力パスを選択してください（例: /tmp/enrichment-acme.json）。注意: 拡張子に関係なく、ファイルは JSON 形式です。CSV ではなく、{input, output} オブジェクトの配列です。自分やユーザーに混同させないよう .json で命名してください。

parallel-cli enrich poll "$TASKGROUP_ID" --timeout 540 --output "/tmp/enrichment-<descriptive-name>.json"

重要:

• ツール実行の制限内に留まるよう --timeout 540（9 分）を使用してください
• ステップ 1 の --target は --no-wait モードでは使用されません。ここでは --output のみが結果の保存場所を決定し、ファイルは常に JSON です

ポーリングがタイムアウトした場合

大規模データセットのエンリッチメントに 9 分以上かかることがあります。ポーリングが完了せずに終了した場合:

1. ユーザーにエンリッチメントがサーバー側で実行中であることを伝えてください
2. 同じ parallel-cli enrich poll コマンドを再実行して続行してください

レスポンス形式

ステップ 1 の後: モニタリング URL を共有してください（進行状況を追跡するため）。

ステップ 2 の後:

1. エンリッチされた行数をレポートしてください
2. 出力ファイルの最初の数行をプレビューしてください（{input, output} オブジェクトの JSON 配列です）
3. 出力ファイルへの完全パスをユーザーに伝えてください

完了後はモニタリング URL を再度共有しないでください。結果は出力ファイルにあります。

セットアップ

parallel-cli（インストール済みで認証済み）が必要です。parallel-cli --version が失敗するか、後のコマンドが認証エラーで失敗する場合は、ユーザーに https://docs.parallel.ai/integrations/cli を確認するよう指示し、停止してください。