# 将 Ploid 接入 Open Flow

Source: https://openflow.run/zh-cn/integrations/ploid/

[全部集成](https://openflow.run/zh-cn/integrations/)

![](https://static.oomol.com/logo/third-party/ploid.svg)

找到相关人物，将有来源的资料整理为结构化研究结果。

*   [47 个工具](https://openflow.run/zh-cn/integrations/ploid/#integration-actions)
*   API 密钥
*   数据与分析

[连接 Ploid](https://console.openflow.run/connections/ploid)

每月 20,000 次免费应用调用（付费服务另计）

## 可以做什么

Ploid 提供人物搜索、身份解析、公开社交资料、联系方式补全、数据集及定时监测。持久研究可通过状态查询与分页结果继续读取。

### 人物与社交研究

基于公开职业与社交来源搜索、解析和补全人物。

### 数据集与 People Sets

建立持久的条件验证名单，或为已有行填充带证据的列。

### 定时监测

编译、创建、运行和查询监测，支持 webhook 投递测试。

### 账户与上下文聊天

读取用量和预算，管理账户资料并请求带上下文的聊天回复。

## 所有工具

47 个工具

### Search People Candidates

按姓名词项及公司、地点、职位筛选，返回最多 10 个索引资料。需要 people:search；旧版完整权限密钥也可使用。成功搜索（含零匹配）计 1 ACU，失败免费；不启动研究或补全。可用幂等键避免重复计费。索引身份和任职信息未经验证；调用深度人物研究前应确认目标，首次成功资料计 25 ACU。无完整计数或分页；工作区限每分钟 30 次、每小时 300 次，仍受账户资格、余额、自动充值与密钥预算约束。

`ploid.search_people_candidates`

### Get Open Api Document

获取 OpenAPI 3.1 契约，此上游端点无需鉴权。

`ploid.get_open_api_document`

### Get Harness Context

读取调用者的用户、公司及相关记忆上下文，不运行模型。需要 agent:chat。

`ploid.get_harness_context`

### Create Harness Chat Completion

使用 Ploid 模型路由和工具定义生成非流式聊天回复。需要 agent:chat；请求大小和工具数量限制由上游执行。

`ploid.create_harness_chat_completion`

### Sync People Search

每次同步返回最多 150 人；async:true 或更大的 num\_results 创建后台 People Set，返回 202 和 set\_id、items\_url、events\_url。instant 使用索引排序；fast 编译查询，从至少 200 人（或更大的三倍请求数量）候选池按职位、地点、雇主、关键词、行业和资历排序，不做网页验证。auto/deep 研究完整查询和筛选条件，排除不确定及未通过的结果；人数不足时执行一次有限网页补充。auto/deep 单轮验证预算分别为 30/45 秒，补充发现为 45/60 秒，整个验证阶段为 60/120 秒。partial 表示人数不足或到期，coverage.has\_more 表示仍有候选人。大量持久研究使用 Sets。验证是基于证据的模型评估，不是身份认证。需要 people:search。

`ploid.sync_people_search`

### List Company Recruiters

结合实时 LinkedIn、网页和 Ploid 索引，返回招聘人员、职位计数及计数完整性。跳过占位公司名；每次最多 10 家，按去重后的非占位公司返回匹配计费。需要 people:search。

`ploid.list_company_recruiters`

### Resolve Person

根据全名和至少一条线索（公司、域名、职位、地点、地址、邮箱或电话），结合索引与实时网页识别一个人。返回可用于人物研究和补全的永久 person\_id。找到时计 2 ACU，无匹配免费；结果为模型评估而非身份认证。需要 people:search。

`ploid.resolve_person`

### Get Person

获取已审核的深度人物资料。合格缓存直接返回 200，旧缓存可能同时排队刷新；未见人物或需重审快照返回持久 202 任务。新研究可能耗时数分钟，应轮询任务 ID。不确定身份最终返回 data:null、resolution:unsure 及原因。首次成功资料计 25 ACU，组织内 90 天重读免费；失败、不确定或未找到免费。当前审核投影不填充现任职位、年龄及社交受众和活跃指标。

`ploid.get_person`

### Get Person Run

轮询深度人物研究任务。

`ploid.get_person_run`

### Cancel Person Run

取消深度人物研究任务。

`ploid.cancel_person_run`

### Compile Monitor

将自然语言查询编译为目标、事件和相关性条件；object 输出缺少 schema 时自动推导。不创建资源。编译和创建计 1 ACU；运行按抓取目标和发出条目各计 1 ACU，基线不发出条目。

`ploid.compile_monitor`

### Create Monitor

创建 LinkedIn、X、Instagram 或 TikTok 定时监测，并启动静默基线。meta.baseline\_run\_id 为基线任务，meta.unresolved 为未能解析成目标的提及。编译和创建计 1 ACU；运行按抓取目标和发出条目各计 1 ACU，基线不发出条目。

`ploid.create_monitor`

### List Monitors

列出监测任务。

`ploid.list_monitors`

### Get Monitor

获取监测任务。

`ploid.get_monitor`

### Update Monitor

修改 query 会重新编译计划；提供 plan 会替换目标。两者都会启动新基线。

`ploid.update_monitor`

### Delete Monitor

删除并停用监测任务。

`ploid.delete_monitor`

### Run Monitor

立即启动一次运行。

`ploid.run_monitor`

### Test Monitor

试运行：立即抓取目标并按相关性返回最多 max\_items\_per\_run 个最新条目，不保存任务、条目、已见记录或快照，不发送 webhook，不改计划。already\_seen 表示正式运行不会重复发送。基线前后均可用；按抓取目标计 1 ACU，不收条目或输出提取费用，条目含 source 而非 output。

`ploid.test_monitor`

### Test Monitor Webhook

立即向 webhook\_url 发送 monitor.webhook.test；配置密钥时签名。返回 HTTP 结果，仅尝试一次，不重试、不计 ACU。

`ploid.test_monitor_webhook`

### List Monitor Runs

列出运行记录。

`ploid.list_monitor_runs`

### Get Monitor Run

获取运行记录。

`ploid.get_monitor_run`

### List Monitor Items

列出已发出的条目。

`ploid.list_monitor_items`

### Create Dataset

为人物、公司或自定义实体填充最多 30 列；同步最多 25 行，异步最多 2000 行。每格含融合答案、0..1 置信度和公开证据。同步在 deadline\_ms（默认 20000）内返回，未完成格标记 timeout；异步返回 202，轮询数据集并分页读取行。仅命中计费：每 10 个标准格 1 ACU 向上取整，自定义格或工作邮箱各 1，私人邮箱 3，电话 10。not\_found、unverified、timeout 免费。密钥预算先预留全命中上限再释放差额。需要 people:search。

`ploid.create_dataset`

### Get Dataset

读取当前工作区数据集的状态、列和进度。需要 people:search。

`ploid.get_dataset`

### List Dataset Rows

按输入顺序返回行及单元格；异步进行中可读取，待完成行在填充前暂呈 timeout。需要 people:search。

`ploid.list_dataset_rows`

### Search Github Accounts

按 AND 条件检索 GitHub 索引，至少提供一项条件。有 query/company 时按相关性，否则按合并 PR 和提交量排序；sort 可选择活动排名。offset 最深 1000 条，末页自动缩短。include\_profiles 返回实时公开资料，此时 limit 默认且最多 10。每次成功搜索 1 ACU，每个实时资料额外 1，失败免费。不返回邮箱或电话。需要 people:search。

`ploid.search_github_accounts`

### Search Github People

搜索 GitHub 账户、读取实时资料，再关联其声明的 LinkedIn 或姓名与雇主/地点一致的唯一索引人物；歧义时不关联。LinkedIn 条件为硬筛选。按扫描账户推进分页，返回人物可少于扫描数，应跟随 next\_offset；每页最多 10 账户。成功搜索 1 ACU，每个返回人物再计 1，失败免费；不返回邮箱和电话。需要 people:search。

`ploid.search_github_people`

### Enrich Social Profile

根据支持平台的 handle 或 URL 解析公开资料。需要 people:enrich。

`ploid.enrich_social_profile`

### Get Linkedin Profile

根据 URL、自定义短名或 @handle 读取 LinkedIn 资料。需要 linkedin:read。

`ploid.get_linkedin_profile`

### Search Linkedin People

按关键词、地点、职位、公司和学校进行结构化 LinkedIn 人物搜索。需要 linkedin:read。

`ploid.search_linkedin_people`

### List Linkedin Posts

读取 LinkedIn 个人资料的近期帖子。需要 linkedin:read。

`ploid.list_linkedin_posts`

### List Linkedin Profile Comments

根据身份标识读取 LinkedIn 数据。需要 linkedin:read。

`ploid.list_linkedin_profile_comments`

### Get Linkedin Company

根据身份标识读取 LinkedIn 数据。需要 linkedin:read。

`ploid.get_linkedin_company`

### List Linkedin Company Posts

根据身份标识读取 LinkedIn 数据。需要 linkedin:read。

`ploid.list_linkedin_company_posts`

### Enrich Person

使用 LinkedIn URL、永久 person\_id、邮箱或姓名加公司域名解析联系方式。请求 work\_email、personal\_email、phone；各字段返回 found/not\_found/unavailable、置信度、来源和最后见到时间。usage 明确列出计费及未找到项。也保留官方轻量 LinkedIn 资料模式；深度公开证据用人物研究。需要 people:enrich。

`ploid.enrich_person`

### Get Credits

读取工作区 ACU 余额及当前密钥预算。需要 account:read。

`ploid.get_credits`

### Get Account Usage

读取工作区 ACU 用量及当前密钥 ID、预算和有效密钥数量。需要 account:read。

`ploid.get_account_usage`

### Get Account Profile

需要 account:read。

`ploid.get_account_profile`

### Update Account Profile

需要 account:write。

`ploid.update_account_profile`

### Revoke Current Api Key

立即撤销当前调用密钥；成功响应是该密钥最后一次可授权响应。需要 account:read。

`ploid.revoke_current_api_key`

### Create Set

创建 preview People Set 并启动持久的条件验证搜索。需要 people:search。

`ploid.create_set`

### List Sets

列出工作区最近的 People Sets（preview）。需要 people:search。

`ploid.list_sets`

### Get Set

读取 People Set 及按新到旧排列的 searches，检查进度和 stop\_reason（preview）。

`ploid.get_set`

### List Set Items

分页读取已接纳人物，搜索仍进行时也可获得部分结果（preview）。

`ploid.list_set_items`

### Export Set

以 JSON 导出已接纳的 People Set 人物，保留原始字段值（preview）。

`ploid.export_set`

### Cancel Set

取消运行中的 People Set 搜索，保留已接纳人物（preview）。

`ploid.cancel_set`

### Start Dataset

启动异步数据集，为最多 2000 行填充带来源的列值。需要 people:search。

`ploid.start_dataset`

没有符合搜索条件的工具。

## 将 Ploid 接入 Open Flow

[连接 Ploid](https://console.openflow.run/connections/ploid)

每月 20,000 次免费应用调用（付费服务另计）
