告诉 Agent 你要研究哪些公司，由它用支持的公司字段准备 Elasticsearch 查询或 SQL，并选择单批数量。搜索成功可取得匹配公司资料与总命中数，Agent 再将本批记录整理成候选名单。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
People Data Labs
告诉 Agent 你要研究哪些公司，由它用支持的公司字段准备 Elasticsearch 查询或 SQL，并选择单批数量。搜索成功可取得匹配公司资料与总命中数，Agent 再将本批记录整理成候选名单。
取得一批符合条件的公司资料，可包含公司名称、PDL ID 及来源提供的其他信息。总命中数统计整个查询的匹配记录，不是本批已取得的条数。返回的续页标记可用于继续同一查询。Agent 再依据这些记录整理便于阅读的候选名单。
查找[加拿大的软件公司]，列出公司名称、官网和行业。最多返回[10 家]，告诉我一共找到多少家，但先只看这一组。
一批记录不代表已取得 total 所示的全部结果，数据集也不保证覆盖每一家公司。部分属性可能未知或过时。符合筛选条件，不等于独立确认了每项公司事实，也不是按业务适合程度排名。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
公司筛选请求body | object | 选填 | 请求设置，包含 query 或 sql 中的一种，以及按需选择的单批数量、格式和分页 token。不要同时填写 query 与 sql。 |
本批最多记录数body.sizeanyOf · 1 | integer | — | 1–100的整数，默认1。设置本批最多请求多少条已有匹配记录，不是整个查询的总命中数。
|
Elasticsearch 公司查询body.queryanyOf · 1 | object | — | 使用支持的公司字段和查询类型构成的 Elasticsearch 查询对象。选此方式时不填写 sql；字段名称和值应依据 PDL 公司字段映射。 |
返回内容阅读缩进body.prettyanyOf · 1 | boolean | — | 是否为 JSON 返回内容添加便于阅读的缩进。默认 false，只调整格式，不改变公司记录。
|
公司文字的标题式大小写body.titlecaseanyOf · 1 | boolean | — | 是否将返回文字按英文标题式大小写显示。默认 false，这是文字格式设置，不是核实公司事实。
|
下一批继续位置body.scroll_tokenanyOf · 1 | string | — | 上一批搜索响应中的 token。保持原查询，用它请求下一批；继续一批属于另一次请求。 |
SQL 公司查询body.sqlanyOf · 2 | string | — | 用 SQL 字符串表达公司条件，如 SELECT * FROM company WHERE ...。选此方式时不填写 query。PDL 忽略所选列及 SQL LIMIT，单批数量用 size 控制。 |
本批最多记录数body.sizeanyOf · 2 | integer | — | 1–100的整数，默认1。设置本批最多请求多少条已有匹配记录，不是整个查询的总命中数。
|
返回内容阅读缩进body.prettyanyOf · 2 | boolean | — | 是否为 JSON 返回内容添加便于阅读的缩进。默认 false，只调整格式，不改变公司记录。
|
公司文字的标题式大小写body.titlecaseanyOf · 2 | boolean | — | 是否将返回文字按英文标题式大小写显示。默认 false，这是文字格式设置，不是核实公司事实。
|
下一批继续位置body.scroll_tokenanyOf · 2 | string | — | 上一批搜索响应中的 token。保持原查询，用它请求下一批；继续一批属于另一次请求。 |
{
"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
},
"titlecase": {
"type": "boolean",
"default": false
},
"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
},
"titlecase": {
"type": "boolean",
"default": false
},
"scroll_token": {
"type": "string"
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
}
}
},
"additionalProperties": false
}暂未配置返回字段说明。
用支持的公司字段映射建立筛选。PDL 输入说明接受 term、terms、exists、bool、match、range、match_phrase、wildcard、prefix 和 match_all 查询，不接受聚合、boosting 和自定义评分，查询中的任一数组最多100项。查询不会先清洗或预处理，因此字段名称和值需符合来源映射。
SQL 是表达公司条件的另一种方式，通常写为 SELECT * FROM company WHERE ...。PDL 接受能转换为其支持的 Elasticsearch 查询类型的语句。所选列和 LIMIT 会被忽略，单批数量应由 size 控制。输入说明还将使用 % 的 LIKE 通配条件限制为每次最多20项。
data 表示本次取得的记录，total 表示整个查询的命中数。公司资料中，未知信息可为 null。总数较大或某条资料有值，都不证明覆盖整个市场、信息仍然最新或公司符合你的业务目的。Agent 整理的候选名单和比较，是对实际记录的后续解读。
请求下一批时，保持原查询，并将返回的 scroll_token 作为继续位置。这是另一次请求，不会自动取得全部命中记录。PDL 说明结果取尽时 token 可能为 null，分页结束也可能不再提供 token。分页应符合任务范围与预算；pretty 和 titlecase 仅调整显示格式。
可以先要求最多[10 家公司]。检查返回名单后，再决定是否继续查看；每多查一组都会再扣积分，费用以页面显示为准。
查找[加拿大的软件公司]，列出公司名称、官网和行业。最多返回[10 家]，告诉我一共找到多少家，但先只看这一组。
先检查本次返回的公司名称和资料。把这次列出的数量与一共找到的数量分开说明。AI 助手可以整理已有名称、官网和其他信息，并指出缺少的内容。
total 统计符合查询的全部记录，data 只是这次取得的一批。size 控制本批最多1–100条，默认1。总数不代表这些资料都已取得，也不代表已经逐条核实。
PDL 的 Company Search 输入说明指出，SQL LIMIT 与列选择会被忽略。用 size 控制单批数量，并阅读实际返回字段。Agent 可另行只展示名单所需的资料，但这种展示不会减少原始响应内容。
保持相同查询，传入上一批响应的 scroll_token。每批都需要任务范围和预算内的另一次请求。按 PDL 说明，token 为 null 或不再提供可能表示分页结束；不要把 total 当作已下载条数，也不自动取完剩余记录。
应使用 PDL 支持的查询类型和公司字段。输入说明不接受聚合、boosting 或自定义评分，查询中的任一数组最多100项。SQL 也需转换为相同的受支持查询类型。任意写入对象键，不代表相应字段或功能可以搜索。