人物検索
監査可能な候補リストを作成します。スキル自体がLinkedInデータへのアクセスを付与しているように見せかけてはいけません。
データモードの選択
すでに利用可能な最も強力なモードを使用してください：提供されたCSV/プロフィール/エクスポート、公開ウェブ検索、認証された承認済みセッション、またはHarvestAPIやApifyなどの接続済みプロバイダー。発見ソースがない場合は、正規化された検索計画、実行可能なフィルター、および入力テンプレートを返します。決してプロフィールを作成してはいけません。
ワークフロー
- リクエストを正規スキーマに変換します。
- ハード要件とランキング選好を分離します。あいまいな基準は、明示的に必須でない限り選好として扱います。
- 選択したモードとそのカバレッジの制限を明示します。
- 正規フィルターをプロバイダーフィールドにマッピングし、適用、近似、削除、または未対応のフィルターをすべて開示します。
- 有料/フル検索の前に、最も安価で有用なカナリア検索を実行します。無効、黙示的に空、またはターゲット外の結果では停止します。
- 安定したプロフィールURL、次に正規化された名前と現在の企業で重複排除します。
- 元の依頼に対してランキングし、エビデンスURLを保持し、事実と推測を区別します。
- 候補リスト、検索レシピ、注意点、および最も価値の高いリファインメントを返します。
境界
- スキルはオーケストレーションであり、データライセンスではありません。組み込みのLinkedInアクセスを決して示唆してはいけません。
- プロバイダーの認証情報を公開、埋め込み、または永続化してはいけません。
- 有料検索の前にコストのかかるモードを明確にし、プレビューと段階的な拡張を優先します。
- リクエストの有効性とフィルターサポートを確認するまでは、結果がゼロであっても該当人物がいないと解釈してはいけません。
- 個別の承認なしに接続リクエストやメッセージを送信してはいけません。
アダプターの動作と結果契約については、references/provider-contract.mdを参照してください。
決定論的ランナー
scripts/people_search.pyを、計画のみ、CSVインポート/ランキング、およびプロバイダーカナリア実行に使用します。プロバイダーの認証情報は、プロセススコープの名前付き環境変数を通じて入力する必要があります。トークンを引数として渡してはいけません。