list-enrichment

テーブルのエンリッチメント

調査に基づくエンリッチメント列を Extruct の企業テーブルに追加します。

Extruct API 操作

このスキルでは、Extruct API の呼び出しをすべて extruct-api スキルに委任します。

Extruct API 操作を行う際は、skills/extruct-api/SKILL.md の手順を読み、それに従ってください。

テーブルの読み取り、列の作成、エンリッチメントの実行、進捗確認、データ取得はすべて extruct-api スキルが処理します。このスキルでは、エンリッチメントの対象と列の設計方法に焦点を当て、API の実行は extruct-api スキルが担当します。

ワークフロー

1. テーブルを確認する

ユーザーからテーブル ID（URL または ID）を取得します。extruct-api スキルを使ってテーブルのメタデータを取得します。テーブル名、行数、既存の列をユーザーに提示します。

2. 列の設定を取得する

次のいずれかの方法を使います。

方法 A：enrichment-design から取得 — ユーザーが column_configs を用意しています。確認して次に進みます。

方法 B：その場で設計する — 次の項目をユーザーに確認します。

1. どのデータ項目か？ — 調査する対象（例：「資金調達ステージ」「主要な業種」「技術スタック」）
2. 出力形式 — 適切な形式を選びます。

形式	使用する場合	追加パラメーター
text	自由形式の調査結果	—
number / money	数値データ（売上高、従業員数）	—
select	既知のカテゴリから 1 つ選択	labels: [...]
multiselect	既知のカテゴリから複数のタグを選択	labels: [...]
json	複数フィールドからなる構造化データ	output_schema: {...}
grade	1～5 のスコア	—
label	リストから 1 つのタグを選択	labels: [...]
date	日付の値	—
url / email / phone	連絡先情報	—

3. エージェントの種類 — デフォルトは research_pro です。ウェブ調査が不要な場合（既存のプロフィールデータに基づく分類）は llm を使います。

3. プロンプトを作成する

行のドメイン値を表す {input} を使って、明確なプロンプトを作成します。プロンプトのガイドライン：

• 調べる内容を具体的に指定します
• 出力形式をプロンプト内で正確に指定します（例：「USD 百万単位の数値のみを返してください」）
• 該当する情報が見つからない場合の指示を含めます（例：「見つからない場合は N/A を返してください」）
• select / multiselect では、ラベルによって出力が制限されます。プロンプトでどのラベルを選ぶべきかを指示してください

4. 列を作成する

column_configs 配列を指定して、列の作成を extruct-api スキルに委任します。

5. エンリッチメントを実行する（新しい列のみ）

エンリッチメントの実行を extruct-api スキルに委任します。実行対象は、必ず新しく作成した列のみに限定してください。特定の列のみをエンリッチメントする場合は、対象範囲の広い、または暗黙的な実行ペイロードを避けてください。

6. 進捗を監視する

進捗の監視を extruct-api スキルに委任します。テーブルデータをポーリングし、セルのステータスを確認する際に使用します。

ユーザーに次の情報を提示します。

• 現在の完了率（完了したセル数 / 全セル数）
• 失敗したセルの数（該当する場合）
• 推定残り時間（これまでの処理速度に基づく）

すべてのセルが完了または失敗したら、ポーリングを停止します。

7. 品質をサンプルチェックする

エンリッチメント完了後（または 50% 以上完了した時点）に、エンリッチメント済みの行を 5～10 件サンプル取得し、確認用に表示します。

ユーザーにはテーブル形式で提示します。 次の点を確認します。

• 「データ品質は適切ですか？」
• 「意味のない値や N/A が頻繁に返される列はありますか？」
• 「プロンプトを調整して再実行しますか？」

品質上の問題が見つかった場合：

1. 問題のある列を削除します
2. プロンプトを調整します
3. 列を再作成して、エンリッチメントを再実行します