职位评估技能(Pay Skill)
依据内置标准《企业薪酬公平性与职位评估方法》,对单个企业岗位做价值评估,输出
四大项分值、20 个因素分值与总分(价值点数),为企业薪酬公平性设计提供参考。
本技能为按次收费服务:每次评估前需通过支付宝完成支付,支付成功后才返回评估结果。
0. 服务端配置(必改)
把你部署好的卖家服务端公网地址填到下面对应位置(与 position-eval-server 的 POST /evaluate 对应):
SELLER_RESOURCE_URL = https://1253986390-cv2u0c8ybd.ap-guangzhou.tencentscf.com/evaluate
> ✅ 已指向已上线的腾讯云函数(POST /evaluate)。如更换部署地址,只需改这一行。
1. 何时使用
用户出现以下意图之一即触发:
- 上传/给出"职位说明书""岗位说明""JD",要求"评估职位价值""算薪点""岗位价值评估";
- 明确要求"按《企业薪酬公平性与职位评估方法》打分"。
2. 输入处理(文件 → 文本)
用户可能上传 WORD / PDF / EXCEL / 图片:
- 文本类(docx/xlsx/pdf/txt):提取纯文本作为 description;
- 图片类:OCR 提取文字后作为 description;
- 若用户直接给了文字描述,原样作为 description。
只取"职位职责、任职要求、汇报关系、工作条件"等核心内容,剔除无关页眉页脚。
3. 调用流程(A2M / HTTP 402:probe → pay → complete → ack)
3.1 probe(探测)
向 SELLER_RESOURCE_URL 发起 POST,Content-Type: application/json,body:
{ "description": "<职位说明书文本>" }
- 若返回 HTTP 200 + 评估结果 JSON → 直接跳到 3.4 呈现(理论上不会,本技能强制先付费)。
- 若返回 HTTP 402 + 响应头
Payment-Needed→ 进入 3.2 支付。 - 其他错误 → 原样报错给用户并 STOP。
3.2 pay(支付)
把上一步拿到的 Payment-Needed 头(Base64URL 字符串)完整交给 alipay-payment-skill
(支付宝 A2M 402 支付技能)处理:由它向用户弹出支付宝收银台、引导扫码/确认付款,
付款成功后取回 Payment-Proof。
- 不要篡改 Payment-Needed 任何字符;
- 支付过程中保持对用户的透明提示("正在为您发起支付宝支付…")。
3.3 complete(交付 / 重试)
拿到 Payment-Proof 后,原样重试 3.1 的同一请求,但额外带上请求头:
Payment-Proof: <支付宝返回的凭证>
服务端会校验凭证、执行评估、返回结果 JSON。
- 若重试仍返回 402 → 支付可能未完成,提示用户确认付款后重试;
- 若返回 200 + 结果 → 进入 3.4。
3.4 ack(回执 / 呈现)
把评估结果以清晰结构呈现给用户,至少包含:
- 总分(价值点数);
- 四大项分值:责任 / 技能 / 努力 / 工作条件;
- 20 个因素分值明细;
- 计价说明(本次已按次付费,金额以支付凭证为准)。
4. 安全与合规
- 不缓存、不上传用户的职位说明书到本技能之外的任何地方;
- 支付仅通过官方
alipay-payment-skill完成,不在对话中索取任何支付密码/验证码; - 收费主体、单价、退款规则以 SkillHub 技能页公示为准。
5. 排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 一直 402 且付完仍 402 | 服务端未部署 / 地址错误 / 支付宝未签约 | 核对 SELLER_RESOURCE_URL 与支付宝 AI按量付费 配置 |
amount_mismatch |
价格与服务端 PRICE 不一致 |
统一双方单价 |
resource_mismatch |
资源标识不一致(重放异常) | 用同一请求重试,或新建评估 |