跳到主要内容

让你的 AI Agent 连接 Ploid

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

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

试试这些 Ploid 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo SkillPloid

查找并研究人物

搜索候选人、解析目标身份并读取已审核资料。

/oo Ploid: 在 Ploid 中查找[姓名及公司]的候选人,展示匹配结果供我确认,再读取所选人物资料并总结公开证据。

填充研究数据集

为已有的人物或公司行补充带来源的字段。

/oo Ploid: 使用 Ploid 为[行数据]填充[列定义]。启动异步数据集,等待完成,再分页获取所有结果,区分找到、不确定和缺失的单元格。

开始使用 Ploid

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 Ploid

    在 https://app.ploid.com/workspace/settings?section=api-keys 创建 API Key。

    连接 Ploid→
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →
  • Ploid 工作区,以及具有 account:read 的 API Key,用于连接验证。
  • 各业务所需权限和可用 ACU 额度。
  • 部分操作消耗工作区额度,受密钥预算限制。
  • People Sets 为 preview,GitHub 搜索为 beta;可用性取决于工作区权限。
  • 研究结果为基于证据的评估,不是身份认证。

Ploid 工具

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

常见问题

连接时会启动收费研究吗?

不会。连接仅读取账户资料。业务操作可能消耗 ACU;可设置密钥预算,并在重试受支持的同一请求时复用幂等键。

长时间请求如何处理?

人物研究可立即返回缓存,或返回 run_id;有句柄时调用人物任务查询。异步数据集提供提交/结果生命周期,People Sets 提供状态和已接纳人物分页。