131 lines
5.4 KiB
Python
131 lines
5.4 KiB
Python
"""
|
|
客户端 AI 评分封装(经云端服务端代理)
|
|
模型配置(OpenAI 兼容 base_url/api_key/model)与密钥全部由服务端持有,
|
|
客户端只负责:发起打分任务 → 轮询结果;不再直连任何大模型。
|
|
功能:
|
|
1. 职位匹配度评分(异步任务:开始打分 + 轮询结果)
|
|
2. 简历内容整理(服务端同步代理)
|
|
"""
|
|
import time
|
|
import uuid
|
|
|
|
import requests
|
|
from loguru import logger
|
|
|
|
from .server_api import ServerAPI
|
|
|
|
# 轮询间隔 / 等待总预算(与服务端 5 分钟悬空判定对齐)
|
|
POLL_INTERVAL_S = 3
|
|
POLL_BUDGET_S = 300
|
|
|
|
|
|
def gen_request_key() -> str:
|
|
"""幂等键:uuid1 = 本机 MAC + 时间戳,.hex 为 32 位十六进制
|
|
(与服务端 ai_score_task.request_key VARCHAR(32) 严格对齐)"""
|
|
return uuid.uuid1().hex
|
|
|
|
|
|
def _detail_of(e: requests.HTTPError) -> str:
|
|
"""从 HTTPError 中提取服务端 detail 文案"""
|
|
try:
|
|
return str(e.response.json().get("detail") or e)
|
|
except Exception:
|
|
return str(e)
|
|
|
|
|
|
class MatchResult:
|
|
def __init__(self, score: int, reason: str, fatal: bool = False):
|
|
self.score = score
|
|
self.reason = reason
|
|
# fatal = 模型级失败(调用出错/超时/未配置):客户端必须跳过该岗位;
|
|
# 非 fatal(服务端不可达等网络问题):按约定降级默认放行
|
|
self.fatal = fatal
|
|
|
|
def is_worth_applying(self, threshold: int = 60) -> bool:
|
|
return self.score >= threshold
|
|
|
|
|
|
class AIClient:
|
|
"""AI 评分客户端(服务端代理模式)"""
|
|
|
|
def __init__(self, server: ServerAPI):
|
|
self.server = server
|
|
|
|
def available(self) -> bool:
|
|
"""可用条件:已登录云端账号(打分接口需 JWT 鉴权)。
|
|
模型是否配置由服务端判定,未配置时发起打分会返回明确错误。"""
|
|
return bool(self.server.token)
|
|
|
|
# ------------------------------------------------------------------
|
|
# 职位匹配度评分(异步任务 + 轮询)
|
|
# ------------------------------------------------------------------
|
|
def score_job(self, job_ref: str, jd_text: str, resume_id: int | None,
|
|
conditions: dict | None = None,
|
|
prompt: str | None = None) -> MatchResult:
|
|
"""发起打分并等待结果。
|
|
- 服务端明确失败(模型未配置/简历缺失/限额/模型报错/超时)→ fatal,调用方跳岗
|
|
- 网络层不可达 → 降级默认放行(保持既有容错约定)
|
|
"""
|
|
if not self.available():
|
|
return MatchResult(50, "AI 未接入(未登录系统账号),默认放行")
|
|
if not resume_id:
|
|
return MatchResult(50, "无主简历,跳过 AI 评分默认放行")
|
|
|
|
conds = dict(conditions or {})
|
|
if prompt:
|
|
conds["prompt"] = prompt
|
|
request_key = gen_request_key()
|
|
|
|
# 1) 开始打分(幂等键保证网络重试不会重复调用大模型)
|
|
try:
|
|
self.server.start_ai_score({
|
|
"request_key": request_key,
|
|
"resume_id": resume_id,
|
|
"jd_text": jd_text,
|
|
"job_ref": job_ref,
|
|
"conditions": conds,
|
|
})
|
|
except requests.HTTPError as e:
|
|
return MatchResult(-1, f"AI 打分不可用:{_detail_of(e)}", fatal=True)
|
|
except Exception as e:
|
|
logger.warning(f"AI 打分发起失败(服务端不可达),默认放行:{e}")
|
|
return MatchResult(50, "AI 服务不可达,默认放行")
|
|
|
|
# 2) 轮询结果:成功返回分数;失败带原因(调用方跳岗);处理中继续等待
|
|
deadline = time.time() + POLL_BUDGET_S
|
|
while time.time() < deadline:
|
|
time.sleep(POLL_INTERVAL_S)
|
|
try:
|
|
r = self.server.get_ai_score_result(request_key)
|
|
except Exception as e:
|
|
logger.debug(f"AI 结果轮询异常,稍后重试:{e}")
|
|
continue
|
|
status = r.get("status")
|
|
if status == "success":
|
|
return MatchResult(int(r.get("score") or 0), r.get("reason") or "")
|
|
if status == "failed":
|
|
return MatchResult(-1, f"AI 打分失败:{r.get('reason') or '未知'}",
|
|
fatal=True)
|
|
# pending / running:等待下一次轮询
|
|
logger.warning(f"AI 打分等待超时({POLL_BUDGET_S}s),跳过该岗位:{job_ref}")
|
|
return MatchResult(-1, f"AI 打分超时({POLL_BUDGET_S // 60} 分钟)", fatal=True)
|
|
|
|
# ------------------------------------------------------------------
|
|
# 简历内容整理(服务端同步代理,低频调用)
|
|
# ------------------------------------------------------------------
|
|
def clean_resume(self, raw_text: str) -> str:
|
|
"""用 AI 将抓取的杂乱简历文本整理为清晰的结构化文本"""
|
|
if not self.available():
|
|
return raw_text
|
|
try:
|
|
return self.server.clean_resume_via_server(raw_text)
|
|
except Exception as e:
|
|
logger.warning(f"AI 整理简历失败,返回原文:{e}")
|
|
return raw_text
|
|
|
|
# ------------------------------------------------------------------
|
|
# 连通测试
|
|
# ------------------------------------------------------------------
|
|
def ping(self) -> bool:
|
|
return self.server.ping()
|