用英文说明想找什么样的专业人士，按需补充职位、公司或地点条件，并选择希望获取的资料。Ploid 返回匹配人员供你阅读；你的 Agent 再单独整理候选名单。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Ploid
用英文说明想找什么样的专业人士，按需补充职位、公司或地点条件，并选择希望获取的资料。Ploid 返回匹配人员供你阅读；你的 Agent 再单独整理候选名单。
获得匹配人员的资料集合，可包含请求的姓名、职位、公司、地点或 LinkedIn 资料引用，具体以可用内容为准。先阅读返回资料，决定进一步研究哪些人，再让 Agent 整理对照表并标明缺失信息。
在[旧金山]为[Stripe]查找最多[10]位[软件工程师]。尽可能列出姓名、职位和 LinkedIn 个人资料链接，并整理为候选名单；缺少的信息请标明。
这些结果是候选人研究的起点。匹配和排序不能核实身份、当前任职、是否能联系到本人或是否适合岗位。请求的资料可能缺失，返回名单也不能证明已覆盖所有符合描述的人。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
人员搜索请求body | object | 必填 | 必填请求对象，包含要查找的人群，以及按需选择的检索方式、筛选条件与结果资料。
|
检索模式body.type | string | 选填 | 可选 instant、auto 或 deep，分别对应快速检索、检索后重新排序或更深入的评估流程；auto 是描述中的默认模式。
|
要查找的人群body.query | string | 必填 | 必填英文人群描述，长度 1–4000 字符。写明任务关注的职位、公司或地点。
|
筛选条件body.filters | object | 选填 | 可选对象，按需用职位、公司和地点条件缩小描述的人群范围。 |
职位body.filters.title | string | 选填 | 可选职位文本，用于进一步筛选人群。 |
公司body.filters.company | string | 选填 | 可选公司文本，用于缩小要查找的人员范围。 |
地点body.filters.location | string | 选填 | 可选地点文本，填写人员搜索任务关注的地区。 |
请求的人员资料body.contents | object | 选填 | 可选对象，用于选择希望随匹配结果获取的可用人员资料类别。 |
人员资料选择body.contents.fields | array | 选填 | 可选数组，请求 linkedin、title、company、location 或 name 类别；选择某项不保证对应资料可用。 |
一项人员资料类别body.contents.fields[] | string | — | 选择中的一项，取值为 linkedin、title、company、location 或 name。
|
请求人数上限body.num_results | integer | 选填 | 可选整数，范围 1–100。描述中的默认值为 25；它设置人数上限，不是保证的匹配数量。
|
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"type": {
"enum": [
"instant",
"auto",
"deep"
],
"type": "string",
"description": "instant 快速检索；auto 为默认检索与重排；deep 使用更深的筛选路径。"
},
"query": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "用自然语言描述要找的人，例如位于旧金山的金融科技公司软件工程师。"
},
"filters": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"company": {
"type": "string"
},
"location": {
"type": "string"
}
},
"description": "用于缩小范围的可选结构化筛选条件。"
},
"contents": {
"type": "object",
"properties": {
"fields": {
"type": "array",
"items": {
"enum": [
"linkedin",
"title",
"company",
"location",
"name"
],
"type": "string"
}
}
},
"description": "每条人员结果需要包含的字段。"
},
"num_results": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "最多返回的人员数量，默认 25，最高 100；按每开始的 10 条返回结果计费。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
query 用于描述要找的人，而不是要求一份泛泛的招聘报告。可将职位、公司和地点组合成具体目标。必填描述长度为 1–4000 字符，说明要求使用英文；Agent 可先将中文需求译成英文再搜索。
filters 提供 title、company 和 location 三项独立条件。条件应与人员描述一致，写明真正关注的公司或地点。匹配条目仍需阅读，不能据此认定本人目前满足每项要求。
contents.fields 可请求 linkedin、title、company、location 和 name 这些资料类别。它们表达希望获取的内容；应以实际返回为准。公司、职位或资料引用缺失，不能证明本人没有这些信息。
instant 对应说明中的快速检索，auto 对应检索后重新排序，deep 对应更深入的评估流程；auto 是描述中的默认模式。num_results 可设 1–100 人上限，描述中的默认值为 25；这并不保证返回相同人数。
取得结果后，Agent 可将人员分组、比较来源提供的资料，并列出后续研究问题。打开资料引用、核对当前情况属于另外的步骤。排序名单不是招聘评估，也不保证提供联系方式。
可要求显示[姓名]、[职位]或[LinkedIn 个人资料链接]，并把人数上限设为[10]。实际结果可能更少。即使找到的人数不足[10]人，也可能按一组收费。开始前先查看页面显示的最高费用。
在[旧金山]为[Stripe]查找最多[10]位[软件工程师]。尽可能列出姓名、职位和 LinkedIn 个人资料链接，并整理为候选名单；缺少的信息请标明。
打开个人资料链接，确认这些人是否符合要求。缺少的信息留空；这是一份候选名单，不代表公司所有员工。
使用筛选条件时也需要填写 query。先用英文说明要找的人，再按需补充职位、公司或地点条件。Agent 可以在保留原意的前提下翻译中文要求。
模式本身没有这样的保证。instant、auto 和 deep 分别说明快速检索、检索后重新排序和更深入的评估流程。按任务选择，再阅读返回资料是否符合需要；这些模式都不能据此核实当前任职或岗位适合性。
资料选择是在请求可用类别，不能补出缺失内容。人数设置也是上限，不是保证的匹配数量。比较人员时应明确保留缺失项，不能将其解读为职位、公司或个人资料不存在。
这份资料集合适合发现人员并继续研究，不承诺邮箱、电话、已核实的当前职位或录用适合性。Agent 可整理返回资料；寻找联系方式和评估候选人还需要另外的信息与工作。