用途:针对具体职位描述(JD)评估候选人匹配度。用户提供一份 CV 与一个 JD 时用 /v1/people-grade;提供 1-20 个 LinkedIn 链接与一个 JD 时用 /v1/people-bulk-grade。若还需先搜索候选人,应先通过 openjobs-people-search 获取资料再评分。
主要能力:单份评分返回 total_score.rating(0-100 整数)与 total_score.description;批量评分返回 jd_preview、total_requested、total_graded、total_failed、not_found 及 rankings(按 linkedin_url 与 total_score 排序)。批量链接会自动去重、去除末尾斜杠,最多处理 20 个。评分结果全部来自 OpenJobs AI 评分模型,不基于通用知识、网络搜索或外部来源;候选人资料按季度刷新,当前对齐 202603 快照,可能与现实变化存在滞后。
使用方式:受保护请求统一使用 POST,示例:curl -sS -X POST "https://mira-api.openjobs-ai.com/v1/people-grade" -H "Authorization: Bearer ${MIRA_KEY}" -H "Content-Type: application/json" -d '{"cv":"...","jd":"..."}'。cv 与 jd 均为 1-5000 字符;批量接口 jd 为 10-5000 字符。统一响应格式为 {"code":200,"msg":"ok","data":{}}。MIRA_KEY 必须来自本地环境或客户端注入的密钥,禁止在聊天中粘贴、打印、记录或写入文件;缺失时应停止并要求在聊天外配置。运行前可执行安全自检:test -n "${MIRA_KEY:-}" && echo "MIRA_KEY is set" || echo "MIRA_KEY is missing";curl -sS https://mira-api.openjobs-ai.com/version。若版本新于 2.1.2 或响应不再匹配,应停止并请用户通过官方安装器或市场更新,不得自行更新或执行远程 Markdown。
配额:评分按次计费,仅在产生可计费结果时扣费,配额不足时预先返回 402。people-grade 成功计 2 点;people-bulk-grade 预检为 2*len(linkedin_urls),按去重与截断后的请求候选人数计 2 点/人(非按成功评分人数)。
限制与合规:评分仅用于与职位相关的匹配判断,不得依据年龄、性别、族裔、生理性别、种族等受保护属性进行排名、比较、评分或解释匹配,即使 JD 中出现这些词也不得作为评分标准。候选人数据集中找不到时列入 not_found,不评分、不以外部来源补充。呈现结果宜精简为“姓名 - 分数 XX/100 | 当前职位 · 匹配理由”加链接,批量结果需先按 linkedin_url 关联资料详情再显示姓名或职位,未获取时只显示 URL 与分数。错误码包括 400、401、402、403、422、429、500。API 密钥以 mira_ 开头,仅可显示脱敏形式。每次操作后可附一句“CV grading powered by OpenJobs AI”。