AI提到后端
This commit is contained in:
+86
-73
@@ -1,102 +1,124 @@
|
||||
"""
|
||||
客户端 AI 大模型封装(OpenAI 兼容接口)
|
||||
客户端 AI 评分封装(经云端服务端代理)
|
||||
模型配置(OpenAI 兼容 base_url/api_key/model)与密钥全部由服务端持有,
|
||||
客户端只负责:发起打分任务 → 轮询结果;不再直连任何大模型。
|
||||
功能:
|
||||
1. 职位匹配度评分
|
||||
2. 简历内容整理
|
||||
1. 职位匹配度评分(异步任务:开始打分 + 轮询结果)
|
||||
2. 简历内容整理(服务端同步代理)
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
from openai import OpenAI
|
||||
import time
|
||||
import uuid
|
||||
|
||||
import requests
|
||||
from loguru import logger
|
||||
|
||||
from .config import client_settings
|
||||
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):
|
||||
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:
|
||||
"""OpenAI 兼容大模型客户端"""
|
||||
"""AI 评分客户端(服务端代理模式)"""
|
||||
|
||||
def __init__(self, api_key: str | None = None, base_url: str | None = None,
|
||||
model: str | None = None):
|
||||
self.api_key = api_key or client_settings.AI_API_KEY or os.environ.get("AI_API_KEY", "")
|
||||
self.base_url = base_url or client_settings.AI_BASE_URL
|
||||
self.model = model or client_settings.AI_MODEL
|
||||
self.client = OpenAI(api_key=self.api_key, base_url=self.base_url)
|
||||
def __init__(self, server: ServerAPI):
|
||||
self.server = server
|
||||
|
||||
def available(self) -> bool:
|
||||
return bool(self.api_key)
|
||||
"""可用条件:已登录云端账号(打分接口需 JWT 鉴权)。
|
||||
模型是否配置由服务端判定,未配置时发起打分会返回明确错误。"""
|
||||
return bool(self.server.token)
|
||||
|
||||
# ------------------------------------------------------------------
|
||||
# 职位匹配度评分
|
||||
# 职位匹配度评分(异步任务 + 轮询)
|
||||
# ------------------------------------------------------------------
|
||||
def score_job(self, jd_text: str, resume_content: str, prompt: str | None = None) -> MatchResult:
|
||||
"""根据 JD 与主简历内容评估匹配度"""
|
||||
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 未配置,默认放行")
|
||||
return MatchResult(50, "AI 未接入(未登录系统账号),默认放行")
|
||||
if not resume_id:
|
||||
return MatchResult(50, "无主简历,跳过 AI 评分默认放行")
|
||||
|
||||
system_prompt = (
|
||||
"你是专业招聘顾问。根据职位描述(JD)和候选人简历,输出 JSON 评估结果,"
|
||||
"不要输出 JSON 以外的内容。\n"
|
||||
'格式:{"score": <0-100整数>, "reason": "<一句话评价>"}\n'
|
||||
"评分标准:80-100 高度匹配;60-79 基本匹配;40-59 部分匹配;0-39 不匹配。"
|
||||
)
|
||||
user_prompt = f"【职位描述】\n{jd_text}\n\n【候选人简历】\n{resume_content}"
|
||||
conds = dict(conditions or {})
|
||||
if prompt:
|
||||
user_prompt += f"\n\n【用户额外偏好/引导词】\n{prompt}"
|
||||
conds["prompt"] = prompt
|
||||
request_key = gen_request_key()
|
||||
|
||||
# 1) 开始打分(幂等键保证网络重试不会重复调用大模型)
|
||||
try:
|
||||
resp = self.client.chat.completions.create(
|
||||
model=self.model,
|
||||
messages=[
|
||||
{"role": "system", "content": system_prompt},
|
||||
{"role": "user", "content": user_prompt},
|
||||
],
|
||||
temperature=0.2,
|
||||
max_tokens=256,
|
||||
)
|
||||
raw = resp.choices[0].message.content.strip()
|
||||
if raw.startswith("```"):
|
||||
raw = raw.split("```")[1]
|
||||
if raw.startswith("json"):
|
||||
raw = raw[4:]
|
||||
data = json.loads(raw)
|
||||
return MatchResult(int(data.get("score", 50)), data.get("reason", ""))
|
||||
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, f"AI 异常:{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
|
||||
|
||||
system_prompt = (
|
||||
"你是简历整理助手。将下面抓取的杂乱简历文本整理为清晰、结构化的纯文本简历,"
|
||||
"保留所有关键信息(姓名可省略,联系方式可保留),去除广告和无关内容。"
|
||||
"直接输出整理后的文本,不要加任何解释。"
|
||||
)
|
||||
try:
|
||||
resp = self.client.chat.completions.create(
|
||||
model=self.model,
|
||||
messages=[
|
||||
{"role": "system", "content": system_prompt},
|
||||
{"role": "user", "content": raw_text},
|
||||
],
|
||||
temperature=0.3,
|
||||
max_tokens=2048,
|
||||
)
|
||||
return resp.choices[0].message.content.strip()
|
||||
return self.server.clean_resume_via_server(raw_text)
|
||||
except Exception as e:
|
||||
logger.warning(f"AI 整理简历失败,返回原文:{e}")
|
||||
return raw_text
|
||||
@@ -105,13 +127,4 @@ class AIClient:
|
||||
# 连通测试
|
||||
# ------------------------------------------------------------------
|
||||
def ping(self) -> bool:
|
||||
try:
|
||||
resp = self.client.chat.completions.create(
|
||||
model=self.model,
|
||||
messages=[{"role": "user", "content": "回复1"}],
|
||||
max_tokens=5,
|
||||
)
|
||||
return True
|
||||
except Exception as e:
|
||||
logger.error(f"AI 接口连通失败:{e}")
|
||||
return False
|
||||
return self.server.ping()
|
||||
|
||||
Reference in New Issue
Block a user