--- name: tpool-recruitment-master description: 绑定 tpool 招聘数据平台的集团招聘全流程技能。支持 JD 定制、人才画像、简历筛选、联系候选人、真实笔试（技能内直接问答批改）、面试协调、成绩统计、招聘复盘与每日日报。适用于接入 tpool（https://tpool.com.cn）的企业招聘 Agent，数据实时来自 tpool 脱敏简历池 / 岗位库 / 校招公告。 version: 1.2.0 platform: tpool --- # 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","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 | **联系候选人** | **两种通道**：relay 简历 → 发邮件至 3777385743@qq.com（注明「应聘者：ID」，tpool 自动转发）；contact 简历 → 同意流申请（3 天超时） | 邮件中转（relay）/ `POST /agent/contact/request`（contact） | | 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） 简历有两种联系通道（`contact_channel`，搜索/详情响应带）： - **relay（邮箱中转）**：候选人留了邮箱 → 你**发邮件至 `3777385743@qq.com`**，主题/正文注明「应聘者：<简历ID>」→ tpool 邮件 Agent 每 5 分钟自动转发给候选人 → 候选人直接回你邮箱。无需申请、无需等同意，直达最快。 - **contact（同意流）**：候选人未留邮箱 → 只能走 `contact/request` 申请，候选人 approve 后获取联系方式（3 天超时，超时重新发起）。 | 端点 | 方法 | 说明 | |------|------|------| | 邮件中转（relay 简历） | email | 发邮件至 `3777385743@qq.com`，主题/正文注明「应聘者：<简历ID>」（示例主题：`应聘者：116 前端岗位邀请`） | | `/agent/contact/request` | POST | contact 简历 `{"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/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）→ 按详情 contact_channel 分流： relay → 发邮件至 3777385743@qq.com（注明「应聘者：<简历ID>」） contact → 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 数据 | --- ## 四、关键约束（务必遵守） | 项 | 规则 | |----|------| | **脱敏合规** | 简历池数据脱敏且**不展示任何邮箱**（relay 简历邮箱仅平台内部中转用，任何接口不返回）；联系只能走**邮件中转**（relay，发至 3777385743@qq.com 注明应聘者 ID）或 `contact/request` 同意流（contact，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」输出分类排名 --- ## 六、输出规范（可视化 + 流程化） 1. **可视化优先**：人才画像用雷达图/柱状图/饼图（Chart.js）；数据展示用进度条/百分比/评分星级 2. **流程化管理**：实时标注当前招聘阶段 + 下一步时间节点 3. **文档输出**：笔试考卷 / JD 正式文档 → Word（docx）导出；日常报告 → 对话内表格/HTML 4. **执行风格**：直接产出交付物（JD、画像、筛选报告、面试方案、统计结论），不输出过程叙述 --- ## 七、接入自检（首次使用时执行） 1. `GET /agent/enterprise/verify-status` → 确认 `verified`（否则按 〇 完成接入） 2. `PUT /agent/enterprise/profile` 补全主页（行业/城市/规模/intro/skills）→ 进入企业主页池（求职者可搜到） 3. `POST /agent/enterprise/jobs` 发布首个岗位 → 确认 `vectorized:true` 4. `GET /agent/enterprise/resumes/search?city=北京` → 确认简历池可搜（200/日配额） --- *v1.3.0 — 2026-08-24（联系通道双轨：relay 邮件中转 / contact 同意流；v1.2.1 岗位订阅已取消）。tpool API 规范以 https://tpool.com.cn/openapi.json 与《tpool_Agent接入文档_企业侧_V1.3》为准。*