落地私聊空运询价与TMS报价回填，按后台模板出单。
查到价后把币种、单位、数量、单价、备注写入报价单，避免销售只看到光秃秃的金额。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Cursor
@@ -0,0 +1,797 @@
|
||||
"""
|
||||
空运文字询价出站话术（销售可见）。
|
||||
|
||||
本文件职责：集中文案；按钮字面量必须与 handler 精确匹配。
|
||||
禁止：在本文件调主账/TMS；禁止把密钥写进话术。
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import re
|
||||
import time
|
||||
import uuid
|
||||
from typing import Any, Iterable
|
||||
|
||||
from agent.schema.field_validate import AIR_REQUIRED_FIELDS
|
||||
|
||||
# 空运补问：与合同 8 项一致。报价日期默认当天，不进待补充。
|
||||
_AIR_EXAMPLES = {
|
||||
"起运港": "南京",
|
||||
"目的港": "吉隆坡",
|
||||
"品名": "茶叶",
|
||||
"件数": "10件",
|
||||
"毛重": "100KGS",
|
||||
"体积": "2CBM",
|
||||
"包装方式": "托盘",
|
||||
"报价日期": "2026-09-15",
|
||||
}
|
||||
_AIR_CLARIFY = tuple(
|
||||
(key, label, _AIR_EXAMPLES[key]) for key, label in AIR_REQUIRED_FIELDS
|
||||
)
|
||||
|
||||
# 文字按钮（销售点卡或原样回复均可）
|
||||
BTN_SKIP_COLLAB = "不需要协同，直接生成报价单"
|
||||
BTN_SKIP_COLLAB_OLD = "不需要协同，直接生成基础报价单"
|
||||
BTN_SKIP_COLLAB_KEY = "skip_collab"
|
||||
BTN_SKIP_COLLAB_DONE = "已提交"
|
||||
BTN_ADOPT_EXCEL = "采用，生成Excel报价单"
|
||||
BTN_ADOPT_PDF = "采用，生成PDF报价单"
|
||||
BTN_REJECT = "不采用"
|
||||
# 企微一张卡三个按钮只能横排，长文案会被裁。卡片用短文案才能看全。
|
||||
BTN_ADOPT_EXCEL_CARD = "生成Excel"
|
||||
BTN_ADOPT_PDF_CARD = "生成PDF"
|
||||
BTN_ADOPT_EXCEL_KEY = "adopt_excel"
|
||||
BTN_ADOPT_PDF_KEY = "adopt_pdf"
|
||||
BTN_REJECT_KEY = "reject"
|
||||
BTN_DEAL = "成交"
|
||||
BTN_LOST = "未成交"
|
||||
BTN_NEGOTIATE = "协商中"
|
||||
|
||||
_WO_NO = re.compile(r"WO\d{12}", re.IGNORECASE)
|
||||
# 仅给无网 stub / 工单号回填用，正式续办意图由 DeepSeek A 判断，不要求销售说这些词。
|
||||
_CONTINUE_HINT = (
|
||||
"继续",
|
||||
"接着",
|
||||
"回到",
|
||||
"再看",
|
||||
"再出",
|
||||
"找回",
|
||||
"重开",
|
||||
"那单",
|
||||
"这单",
|
||||
"历史工单",
|
||||
"咨询工单",
|
||||
"刚才那",
|
||||
"上次那",
|
||||
)
|
||||
|
||||
|
||||
ASK_TRANSPORT = "请补充运输方式：海运 / 空运 / 陆运。"
|
||||
ASK_LAND_SUBTYPE = "请补充陆运类型：国内运输拼车 / 国内运输整车 / 跨境集拼 / 跨境整车 / 中港。"
|
||||
FIRST_CHAT = "你好，我是询价机器人。请直接描述客户需求，例如「上海到洛杉矶空运，3 件 180kg，下周三前到」，我会解析需求并查询 TMS 标准报价。"
|
||||
ROUTE_MODEL_FAILED = "刚才没听清，请再说一次：是新询价，还是要接着办哪张工单？"
|
||||
|
||||
|
||||
def _air_known_value(facts: dict[str, str], key: str) -> str:
|
||||
"""已识别字段的销售侧展示值；没有则空串。"""
|
||||
src = facts or {}
|
||||
if key == "起运港":
|
||||
return (src.get("起运港") or "").strip()
|
||||
if key == "目的港":
|
||||
return (src.get("目的港") or "").strip()
|
||||
if key == "品名":
|
||||
return (src.get("品名") or "").strip()
|
||||
if key == "件数":
|
||||
raw = (src.get("件数") or "").strip()
|
||||
return _keep_or_add_unit(raw, ("件", "PCS"), "件") if raw else ""
|
||||
if key == "毛重":
|
||||
raw = (src.get("毛重") or "").strip()
|
||||
return _keep_or_add_unit(raw, ("KGS", "KG", "公斤", "千克"), "") if raw else ""
|
||||
if key == "体积":
|
||||
raw = (src.get("体积") or "").strip()
|
||||
return _keep_or_add_unit(raw, ("CBM", "M3", "M³", "立方米", "立方", "方"), "") if raw else ""
|
||||
if key == "包装方式":
|
||||
return (src.get("包装方式") or src.get("包装类型") or "").strip()
|
||||
if key == "报价日期":
|
||||
return (src.get("报价日期") or "").strip()
|
||||
return (src.get(key) or "").strip()
|
||||
|
||||
|
||||
def ask_clarify(
|
||||
*,
|
||||
facts: dict[str, str] | None = None,
|
||||
missing_keys: Iterable[str] = (),
|
||||
transport_mode: str = "空运",
|
||||
) -> str:
|
||||
"""
|
||||
缺项补问：先回显已识别，再列待补充并给示例。
|
||||
|
||||
报价日期写进已识别（销售说了用原话，没说用当天），不出现在待补充。
|
||||
"""
|
||||
src = dict(facts or {})
|
||||
skip = {"报价日期"}
|
||||
missing = [k for k in missing_keys if k and k not in skip]
|
||||
missing_set = set(missing)
|
||||
lines = ["请确认并补充以下信息："]
|
||||
if transport_mode:
|
||||
lines.append(f"运输方式：{transport_mode}")
|
||||
for key, label, _example in _AIR_CLARIFY:
|
||||
val = _air_known_value(src, key)
|
||||
if val:
|
||||
lines.append(f"{label}：{val}")
|
||||
lines.append("")
|
||||
lines.append("待补充：")
|
||||
any_missing = False
|
||||
if "运输方式" in missing_set:
|
||||
any_missing = True
|
||||
lines.append("运输方式：(如：空运）")
|
||||
for key, label, example in _AIR_CLARIFY:
|
||||
if key in missing_set:
|
||||
any_missing = True
|
||||
lines.append(f"{label}：(如：{example}）")
|
||||
if not any_missing:
|
||||
return ""
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def ask_missing(display_names: Iterable[str]) -> str:
|
||||
"""兼容旧调用：仅有展示名时仍走补问，但没有已识别回显。"""
|
||||
alias = {
|
||||
"起运地": "起运港",
|
||||
"目的地": "目的港",
|
||||
"起运地（机场名或三字码）": "起运港",
|
||||
"目的地（机场名或三字码）": "目的港",
|
||||
"毛重": "毛重",
|
||||
"重量": "毛重",
|
||||
"重量(KG)": "毛重",
|
||||
"体积": "体积",
|
||||
"体积(CBM)": "体积",
|
||||
"包装类型": "包装方式",
|
||||
"包装方式": "包装方式",
|
||||
}
|
||||
keys: list[str] = []
|
||||
for name in display_names:
|
||||
key = alias.get(name, name)
|
||||
if key and key not in keys and key != "报价日期":
|
||||
keys.append(key)
|
||||
return ask_clarify(facts={}, missing_keys=keys, transport_mode="空运")
|
||||
|
||||
|
||||
def _keep_or_add_unit(raw: str, known: tuple[str, ...], default: str) -> str:
|
||||
"""
|
||||
销售侧单位原样回显。
|
||||
|
||||
写了 1.5KG 就回 1.5KG，禁止改成 1.5KGS。没写单位才补 default（可空）。
|
||||
"""
|
||||
text = (raw or "").strip()
|
||||
if not text:
|
||||
return "-"
|
||||
upper = text.upper()
|
||||
for unit in known:
|
||||
if upper.endswith(unit.upper()):
|
||||
return text
|
||||
if default and not any(ch.isalpha() or ch in "立方件" for ch in text):
|
||||
return f"{text}{default}"
|
||||
return text
|
||||
|
||||
|
||||
def _with_unit(raw: str, suffix: str) -> str:
|
||||
"""兼容旧调用：已带单位则原样。重量不要走这里补 KGS。"""
|
||||
if suffix.upper() == "KGS":
|
||||
return _keep_or_add_unit(raw, ("KGS", "KG", "公斤", "千克"), "")
|
||||
if suffix.upper() == "CBM":
|
||||
return _keep_or_add_unit(raw, ("CBM", "M3", "M³", "立方米", "立方", "方"), "")
|
||||
return _keep_or_add_unit(raw, (suffix,), suffix)
|
||||
|
||||
|
||||
def inquiry_field_lines(
|
||||
*,
|
||||
work_order_no: str,
|
||||
facts: dict[str, str],
|
||||
transport_mode: str = "空运",
|
||||
) -> list[str]:
|
||||
"""
|
||||
询价确认字段行（销售可见）。
|
||||
|
||||
起运/目的展示销售原文（南京/北京），三字码只给出站 TMS，不对销售展示。
|
||||
"""
|
||||
origin = (facts.get("起运港") or "-").strip()
|
||||
dest = (facts.get("目的港") or "-").strip()
|
||||
cargo = (facts.get("品名") or "-").strip() or "-"
|
||||
pack = (facts.get("包装方式") or facts.get("包装类型") or "-").strip() or "-"
|
||||
quote_date = (facts.get("报价日期") or "-").strip() or "-"
|
||||
return [
|
||||
f"工单号：{work_order_no}",
|
||||
f"运输方式：{transport_mode}",
|
||||
f"起运地：{origin}",
|
||||
f"目的地：{dest}",
|
||||
f"品名：{cargo}",
|
||||
f"件数：{_with_unit(str(facts.get('件数') or ''), '件')}",
|
||||
f"重量：{_with_unit(str(facts.get('毛重') or ''), 'KGS')}",
|
||||
f"体积：{_with_unit(str(facts.get('体积') or ''), 'CBM')}",
|
||||
f"包装类型：{pack}",
|
||||
f"报价日期：{quote_date}",
|
||||
]
|
||||
|
||||
|
||||
def inquiry_card(*, work_order_no: str, facts: dict[str, str], first_or_same: str = "first") -> str:
|
||||
"""
|
||||
建单后的询价确认。
|
||||
|
||||
无标题、无 [test]。first_or_same 保留兼容，不再对销售展示。
|
||||
"""
|
||||
_ = first_or_same
|
||||
lines = inquiry_field_lines(work_order_no=work_order_no, facts=facts)
|
||||
lines.append("工单已创建，正在查询TMS报价。")
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def canonical_button(raw: str) -> str:
|
||||
"""把销售点卡 / 原文 / 企微 EventKey 收成标准按钮文案；对不上返回空。"""
|
||||
text = (raw or "").strip().strip("【】")
|
||||
if text in {BTN_SKIP_COLLAB, BTN_SKIP_COLLAB_OLD, BTN_SKIP_COLLAB_KEY}:
|
||||
return BTN_SKIP_COLLAB
|
||||
# 新卡 EventKey 带工单号：skip_collab:WO…，避免点旧卡落到最新单
|
||||
if text.startswith(f"{BTN_SKIP_COLLAB_KEY}:"):
|
||||
return BTN_SKIP_COLLAB
|
||||
if text in {BTN_ADOPT_EXCEL, BTN_ADOPT_EXCEL_CARD, BTN_ADOPT_EXCEL_KEY} or text.startswith(
|
||||
f"{BTN_ADOPT_EXCEL_KEY}:"
|
||||
):
|
||||
return BTN_ADOPT_EXCEL
|
||||
if text in {BTN_ADOPT_PDF, BTN_ADOPT_PDF_CARD, BTN_ADOPT_PDF_KEY} or text.startswith(
|
||||
f"{BTN_ADOPT_PDF_KEY}:"
|
||||
):
|
||||
return BTN_ADOPT_PDF
|
||||
if text in {BTN_REJECT_KEY} or text.startswith(f"{BTN_REJECT_KEY}:"):
|
||||
return BTN_REJECT
|
||||
if text == BTN_SKIP_COLLAB_DONE:
|
||||
return ""
|
||||
for btn in (BTN_ADOPT_EXCEL, BTN_ADOPT_PDF, BTN_REJECT, BTN_DEAL, BTN_LOST, BTN_NEGOTIATE):
|
||||
if text == btn:
|
||||
return btn
|
||||
return ""
|
||||
|
||||
|
||||
def extract_work_order_no(text: str) -> str:
|
||||
"""从任意原话里抽出 WO + 12 位数字；没有则空。不判断意图。"""
|
||||
hit = _WO_NO.search(text or "")
|
||||
return hit.group(0).upper() if hit else ""
|
||||
|
||||
|
||||
def card_task_id(kind: str, work_order_no: str) -> str:
|
||||
"""
|
||||
每次出卡一个新 task_id。企微 42014：同一 task_id 不能再发，会整卡失败只剩文字。
|
||||
|
||||
工单号仍嵌在前缀里，点卡回调靠 work_order_from_card_meta 找回。
|
||||
"""
|
||||
stamp = f"{int(time.time() * 1000):x}{uuid.uuid4().hex[:4]}"
|
||||
return f"{kind}-{work_order_no}-{stamp}"
|
||||
|
||||
|
||||
def looks_like_continue_ticket(text: str) -> bool:
|
||||
"""
|
||||
无网夹具用的弱提示。正式环境必须由大模型判续办意图。
|
||||
禁止把本函数当成生产唯一路由。
|
||||
"""
|
||||
raw = (text or "").strip()
|
||||
if not raw:
|
||||
return False
|
||||
return any(token in raw for token in _CONTINUE_HINT)
|
||||
|
||||
|
||||
def work_order_from_card_meta(
|
||||
card_meta: dict[str, Any] | None = None,
|
||||
*,
|
||||
text: str = "",
|
||||
) -> str:
|
||||
"""
|
||||
从企微点卡回调用找回「点的是哪一张卡当时的工单」。
|
||||
|
||||
优先 TaskId / EventKey 里的工单号（quote-WO…、scheme-adopt_excel-WO…）。
|
||||
对不上返回空：调用方按该销售当前最新书签处理。
|
||||
"""
|
||||
src = card_meta or {}
|
||||
for raw in (
|
||||
str(src.get("task_id") or "").strip(),
|
||||
str(src.get("event_key") or "").strip(),
|
||||
(text or "").strip(),
|
||||
):
|
||||
no = _work_order_in_token(raw)
|
||||
if no:
|
||||
return no
|
||||
return ""
|
||||
|
||||
|
||||
def _work_order_in_token(raw: str) -> str:
|
||||
"""从 TaskId / EventKey 里抽出 WO 工单号；没有则空。"""
|
||||
text = (raw or "").strip()
|
||||
if not text:
|
||||
return ""
|
||||
for prefix in (
|
||||
f"{BTN_SKIP_COLLAB_KEY}:",
|
||||
f"{BTN_ADOPT_EXCEL_KEY}:",
|
||||
f"{BTN_ADOPT_PDF_KEY}:",
|
||||
f"{BTN_REJECT_KEY}:",
|
||||
):
|
||||
if text.startswith(prefix):
|
||||
rest = text[len(prefix) :].strip()
|
||||
if rest.upper().startswith("WO"):
|
||||
return extract_work_order_no(rest) or rest.split("-", 1)[0]
|
||||
# 卡片 task_id 会带时间后缀（scheme-WO…-abc），只取 WO+12 位。
|
||||
return extract_work_order_no(text)
|
||||
|
||||
|
||||
_CURRENCY_PREFIX = re.compile(r"^[A-Za-z]{3}\b")
|
||||
|
||||
|
||||
def money_text(amount: Any, currency: str = "") -> str:
|
||||
"""
|
||||
销售可见金额：TMS 有币种就写成「CNY 14669.60」。
|
||||
|
||||
金额已带三字码前缀则原样。没有币种不编造 CNY/USD。
|
||||
"""
|
||||
raw = str(amount if amount not in (None, "") else "").strip()
|
||||
if not raw or raw == "-":
|
||||
return raw or "-"
|
||||
if _CURRENCY_PREFIX.match(raw):
|
||||
return raw
|
||||
code = str(currency or "").strip().upper()
|
||||
if code == "RMB":
|
||||
code = "CNY"
|
||||
if not code:
|
||||
return raw
|
||||
return f"{code} {raw}"
|
||||
|
||||
|
||||
def quote_fee_lines(quote: dict[str, Any] | None) -> list[tuple[str, str]]:
|
||||
"""
|
||||
价格明细行：优先 TMS fee_lines，否则用运费/其它/合计兜底。
|
||||
|
||||
返回 (费用名, 金额) ，空金额不展示。金额带 TMS 币种，不编造。
|
||||
"""
|
||||
src = dict(quote or {})
|
||||
header_ccy = str(src.get("currency") or src.get("currencyCode") or "").strip()
|
||||
raw = src.get("fee_lines")
|
||||
parsed: Any = raw
|
||||
if isinstance(raw, str) and raw.strip():
|
||||
try:
|
||||
parsed = json.loads(raw)
|
||||
except json.JSONDecodeError:
|
||||
parsed = None
|
||||
lines: list[tuple[str, str]] = []
|
||||
if isinstance(parsed, list):
|
||||
for item in parsed:
|
||||
if not isinstance(item, dict):
|
||||
continue
|
||||
name = str(item.get("name") or item.get("label") or "").strip()
|
||||
amount = str(item.get("amount") or item.get("value") or "").strip()
|
||||
line_ccy = str(item.get("currency") or item.get("currencyCode") or header_ccy).strip()
|
||||
if name and amount and amount != "-":
|
||||
lines.append((name, money_text(amount, line_ccy)))
|
||||
if lines:
|
||||
return lines
|
||||
freight = str(src.get("freight") or "").strip()
|
||||
other = str(src.get("other_fee") or "").strip()
|
||||
if freight and freight != "-":
|
||||
lines.append(("空运费", money_text(freight, header_ccy)))
|
||||
if other and other != "-":
|
||||
lines.append(("其他附加费", money_text(other, header_ccy)))
|
||||
return lines
|
||||
|
||||
|
||||
def quote_area_fee_text(quote: dict[str, Any] | None) -> str:
|
||||
"""
|
||||
卡片引用条正文：费用行 + 总销售价合计。
|
||||
|
||||
必须走 quote_text。塞进 quote_area.title 会被企微整段藏掉。
|
||||
"""
|
||||
src = dict(quote or {})
|
||||
header_ccy = str(src.get("currency") or src.get("currencyCode") or "").strip()
|
||||
total = money_text(str(src.get("total") or "-").strip() or "-", header_ccy)
|
||||
fee_lines = [f"{name}：{amount}" for name, amount in quote_fee_lines(src)]
|
||||
fee_lines.append(f"总销售价合计：{total}")
|
||||
return "\n".join(fee_lines)
|
||||
|
||||
|
||||
def collab_hint(work_order_no: str) -> str:
|
||||
"""价格卡协同说明：无「内部协同」前缀，紧挨生成报价单按钮上方。"""
|
||||
return (
|
||||
f"若需要咨询内部航线人员，请手动拉新人与智能体到原有群，"
|
||||
f"并在群聊发送工单编号{work_order_no}。"
|
||||
)
|
||||
|
||||
|
||||
def _strip_leading_dash(raw: str) -> str:
|
||||
"""去掉时效前导 '-' / '—'，避免销售看到「-3-5天」或「-；3-5天」。"""
|
||||
text = (raw or "").strip()
|
||||
while text.startswith(("-", "—", "–")):
|
||||
rest = text[1:].lstrip(" \t；;，,")
|
||||
if not rest:
|
||||
return ""
|
||||
text = rest
|
||||
return text
|
||||
|
||||
|
||||
def tms_eta_display(quote: dict[str, Any] | None) -> str:
|
||||
"""时效只取 TMS 回的 eta / 预计送达；没有就「-」。禁止本地编。前导横杠会剥掉。"""
|
||||
src = dict(quote or {})
|
||||
eta = _strip_leading_dash(str(src.get("eta") or ""))
|
||||
if eta:
|
||||
return eta
|
||||
dated = _strip_leading_dash(
|
||||
str(src.get("eta_date") or src.get("estimated_delivery") or "")
|
||||
)
|
||||
return dated or "-"
|
||||
|
||||
|
||||
def tms_valid_until_display(quote: dict[str, Any] | None) -> str:
|
||||
"""报价有效期只取 TMS 原文，没有就 "-"。"""
|
||||
src = dict(quote or {})
|
||||
raw = str(
|
||||
src.get("valid_until")
|
||||
or src.get("validUntil")
|
||||
or src.get("quoteValidUntil")
|
||||
or ""
|
||||
).strip()
|
||||
return raw if raw else "-"
|
||||
|
||||
|
||||
def similar_inquiry_line(*, first_or_same: str, history_work_order_no: str = "") -> str:
|
||||
"""
|
||||
相同询价内容检索：首次询价，或引用全库最新一条一模一样的历史工单号。
|
||||
"""
|
||||
no = (history_work_order_no or "").strip()
|
||||
if first_or_same == "same" and no:
|
||||
return f"相同询价内容检索：引用历史工单号{no}"
|
||||
return "相同询价内容检索：首次询价"
|
||||
|
||||
|
||||
def quote_detail_lines(
|
||||
quote: dict[str, Any] | None,
|
||||
*,
|
||||
first_or_same: str = "first",
|
||||
history_work_order_no: str = "",
|
||||
status: str = "已报价",
|
||||
) -> list[str]:
|
||||
"""
|
||||
价格明细正文：TMS 费用、合计、时效、有效期、相同检索。
|
||||
|
||||
给文本兜底和企微引用条共用，禁止在这里编时效/有效期。价格卡不再展示工单状态。
|
||||
"""
|
||||
_ = status
|
||||
src = dict(quote or {})
|
||||
header_ccy = str(src.get("currency") or src.get("currencyCode") or "").strip()
|
||||
total = money_text(str(src.get("total") or "-").strip() or "-", header_ccy)
|
||||
lines = [f"{name}：{amount}" for name, amount in quote_fee_lines(src)]
|
||||
lines.append(f"总销售价合计：{total}")
|
||||
lines.append(f"时效：{tms_eta_display(src)}")
|
||||
lines.append(f"报价有效期：{tms_valid_until_display(src)}")
|
||||
lines.append(
|
||||
similar_inquiry_line(
|
||||
first_or_same=first_or_same, history_work_order_no=history_work_order_no
|
||||
)
|
||||
)
|
||||
return lines
|
||||
|
||||
|
||||
def tms_hit_card(
|
||||
*,
|
||||
work_order_no: str,
|
||||
quote: dict[str, Any],
|
||||
first_or_same: str = "first",
|
||||
history_work_order_no: str = "",
|
||||
status: str = "已报价",
|
||||
) -> str:
|
||||
"""
|
||||
有价后的价格明细（文本兜底，模板卡发失败时仍给销售看）。
|
||||
|
||||
顺序：来源 → 价格明细 → 报价正文 → 协同说明 → 按钮。
|
||||
"""
|
||||
src = dict(quote or {})
|
||||
source = str(src.get("source_label") or "TMS标准报价").replace(" ", "")
|
||||
lines = [source, f"{work_order_no}价格明细"]
|
||||
lines.extend(
|
||||
quote_detail_lines(
|
||||
src,
|
||||
first_or_same=first_or_same,
|
||||
history_work_order_no=history_work_order_no,
|
||||
status=status,
|
||||
)
|
||||
)
|
||||
lines.append("")
|
||||
lines.append(collab_hint(work_order_no))
|
||||
lines.append(BTN_SKIP_COLLAB)
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def tms_hit_wecom_payload(
|
||||
*,
|
||||
work_order_no: str,
|
||||
quote: dict[str, Any],
|
||||
first_or_same: str = "first",
|
||||
history_work_order_no: str = "",
|
||||
status: str = "已报价",
|
||||
) -> dict[str, Any]:
|
||||
"""
|
||||
一张价格卡，销售侧顺序：
|
||||
|
||||
价格明细
|
||||
┌ 引用条：空运费 / 其它费用 / 总销售价合计
|
||||
时效、报价有效期、相同询价内容检索
|
||||
协同说明（普通文字，贴按钮上方）
|
||||
按钮
|
||||
|
||||
企微 quote_area.title 只能很短，超长会被整段藏掉。报价必须放 quote_text。
|
||||
不用 horizontal：它会排到副标题后面，把费用挤到按钮前。
|
||||
"""
|
||||
src = dict(quote or {})
|
||||
source = str(src.get("source_label") or "TMS标准报价").replace(" ", "")
|
||||
meta = "\n".join(
|
||||
[
|
||||
f"时效：{tms_eta_display(src)}",
|
||||
f"报价有效期：{tms_valid_until_display(src)}",
|
||||
similar_inquiry_line(
|
||||
first_or_same=first_or_same, history_work_order_no=history_work_order_no
|
||||
),
|
||||
"",
|
||||
collab_hint(work_order_no),
|
||||
]
|
||||
)
|
||||
return {
|
||||
"msgtype": "template_card",
|
||||
"template_card": {
|
||||
"card_type": "button_interaction",
|
||||
"source": {"desc": source, "desc_color": 0},
|
||||
"main_title": {"title": f"{work_order_no}价格明细"},
|
||||
"quote_area": {
|
||||
"type": 0,
|
||||
"quote_text": quote_area_fee_text(src),
|
||||
},
|
||||
"sub_title_text": meta,
|
||||
"task_id": card_task_id("quote", work_order_no),
|
||||
"button_list": [
|
||||
{
|
||||
"text": BTN_SKIP_COLLAB,
|
||||
"style": 1,
|
||||
# EventKey 也带工单号：TaskId 偶发缺失时仍能找回当时那一单
|
||||
"key": f"{BTN_SKIP_COLLAB_KEY}:{work_order_no}",
|
||||
}
|
||||
],
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def skip_collab_card_update(*, response_code: str) -> dict[str, Any]:
|
||||
"""
|
||||
点过「生成报价单」后更新原卡：按钮改成已提交并保持置灰。
|
||||
|
||||
必须带企微回调 ResponseCode；无码则不要入出站。
|
||||
"""
|
||||
return {
|
||||
"msgtype": "update_template_card",
|
||||
"response_code": response_code,
|
||||
"button": {"replace_name": BTN_SKIP_COLLAB_DONE},
|
||||
}
|
||||
|
||||
|
||||
def tms_miss_quote_text(*, work_order_no: str) -> str:
|
||||
"""引用条正文：只放「请务必在群聊发送工单编号」。"""
|
||||
return f"请务必在群聊发送工单编号{work_order_no}"
|
||||
|
||||
|
||||
def tms_miss_hint() -> str:
|
||||
"""卡片正文：无价说明 + 拉群提示，不单独再写标题下灰字。"""
|
||||
return "TMS标准价库暂无匹配报价，请手动拉新人与智能体到原有群"
|
||||
|
||||
|
||||
def tms_miss(*, work_order_no: str) -> str:
|
||||
"""
|
||||
TMS 已经查过、确认没标准价时的文字兜底。
|
||||
禁止在没打 TMS 前用本句冒充无价。
|
||||
"""
|
||||
return (
|
||||
f"TMS暂无报价。{tms_miss_hint()}，"
|
||||
f"{tms_miss_quote_text(work_order_no=work_order_no)}"
|
||||
)
|
||||
|
||||
|
||||
def tms_miss_wecom_payload(*, work_order_no: str, action_url: str = "") -> dict[str, Any]:
|
||||
"""
|
||||
TMS 已查过、确认没价：一张 text_notice 卡。
|
||||
|
||||
顺序：来源 → 标题（仅工单号+暂无报价）→ 引用条（工单编号）→ 拉群说明。
|
||||
禁止：标题下灰字、工单状态、查价结果/来源行、按钮。
|
||||
企微 text_notice 必须带可信域名 card_action，否则整卡发失败只剩文字。
|
||||
"""
|
||||
card: dict[str, Any] = {
|
||||
"card_type": "text_notice",
|
||||
"source": {"desc": "TMS查价结果", "desc_color": 0},
|
||||
"main_title": {"title": f"{work_order_no}暂无报价"},
|
||||
"quote_area": {
|
||||
"type": 0,
|
||||
"quote_text": tms_miss_quote_text(work_order_no=work_order_no),
|
||||
},
|
||||
"sub_title_text": tms_miss_hint(),
|
||||
"task_id": card_task_id("miss", work_order_no),
|
||||
}
|
||||
url = (action_url or "").strip()
|
||||
if url:
|
||||
card["card_action"] = {"type": 1, "url": url}
|
||||
return {"msgtype": "template_card", "template_card": card}
|
||||
|
||||
|
||||
def tms_contract_gap(*, work_order_no: str) -> str:
|
||||
"""已废弃：不再因字典对不上拦查价；保留以免旧单测/引用报错。"""
|
||||
return tms_miss(work_order_no=work_order_no)
|
||||
|
||||
|
||||
def tms_need_more(*, work_order_no: str, hint: str = "") -> str:
|
||||
"""已废弃：TMS 回 1003 按合同收成暂无报价。保留以免旧引用报错。"""
|
||||
_ = hint
|
||||
return tms_miss(work_order_no=work_order_no)
|
||||
|
||||
|
||||
def skip_collab_ack() -> str:
|
||||
return "好的，已跳过内部协同。正在按 TMS 标准报价生成报价单草稿…"
|
||||
|
||||
|
||||
def scheme_card(*, work_order_no: str, status: str, facts: dict[str, str], quote: dict[str, Any]) -> str:
|
||||
"""
|
||||
报价方案文本兜底（模板卡发失败时仍给销售看）。
|
||||
|
||||
与卡片同一套字段，禁止漏项。不再展示工单状态。
|
||||
"""
|
||||
_ = status
|
||||
src = dict(quote or {})
|
||||
# 方案卡不展示询价「报价日期」，改展示 TMS 报价有效期
|
||||
body = "\n".join(
|
||||
line
|
||||
for line in inquiry_field_lines(work_order_no=work_order_no, facts=facts)
|
||||
if not line.startswith("报价日期：")
|
||||
)
|
||||
eta = tms_eta_display(src)
|
||||
valid = tms_valid_until_display(src)
|
||||
lines = [
|
||||
f"【{work_order_no}报价方案】",
|
||||
body,
|
||||
"价格明细",
|
||||
quote_area_fee_text(src),
|
||||
f"时效：{eta or '-'}",
|
||||
f"报价有效期：{valid}",
|
||||
"请确认是否采用该报价方案：",
|
||||
f"【{BTN_ADOPT_EXCEL_CARD}】",
|
||||
f"【{BTN_ADOPT_PDF_CARD}】",
|
||||
f"【{BTN_REJECT}】",
|
||||
]
|
||||
return "\n".join(lines)
|
||||
|
||||
|
||||
def _clip(raw: str, limit: int) -> str:
|
||||
"""企微列表格有字数建议；超长才裁，避免空白。"""
|
||||
text = (raw or "").strip() or "-"
|
||||
return text if len(text) <= limit else text[: limit - 1] + "…"
|
||||
|
||||
|
||||
def scheme_horizontal_rows(
|
||||
*,
|
||||
work_order_no: str,
|
||||
facts: dict[str, str],
|
||||
quote: dict[str, Any],
|
||||
) -> list[dict[str, str]]:
|
||||
"""
|
||||
卡片字段：一行一项，每格独立字数，不会像副标题整段截成 8CB…。
|
||||
|
||||
企微 horizontal 最多 6 条。运输方式写进航线行，避免丢字段。
|
||||
不用 sub_title 堆字段（它会排到列表前面，且超长必截断）。
|
||||
"""
|
||||
src = facts or {}
|
||||
q = dict(quote or {})
|
||||
origin = (src.get("起运港") or "-").strip() or "-"
|
||||
dest = (src.get("目的港") or "-").strip() or "-"
|
||||
cargo = (src.get("品名") or "-").strip() or "-"
|
||||
pieces = _with_unit(str(src.get("件数") or ""), "件")
|
||||
weight = _with_unit(str(src.get("毛重") or ""), "KGS")
|
||||
volume = _with_unit(str(src.get("体积") or ""), "CBM")
|
||||
pack = (src.get("包装方式") or src.get("包装类型") or "-").strip() or "-"
|
||||
return [
|
||||
{"keyname": "工单号", "value": _clip(work_order_no, 26)},
|
||||
{"keyname": "航线", "value": _clip(f"空运 {origin}→{dest}", 26)},
|
||||
{"keyname": "货物", "value": _clip(f"{cargo}；{pieces}；{weight}；{volume}", 26)},
|
||||
{"keyname": "包装", "value": _clip(pack, 26)},
|
||||
{"keyname": "时效", "value": _clip(tms_eta_display(q), 26)},
|
||||
{"keyname": "报价有效期", "value": _clip(tms_valid_until_display(q), 26)},
|
||||
]
|
||||
|
||||
|
||||
def scheme_wecom_payload(
|
||||
*,
|
||||
work_order_no: str,
|
||||
facts: dict[str, str],
|
||||
quote: dict[str, Any],
|
||||
status: str = "已报价",
|
||||
) -> dict[str, Any]:
|
||||
"""
|
||||
一张报价方案卡：标题带工单号、引用条、字段、三个短按钮。
|
||||
|
||||
按钮文案必须短：生成Excel / 生成PDF / 不采用。长文案横排会被裁。
|
||||
"""
|
||||
_ = status
|
||||
src = dict(quote or {})
|
||||
source = str(src.get("source_label") or "TMS标准报价").replace(" ", "")
|
||||
return {
|
||||
"msgtype": "template_card",
|
||||
"template_card": {
|
||||
"card_type": "button_interaction",
|
||||
"source": {"desc": source, "desc_color": 0},
|
||||
"main_title": {"title": f"{work_order_no}报价方案"},
|
||||
"quote_area": {
|
||||
"type": 0,
|
||||
"quote_text": quote_area_fee_text(src),
|
||||
},
|
||||
"horizontal_content_list": scheme_horizontal_rows(
|
||||
work_order_no=work_order_no, facts=facts, quote=src
|
||||
),
|
||||
"task_id": card_task_id("scheme", work_order_no),
|
||||
"button_list": [
|
||||
{
|
||||
"text": BTN_ADOPT_EXCEL_CARD,
|
||||
"style": 1,
|
||||
"key": f"{BTN_ADOPT_EXCEL_KEY}:{work_order_no}",
|
||||
},
|
||||
{
|
||||
"text": BTN_ADOPT_PDF_CARD,
|
||||
"style": 1,
|
||||
"key": f"{BTN_ADOPT_PDF_KEY}:{work_order_no}",
|
||||
},
|
||||
{
|
||||
"text": BTN_REJECT,
|
||||
"style": 2,
|
||||
"key": f"{BTN_REJECT_KEY}:{work_order_no}",
|
||||
},
|
||||
],
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def reject_ack() -> str:
|
||||
return "请问如何调整报价单，以满足您的需求？您可使用「报价加 10%」等调价指令。"
|
||||
|
||||
|
||||
def adopt_excel_ack() -> str:
|
||||
return "已确认采用该方案，正在生成 Excel 最终报价单…"
|
||||
|
||||
|
||||
def adopt_pdf_ack() -> str:
|
||||
return "已确认采用该方案，正在生成PDF最终报价单…"
|
||||
|
||||
|
||||
QUOTE_TEMPLATE_MISSING = "生成报价单失败，请联系IT运维维护后台报价模板。"
|
||||
|
||||
|
||||
def quote_template_missing() -> str:
|
||||
"""关键词与默认模板都未维护时的销售提示（产品口径，勿改字）。"""
|
||||
return QUOTE_TEMPLATE_MISSING
|
||||
|
||||
|
||||
def file_ready(*, kind: str, work_order_no: str, filename: str) -> str:
|
||||
return f"已生成{kind}最终报价单：{filename}（工单 {work_order_no}）"
|
||||
|
||||
|
||||
def deal_card(*, work_order_no: str, status: str, summary: str) -> str:
|
||||
return (
|
||||
"【咨询成交状态】\n"
|
||||
f"工单编号：{work_order_no}\n"
|
||||
f"工单状态：{status}\n"
|
||||
f"询价内容：{summary}\n"
|
||||
"请立即确认当前与客户沟通的成交状态：\n"
|
||||
f"【{BTN_DEAL}】【{BTN_LOST}】【{BTN_NEGOTIATE}】"
|
||||
)
|
||||
|
||||
|
||||
def deal_ack(outcome: str, work_order_no: str) -> str:
|
||||
if outcome == "已成交":
|
||||
return f"已记录为「已成交」。工单 {work_order_no} 已关闭智能体跟进。"
|
||||
if outcome == "未成交":
|
||||
return f"已记录为「未成交」。请补充未成交原因，工单 {work_order_no} 将关闭智能体跟进。"
|
||||
return f"已记录为「协商中」。工单 {work_order_no} 跟进周期已顺延。"
|
||||
Reference in New Issue
Block a user