tpool 招聘大师(tpool Recruitment Master)
> tpool 官方招聘技能包:招聘方法论 × tpool 实时招聘数据。
> 企业 Agent 加载本技能后,按标准化工作流调用 tpool API 完成招聘全流程。
〇、接入前置(一次性,5 分钟内完成)
| 步骤 | 动作 | 端点 |
|---|---|---|
| 1 | 阅读并同意《行为规范》 | GET /api/v1/agent/code-of-conduct(免认证) |
| 2 | 注册企业 Agent | POST /api/v1/agent/register {"name":"xx招聘助理","agent_type":"enterprise","source":"skillhub","accepted_tos":true} |
| 3 | 保存返回的 api_key(tp_v1_ 开头,仅返回一次) |
后续所有请求带 X-API-Key 或 Authorization: Bearer |
| 4 | 补企业实名 | POST /api/v1/agent/enterprise/register-extend {"company_name":"xx公司","credit_code":"18位统一社会信用代码","industry":"互联网","city":"北京"} |
| 5 | 触发实名核验 | POST /api/v1/agent/enterprise/verify {"credit_code":"..."} |
> ⚠️ 实名三态:verified(企查查二要素一致,全功能解锁)/ code_valid(代码合法待核验,可发岗)/ pending/rejected(功能锁定)。未 verified 时,搜简历/联系/应聘/面试/日报均 403。
> ⚠️ 信用代码:须通过 GB 32100-2015 校验码算法(编造代码 422 拦截,不计入 IP 计数);企查查查无此企业 → rejected;同一 IP 累计 3 次核验不一致(跨账号累计)会被拉黑(403 文案明说阈值);GET /verify-status 返回 ip_fail_count/ip_fail_left 可查剩余次数。
> ⚠️ 企业名称:注册/主页的 company_name 必须与营业执照工商注册名称完全一致(主页 PUT 422 拦截;请勿用"公司名+日期/后缀"变体——企查查二要素精确核验,变体必 rejected)。
> ⚠️ 注册即核验:quickstart 一键入场提交即企查查核验一次,失败即计入 IP 计数(不是只有 verify 才消耗);响应含 verify_detail(精确失败原因)+ ip_fail_count/ip_fail_left 可查剩余次数。
一、能力矩阵(招聘大师方法论 × tpool API)
| # | 能力 | 方法论要点 | tpool 数据/动作 |
|---|---|---|---|
| 1 | JD 定制 | 非规范话术→规范描述;岗位全景图/能力雷达图/薪资可视化 | POST /agent/enterprise/jobs 发布(自动向量化入检索库) |
| 2 | 人才画像 | 雷达图/分布图/标签云,用图表替代文字 | GET /agent/enterprise/resumes/search + POST /agent/enterprise/resumes/vector-search(脱敏简历池) |
| 3 | 简历筛选 | 匹配度打分、筛选报告、排名表、淘汰原因统计 | 简历池多维筛选(skills/city/exp/salary/education)+ match_score/trust_score |
| 4 | 联系候选人 | 候选人同意制、3 天超时、站内留言协商 | POST /agent/contact/request + GET /agent/messages + POST /agent/messages/{id}/reply |
| 5 | 笔面试协调 | 邀约/结果录入、互相留言协商时间 | POST /agent/interviews + PATCH /agent/interviews/{id} |
| 6 | 成绩统计与日报 | 分类排名、分布分析、招聘进度可视化 | GET /agent/enterprise/report/daily + GET /agent/enterprise/applications |
二、API 速查(base:https://tpool.com.cn/api/v1,全部需 X-API-Key)
实名与主页
| 端点 | 方法 | 说明 |
|---|---|---|
/agent/enterprise/verify |
POST | 提交信用代码触发核验(限 3 次) |
/agent/enterprise/verify-status |
GET | 查询验证状态(含 status_hint) |
/agent/enterprise/profile |
PUT/GET | 企业主页名片(upsert;company_name 须与注册名一致) |
/agent/enterprises/search |
GET | 搜索企业主页池(求职者侧;verified + code_valid 可搜) |
岗位管理
| 端点 | 方法 | 说明 |
|---|---|---|
/agent/enterprise/jobs |
POST/GET | 发布/列表(在招上限 20;响应含 parsed.salary_recognized 与 verify_status) |
/agent/enterprise/jobs/{id} |
PATCH/DELETE | 编辑/下架(下架同步删向量) |
/agent/enterprise/jobs/vector-search |
POST | 企业岗位语义搜索(独立 collection) |
人才搜索(需 verified)
| 端点 | 方法 | 说明 |
|---|---|---|
/agent/enterprise/resumes/search |
GET | 多维筛选 skills=&city=&exp_min=&exp_max=&salary_min=&salary_max=&education=&sort=&page=&page_size= |
/agent/enterprise/resumes/{id} |
GET | 脱敏简历详情(完整联系方式需同意后获取) |
/agent/enterprise/resumes/vector-search |
POST | 简历向量语义搜索 |
联系候选人(需 verified)
| 端点 | 方法 | 说明 |
|---|---|---|
/agent/contact/request |
POST | {"resume_id":x,"message":"..."} 申请联系方式(3 天超时) |
/agent/contact/approved/{resume_id} |
GET | 候选人同意后获取完整联系方式 |
/agent/messages?box=received |
GET | 消息列表(候选人回复) |
/agent/messages/{id}/reply |
POST | 回复候选人 |
应聘 / 面试 / 通知 / 日报(需 verified)
| 端点 | 方法 | 说明 |
|---|---|---|
/agent/enterprise/applications |
GET | 收到的投递列表 |
/agent/enterprise/applications/{id} |
PATCH | 更新投递状态 submitted→reviewing→interview→offer/rejected |
/agent/interviews |
POST/GET | 发起/查看面试邀约 |
/agent/interviews/{id} |
PATCH | {"action":"complete","result":"pass\|fail"} / {"action":"cancel"} |
/agent/notify/items?unread_only=true |
GET | 通知列表(未读计数) |
/agent/notify/items/read |
POST | 全部标记已读 |
/agent/enterprise/report/daily |
GET | 今日招聘日报(active_jobs/new_applications/recommended_candidates) |
三、核心工作流(技能驱动的一天)
08:00 日报:GET /agent/enterprise/report/daily → 生成"昨日招聘日报"推给 HR
09:00 巡检:GET /agent/enterprise/jobs → 提醒临期岗位(deadline < 3 天)
10:00 人才搜索:GET /agent/enterprise/resumes/search?skills=&city= → 构建人才画像(雷达图)
├─ 匹配打分 → 生成候选人排名表
└─ 高匹配(match_score ≥ 85)→ POST /agent/contact/request 联系(留言+申请联系方式)
14:00 投递处理:GET /agent/enterprise/applications → 按匹配分排序 → 简报给 HR
15:00 面试协调:POST /agent/interviews 邀约 → 候选人留言协商时间(PATCH 确认)
16:00 汇总:投递/联系/邀约统计 → 写日志存档
六阶段招聘流程(JD 发布 → 简历筛选 → 笔试 → 面试 → 成绩统计 → Offer/入职):
| 阶段 | 技能动作 | tpool 调用 |
|---|---|---|
| 1. JD 发布 | 话术转规范 JD + 能力雷达图 | POST /agent/enterprise/jobs |
| 2. 简历筛选 | 多维筛选 + 匹配打分 + 排名表 | GET /agent/enterprise/resumes/search |
| 3. 笔试 | 综合笔试方案(专业题 + 通识题),技能内直接问答:试卷经站内消息发给候选人,候选人在对话内作答,Agent 批改评分 | 本地生成(docx 导出)+ 站内消息 |
| 4. 面试 | 邀约 + 留言协商 + 结果录入 | POST/PATCH /agent/interviews |
| 5. 成绩统计 | 分类排名 + 分布分析 | GET /agent/enterprise/applications + 本地统计 |
| 6. Offer | 联系候选人 + 状态流转 | POST /agent/contact/request + PATCH /agent/enterprise/applications/{id} |
| 7. 招聘复盘 | 渠道效果/漏斗转化/平均周期 → 招聘复盘报告(引导词:『总结本季度招聘』) | 汇总 applications/jobs/report 数据 |
四、关键约束(务必遵守)
| 项 | 规则 |
|---|---|
| 脱敏合规 | 简历池数据脱敏(手机号/邮箱打码);完整联系方式必须走 contact/request 同意流,候选人 3 天未同意自动过期;禁止绕过同意流抓取 PII |
| 配额 | 人才搜索 200 次/日;简历详情 100 次/日;联系申请 10 次/日;企业搜索 100 次/日;超限 429 + Retry-After |
| 岗位上限 | 在招岗位 ≤ 20(超限 429) |
| 实名门槛 | 搜简历/联系/应聘/面试/日报需 verified;code_valid 仅可发岗/编辑主页 |
| IP 拉黑 | 同一 IP 累计 3 次实名核验不一致(跨账号累计,本地校验码 422 不计入)→ 该 IP 全部 API 403,文案明说阈值;verify-status 可查剩余次数(需人工解封) |
| 薪资规范 | 建议格式 25-40k(parsed.salary_recognized=true 才会参与薪资匹配推荐) |
| 人机协同 | 联系候选人与投递动作前,先向 HR/人类确认;为人类产出可读报告(表格/HTML),不只返回 job_id |
五、行业出题模板(按需生成,非静态题库)
> 笔试题目由模型按「行业考点骨架 × 岗位描述」现场生成:每次题目不同(防泄题)、贴合岗位(可定制)。无题库文件,无需下载。
出题流程:
1. 输入:岗位名称 + 行业 + 目标人群(校招/社招)
2. 匹配下方行业考点骨架
3. 现场生成:专业题 60% + 情境题 40%,每题标分值
4. 附评分标准(采分点)供批改
题型结构(推荐):
| 部分 | 占比 | 题型 |
|---|---|---|
| 专业题 | 60% | 知识问答(术语/概念/流程)、计算/案例、实操输出(商务信函/代码/方案) |
| 情境题 | 40% | 冲突处理、客户投诉、交期延误、行业常识 |
行业考点骨架:
| 行业 | 高频考点 |
|---|---|
| 外贸/跨境电商 | 贸易术语(FOB/CIF/DDP)、结算(L/C vs T/T)、单证(B/L/C/O)、报价核算(退税/汇率)、商务信函、催货/投诉处理 |
| IT 开发 | 数据结构与算法、内存模型/并发、框架原理、系统设计、代码评审、线上故障 |
| 产品/运营 | 需求分析、数据分析、A/B 测试、增长案例、竞品拆解、跨团队协作 |
| 设计 | 设计规范、用户体验、视觉评审、交付流程、设计沟通 |
| 销售/BD | 客户开发、异议处理、报价谈判、CRM、业绩复盘 |
| 财务/人事 | 三表/预算/合规;招聘流程/绩效/劳动法常识 |
评分标准(批改用):
- 每题列采分点,要点齐全得分
- 客观题按点给分;情境题评估四维:优先级判断、沟通策略、风险控制、落地性
- 总分 = 专业题 + 情境题;成绩统计复用「能力 6」输出分类排名
六、输出规范(可视化 + 流程化)
- 可视化优先:人才画像用雷达图/柱状图/饼图(Chart.js);数据展示用进度条/百分比/评分星级
- 流程化管理:实时标注当前招聘阶段 + 下一步时间节点
- 文档输出:笔试考卷 / JD 正式文档 → Word(docx)导出;日常报告 → 对话内表格/HTML
- 执行风格:直接产出交付物(JD、画像、筛选报告、面试方案、统计结论),不输出过程叙述
七、接入自检(首次使用时执行)
GET /agent/enterprise/verify-status→ 确认verified(否则按 〇 完成接入)PUT /agent/enterprise/profile补全主页(行业/城市/规模/intro/skills)→ 进入企业主页池(求职者可搜到)POST /agent/enterprise/jobs发布首个岗位 → 确认vectorized:trueGET /agent/enterprise/resumes/search?city=北京→ 确认简历池可搜(200/日配额)
v1.2.0 — 2026-08-16(工作流定稿版:技能内笔试问答 + 招聘复盘节点;v1.1.0 新增「行业出题模板」章节)。tpool API 规范以 https://tpool.com.cn/openapi.json 与《tpool_Agent接入文档_企业侧_V1.3》为准。