告诉 Agent 你想查找的人员条件，用受支持的查询或 SQL 搜索 People Data Labs。工具返回一批匹配的人员资料，Agent 再根据可用姓名、资料 ID 和其他信息整理待核对名单。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
People Data Labs
告诉 Agent 你想查找的人员条件，用受支持的查询或 SQL 搜索 People Data Labs。工具返回一批匹配的人员资料，Agent 再根据可用姓名、资料 ID 和其他信息整理待核对名单。
按指定条件获取一批匹配的人员资料与总命中数；若来源返回续页标记，可用于请求下一批。可用姓名、PDL ID 和其他资料帮助你区分各条记录。Agent 可以另行将本批内容整理成对照表或候选名单，同时保留原查询条件和缺失值。
查找[Stripe 的软件工程师]，最多列出[10 人]。展示每个人的姓名和可查到的职位资料，然后先停在这份名单。
匹配到资料不代表已验证本人身份、当前任职或联系方式可用性。资料内容取决于所选数据集和来源掌握的信息；一批记录不等于全部命中结果。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
人员搜索请求body | object | 选填 | 请求设置，包含 query 或 sql 之一，以及按需使用的单批数量、数据集、返回字段和续页设置。每次只使用一种查询形式。 |
本批人员资料上限body.sizeanyOf · 1 | integer | — | 1–100 的整数，默认 1。限制本批最多返回的匹配人员资料数量，不代表查询总命中数。
|
结构化人员筛选条件body.queryanyOf · 1 | object | — | 使用受支持人员字段和查询操作的 Elasticsearch 查询对象。与 sql 二选一，不能同时提交；字段名称和值应符合 PDL 的人员字段映射。 |
缩进响应内容body.prettyanyOf · 1 | boolean | — | 布尔值，默认 false。设为 true 时请求易读的响应缩进格式，不改变匹配条件。
|
搜索的数据集body.datasetanyOf · 1 | string | — | 选择一个值：all、resume、email、phone、mobile_phone、street_address、consumer_social 或 developer，默认 all。它指定搜索的数据集，不保证每条资料都有相应信息。
|
返回文字使用标题式大小写body.titlecaseanyOf · 1 | boolean | — | 布尔值，默认 false。设为 true 时请求将返回文字显示为标题式大小写，而非默认的小写形式。
|
需要返回的人员字段body.data_includeanyOf · 1 | string | — | 以逗号分隔需要返回的受支持人员字段名，例如 full_name。按任务选择资料，不预先假定这些字段都有值。 |
下一批的续页标记body.scroll_tokenanyOf · 1 | string | — | 上一响应返回的字符串标记，配合原查询请求下一批；它不是页码。首次请求省略此项。 |
SQL 人员筛选条件body.sqlanyOf · 2 | string | — | 使用受支持人员字段的 SQL 字符串，形式为 SELECT * FROM person WHERE ...。与 query 二选一。用 size 设置单批上限；SQL LIMIT 和选定列会被忽略。 |
本批人员资料上限body.sizeanyOf · 2 | integer | — | 1–100 的整数，默认 1。限制本批最多返回的匹配人员资料数量，不代表查询总命中数。
|
缩进响应内容body.prettyanyOf · 2 | boolean | — | 布尔值，默认 false。设为 true 时请求易读的响应缩进格式，不改变匹配条件。
|
搜索的数据集body.datasetanyOf · 2 | string | — | 选择一个值：all、resume、email、phone、mobile_phone、street_address、consumer_social 或 developer，默认 all。它指定搜索的数据集，不保证每条资料都有相应信息。
|
返回文字使用标题式大小写body.titlecaseanyOf · 2 | boolean | — | 布尔值，默认 false。设为 true 时请求将返回文字显示为标题式大小写，而非默认的小写形式。
|
需要返回的人员字段body.data_includeanyOf · 2 | string | — | 以逗号分隔需要返回的受支持人员字段名，例如 full_name。按任务选择资料，不预先假定这些字段都有值。 |
下一批的续页标记body.scroll_tokenanyOf · 2 | string | — | 上一响应返回的字符串标记，配合原查询请求下一批；它不是页码。首次请求省略此项。 |
{
"type": "object",
"required": [],
"properties": {
"body": {
"anyOf": [
{
"type": "object",
"required": [
"query"
],
"properties": {
"size": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"pretty": {
"type": "boolean",
"default": false
},
"dataset": {
"enum": [
"all",
"resume",
"email",
"phone",
"mobile_phone",
"street_address",
"consumer_social",
"developer"
],
"type": "string",
"default": "all"
},
"titlecase": {
"type": "boolean",
"default": false
},
"data_include": {
"type": "string"
},
"scroll_token": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"sql"
],
"properties": {
"sql": {
"type": "string"
},
"size": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1
},
"pretty": {
"type": "boolean",
"default": false
},
"dataset": {
"enum": [
"all",
"resume",
"email",
"phone",
"mobile_phone",
"street_address",
"consumer_social",
"developer"
],
"type": "string",
"default": "all"
},
"titlecase": {
"type": "boolean",
"default": false
},
"data_include": {
"type": "string"
},
"scroll_token": {
"type": "string"
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
}
}
},
"additionalProperties": false
}暂未配置返回字段说明。
查询条件应对应 People Data Labs 的人员字段及其映射；查询直接作用于这些值，不自动清洗或预处理。支持的 Elasticsearch 查询类型是 term、terms、exists、bool、match、range、match_phrase、wildcard、prefix 和 match_all。PDL 不支持聚合与自定义评分，每个查询数组最多包含 1,000 项。
SQL 使用 SELECT * FROM person WHERE ...，且必须能转为上述受支持的查询操作。PDL 会忽略选定列和 SQL LIMIT；用 size 设置单批上限，用 data_include 选择返回字段。带 % 的 LIKE 表达式最多使用 20 个通配项。判断结构化字段时，应使用实际子字段，如 experience.title.name，而非整个 experience 对象。
数据集从输入说明列出的值中选择一个。data_include 是受支持人员字段名组成的逗号分隔列表，可用于缩小返回资料范围。官方响应中的 data 表示本批资料，total 表示查询总命中数，scroll_token 是下一批的续页标记。来源未知的资料值为 null；选择字段或数据集类别不保证存在联系方式。
续页沿用原查询和最近返回的 scroll_token。PDL 说明，标记为 null 或不存在可能表示分页结束；不要把 null 作为输入标记。每批续页都是另一次请求，应在达到所需范围时停止。pretty 和 titlecase 只改变显示格式，不提高资料准确性或时效性。
可以先要求最多[10 人]。也可说明你关心[目前职位和工作经历]。检查第一份名单后再决定是否继续；下一组会作为额外请求，并使用页面显示的积分。
查找[Stripe 的软件工程师]，最多列出[10 人]。展示每个人的姓名和可查到的职位资料，然后先停在这份名单。
先检查返回的姓名和工作资料，把这次名单与一共找到的人数分开说明。助手可以整理候选名单并标出缺少的信息；你没有要求前，不会继续查下一组。
总命中数统计符合查询条件的记录，size 只限制本批最多返回 1–100 条，默认 1。应分别查看本批条数与总命中数；总数较大不代表这些资料已全部获取。
用 data_include 提供逗号分隔的受支持人员字段名；SQL 的选定列不会缩小响应范围。所需字段仍可能缺失，选择邮箱或电话数据集也不代表能获得可用联系方式。
不能。搜索是在 PDL 存储的人员资料中匹配条件。公司关联、姓名或其他资料可供核对，但不构成当前任职或身份验证。缺失值应保留，需要据此决策的事实应另行确认。
先明确要核对的批次数或资料数量。需要下一批时，沿用原查询和返回的续页标记；每批都是另一次请求，须在既有授权和预算内。达到所需范围，或来源表示分页结束时停止。