空运「货交」只记提货地址,不再当成起运地。舱位旧说法「释放」先问航线是否取消,陆运通关口岸示例改为友谊关。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-10-11 20:45:53 +08:00
co-authored by Cursor
parent b070a9b7a7
commit 185abbf45e
16 changed files with 533 additions and 49 deletions
@@ -53,6 +53,8 @@ from agent.routing.air_group_intent import (
INTENT_PICK_OPTION,
INTENT_QUOTE,
INTENT_RELEASE,
INTENT_RELEASE_ASK,
cabin_confirm_answer,
classify_air_group_text,
)
@@ -167,6 +169,9 @@ def handle_air_group(
return "duplicate_inbound"
mark_air_text(chat_id=chat_id, sender_id=message.sender_id, text=text)
wo = copy.extract_work_order_no(text)
answered = _answer_pending_cabin_cancel(engine, message, text)
if answered:
return answered
# 句中有多段工单号,或本群已经激活过多段单:跟这张单,不必每句再带工单号。
followed = _follow_activated_multi(
engine,
@@ -200,7 +205,7 @@ def handle_air_group(
intent,
wo or "-",
)
if intent in {INTENT_LOCK, INTENT_RELEASE}:
if intent in {INTENT_LOCK, INTENT_RELEASE, INTENT_RELEASE_ASK}:
return _handle_cabin(
engine,
message,
@@ -309,6 +314,92 @@ def _should_speak_activate(intent: str) -> bool:
return intent in {INTENT_ACTIVATE, INTENT_OTHER}
def _answer_pending_cabin_cancel(engine, message: InboundMessage, text: str) -> str:
"""
上一句已经问过是否取消舱位。
航线回是/需要/确认/取消舱位才执行。回否/不用/不需要就停。
销售回这些词不算。说了别的业务就清掉询问,按那句话继续办。
没有待确认时返回空串。
"""
from agent.policy.air_group_ops import is_airline
from agent.redis_coord.pending_cabin_cancel import (
clear_pending_cabin_cancel,
load_pending_cabin_cancel,
)
chat_id = (message.chat_id or "").strip()
pending_wo = load_pending_cabin_cancel(chat_id)
if not pending_wo:
return ""
kind = cabin_confirm_answer(text)
if not kind:
clear_pending_cabin_cancel(chat_id)
logger.info("cabin.ask dropped chat=%s wo=%s", chat_id, pending_wo)
return ""
if not is_airline(engine, message.sender_id):
send_group_text(group_client_of(engine), chat_id, copy.air_airline_only_cabin())
return "not_airline"
clear_pending_cabin_cancel(chat_id)
if kind == "no":
send_group_text(group_client_of(engine), chat_id, copy.air_release_ask_dropped())
return "release_ask_dropped"
ticket, phase = resolve_cabin_ticket(
flow=engine,
chat_id=chat_id,
work_order_no=pending_wo,
allow_terminal=True,
)
if ticket is None:
return phase
return apply_air_release(
flow=engine,
ticket=ticket,
sender_id=message.sender_id,
chat_id=chat_id,
instruction=text,
)
def _ask_cabin_cancel(
engine,
message: InboundMessage,
*,
work_order_no: str,
) -> str:
"""航线说了释放舱位:只提问,不打 TMS。"""
from agent.policy.air_group_ops import is_airline
from agent.redis_coord.pending_cabin_cancel import save_pending_cabin_cancel
chat_id = message.chat_id
if not is_airline(engine, message.sender_id):
send_group_text(group_client_of(engine), chat_id, copy.air_airline_only_cabin())
return "not_airline"
no = (work_order_no or "").strip()
if not no:
bound = current_ticket(engine, chat_id)
if bound is not None and is_air_ticket(bound):
from agent.policy.sea_group_ops import ticket_no
no = ticket_no(bound)
if not no:
send_group_text(group_client_of(engine), chat_id, copy.air_lock_need_work_order())
return "cabin_need_work_order"
ticket, phase = resolve_cabin_ticket(
flow=engine,
chat_id=chat_id,
work_order_no=no,
allow_terminal=True,
)
if ticket is None:
return phase
from agent.policy.sea_group_ops import ticket_no
save_pending_cabin_cancel(chat_id, ticket_no(ticket))
send_group_text(group_client_of(engine), chat_id, copy.air_release_ask())
return "release_ask"
def _handle_cabin(
engine,
message: InboundMessage,
@@ -319,6 +410,12 @@ def _handle_cabin(
) -> str:
_ = injected_quote
chat_id = message.chat_id
if intent == INTENT_RELEASE_ASK:
return _ask_cabin_cancel(
engine,
message,
work_order_no=work_order_no,
)
if not work_order_no:
# 本群已经在锁这张单时,补舱位不用再报工单号。
bound = current_ticket(engine, chat_id)
+64
View File
@@ -371,6 +371,68 @@ def _tighten_sheet_labels(text: str) -> str:
return body
# 「货交上海」是提货地址,不是起运地。地址/地、到/于只是口语粘连,不进地址正文。
_RE_CARGO_HANDOVER = re.compile(
r"货交\s*(?:地址|地)?\s*[::]?\s*(?:到|于|至|往)?\s*([^\n,,。;;]{1,60})"
)
# 同一行跟在地址后面的询价口头禅或下一栏字段,不是地址的一部分。
_RE_HANDOVER_TAIL = re.compile(
r"(?:\s+|,|,)?(?:看看价格|看一下价格|看价格|询价|报价|多少钱|多少|"
r"目的地|目的港|起运地|起运港|品名|件数|毛重|体积|包装|空运|海运|陆运).*$"
)
# 另有起运说法时保留起运地。先抠掉「货交…」,避免「货交到上海」被当成「到上海」。
_RE_EXPLICIT_ORIGIN = re.compile(
r"起运地|起运港|"
r"[A-Za-z]{3}\s*[-–—//]\s*[A-Za-z]{3}|"
r"[A-Za-z]{3}\s*(?:到|至)\s*[A-Za-z]{3}|"
r"从\s*\S{1,16}\s*(?:飞|到|至)|"
r"[\u4e00-\u9fff]{2,12}\s*飞|"
r"[\u4e00-\u9fff]{2,12}\s*到\s*[\u4e00-\u9fffA-Za-z]{2,12}"
)
def _handover_place(raw: str) -> str:
"""货交后面的地名。去掉口头禅和首尾标点,空的不当地址。"""
place = _RE_HANDOVER_TAIL.sub("", (raw or "").strip())
return place.strip(" ::,,。;;")
def _has_explicit_origin(text: str) -> bool:
"""原话里另写了起运地、三字码航线或「从哪飞/到」。货交那一段先拿掉。"""
stripped = _RE_CARGO_HANDOVER.sub(" ", text or "")
return _RE_EXPLICIT_ORIGIN.search(stripped) is not None
def apply_cargo_handover_synonym(
text: str,
facts: dict[str, str] | None,
*,
business_line: str = "",
) -> dict[str, str]:
"""
货交 = 提货地址。例:货交上海 → 提货地址上海。
只认原话里的「货交」,不把裸城市猜成港口。
空运且没有另写起运地时,清掉被误收成起运地的同一处地名,否则 TMS 会按错误起运查价。
海运/陆运只补提货地址,不动起运港。副作用:无。
"""
merged = dict(facts or {})
places: list[str] = []
for hit in _RE_CARGO_HANDOVER.finditer(text or ""):
place = _handover_place(hit.group(1))
if place and place not in places:
places.append(place)
if not places:
return merged
merged["提货地址"] = "、".join(places)
is_air = (business_line or "").strip().upper() == "AIR" or "空运" in (text or "")
if is_air and not _has_explicit_origin(text):
merged.pop("起运港", None)
merged.pop("起运地", None)
merged.pop("originCode", None)
return merged
def _drop_fee_place_values(facts: dict[str, str]) -> dict[str, str]:
"""起运地/目的地收成「操作费、文件费」时丢掉。那是费用栏,不是港口。"""
out = dict(facts or {})
@@ -407,6 +469,7 @@ def extract_inquiry_snapshot(
facts = harvest_oral_measures(text, normalize_facts(dict(injected_facts)))
facts = _merge_spoken_collab(text, facts)
facts = _merge_optional_inquiry_labels(text, facts)
facts = apply_cargo_handover_synonym(text, facts, business_line=mode)
for key in ("货好时间", "提货地址", "收货地址", "货源地", "贸易条款"):
if str(facts.get(key) or "").strip():
facts[key] = clip_inquiry_value(str(facts[key]))
@@ -453,6 +516,7 @@ def extract_inquiry_snapshot(
facts = harvest_oral_measures(text, normalize_facts(facts))
facts = _merge_spoken_collab(text, facts)
facts = _merge_optional_inquiry_labels(text, facts)
facts = apply_cargo_handover_synonym(text, facts, business_line=mode)
for key in ("货好时间", "提货地址", "收货地址", "货源地", "贸易条款"):
if str(facts.get(key) or "").strip():
facts[key] = clip_inquiry_value(str(facts[key]))
@@ -35,6 +35,7 @@ _FIELD_KEYS = (
"车型数量",
"通关口岸",
"贸易条款",
"提货地址",
)
@@ -134,6 +135,8 @@ def build_extract_messages(text: str) -> list[dict[str, str]]:
"陆运「通关口岸:皇岗」「通关口岸皇岗」「过皇岗」有说就写入通关口岸,没说留空,禁止编造口岸。"
"原话单独出现 DAP、DDP、CIF、CIP、FOB、EXW 时写入贸易条款;没出现留空,禁止编造。"
"「从南京飞吉隆坡」起运港=南京、目的港=吉隆坡;「北京飞吉隆坡」起运港=北京。"
"「货交上海」「货交:上海」「货交到上海」是提货地址=上海,不是起运港。"
"没有另写起运地、三字码航线或「从哪飞/到」时,起运港必须空串。"
"原话是机场三字码或航线就原样记,禁止翻译成城市名:"
"SZX-CGK / SZX/CGK / SZX到CGK → 起运港=SZX、目的港=CGK,不要写成深圳、雅加达。"
"换城市必须覆盖旧值,不要沿用上一句的港口。"
+2 -2
View File
@@ -1068,7 +1068,7 @@ def apply_air_release(
send_group_text(
group_client_of(flow),
chat_id,
copy.air_release_fail(work_order_no=no, operator=name, reason="主账未开放释放"),
copy.air_release_fail(work_order_no=no, operator=name, reason="主账未开放取消舱位"),
)
return "release_unavailable"
from agent.policy.system_exception import (
@@ -1104,7 +1104,7 @@ def apply_air_release(
event=SystemExceptionEvent(
exception_type=TYPE_TMS,
step=STEP_TMS_RELEASE,
reason="空运释放舱位接口调用失败",
reason="空运取消舱位接口调用失败",
service="空运舱位",
error_code=why or "RELEASE_FAIL",
work_order_no=no,
+44 -16
View File
@@ -39,6 +39,24 @@ def _r(code: str, default: str, **kwargs: Any) -> str:
return render(code, default, **kwargs)
def _cabin_copy(code: str, default: str, **kwargs: Any) -> str:
"""
舱位话术。库里旧句仍写「释放」时,新发出的改用当前默认句。
先把填进去的原因、工单号抠掉再看骨架,避免 TMS 原文里的「释放」把新句子打回去。
已经发出的历史消息不在这里改。
"""
text = _r(code, default, **kwargs)
skeleton = text
for value in kwargs.values():
token = str(value or "")
if token:
skeleton = skeleton.replace(token, "")
if "释放" in skeleton:
return default
return text
# 空运补问:必填 7 项 + 非必填。报价日期默认当天,不进待补充。
_AIR_EXAMPLES = {
"起运港": "南京",
@@ -314,7 +332,7 @@ _LAND_EXAMPLES = {
"体积": "100CBM",
"毛重": "50kg",
"车型/数量": "9米6/1",
"通关口岸": "皇岗",
"通关口岸": "友谊关",
"运输类型": "国内运输拼车",
"线路类别": "国内长途/零担",
"运输分类": "急件",
@@ -2879,9 +2897,9 @@ def air_need_work_order() -> str:
def air_lock_need_work_order() -> str:
"""锁舱/释放必须自带工单号。后台 inquiring.air_lock_need_wo。"""
return _r(
return _cabin_copy(
"inquiring.air_lock_need_wo",
"锁舱或释放舱位请带上工单号,例如 WO202609160001锁舱。",
"锁舱或取消舱位请带上工单号,例如 WO202609160001取消舱位。",
)
@@ -3041,9 +3059,9 @@ def air_airline_only_quote() -> str:
def air_airline_only_cabin() -> str:
"""只有航线能锁舱或释放。后台 inquiring.air_airline_only_cabin。"""
return _r(
return _cabin_copy(
"inquiring.air_airline_only_cabin",
"只有岗位为「航线·空运」的人能锁舱或释放舱位。",
"只有岗位为「航线·空运」的人能锁舱或取消舱位。",
)
@@ -3264,13 +3282,13 @@ def air_release_ok(
) -> str:
"""空运释放成功。后台 inquiring.air_release_ok。"""
default = (
f"工单{work_order_no} 已通知TMS执行空运释放舱位成功\n"
f"工单{work_order_no} 已通知TMS执行空运取消舱位成功\n"
f"操作人:{operator}\n"
f"舱位选项:{option_no}\n"
f"执行编号:{exec_no}\n"
f"报价编号:{quote_no}"
)
return _r(
return _cabin_copy(
"inquiring.air_release_ok",
default,
ticket_no=work_order_no,
@@ -3285,12 +3303,12 @@ def air_release_fail(*, work_order_no: str, operator: str, reason: str) -> str:
"""空运释放失败。后台 inquiring.air_release_fail。"""
why = (reason or "").strip() or "TMS未返回原因"
default = (
f"工单{work_order_no} 空运释放舱位失败。\n"
f"工单{work_order_no} 空运取消舱位失败。\n"
f"操作人:{operator}\n"
f"释放舱位失败的原因:{why}\n"
f"取消舱位失败的原因:{why}\n"
"已通知IT运维排查,请稍等。"
)
return _r(
return _cabin_copy(
"inquiring.air_release_fail",
default,
ticket_no=work_order_no,
@@ -3302,9 +3320,9 @@ def air_release_fail(*, work_order_no: str, operator: str, reason: str) -> str:
def air_release_deal_blocked(work_order_no: str) -> str:
"""已成交不能释放舱位。后台 inquiring.air_release_deal_blocked。"""
no = (work_order_no or "").strip()
return _r(
return _cabin_copy(
"inquiring.air_release_deal_blocked",
f"释放舱位失败,工单{no}已成交。",
f"取消舱位失败,工单{no}已成交。",
ticket_no=no,
)
@@ -3312,9 +3330,9 @@ def air_release_deal_blocked(work_order_no: str) -> str:
def air_release_need_lock(work_order_no: str) -> str:
"""没有有效锁舱不能释放。后台 inquiring.air_release_need_lock。"""
no = (work_order_no or "").strip()
return _r(
return _cabin_copy(
"inquiring.air_release_need_lock",
f"工单{no}还没有有效锁舱,不能释放。",
f"工单{no}还没有有效锁舱,不能取消舱位。",
ticket_no=no,
)
@@ -3342,9 +3360,19 @@ SYS_EXC_RECOVERY_GROUP = "建群已恢复正常,感谢您的耐心等待。"
IMPACT_LLM_NO_TICKET = "尚未建单,不落后台工单"
IMPACT_LLM = "当前识别暂停,已有字段与工单状态保持不变"
IMPACT_TMS_QUOTE = "当前询价流程暂停,识别字段与原业务节点保持不变"
IMPACT_TMS_CABIN = "当前锁舱/释放暂停,工单状态保持不变"
IMPACT_TMS_CABIN = "当前锁舱/取消舱位暂停,工单状态保持不变"
IMPACT_TMS_LOCK = "锁舱失败,工单状态保持不变"
IMPACT_TMS_RELEASE = "释放舱位失败,工单状态保持不变"
IMPACT_TMS_RELEASE = "取消舱位失败,工单状态保持不变"
def air_release_ask() -> str:
"""航线说了和舱位有关的「释放」时先问,不直接取消。"""
return "是否需要取消舱位?"
def air_release_ask_dropped() -> str:
"""航线否认这次取消。不打 TMS。"""
return "已取消这次操作"
IMPACT_GROUP = "当前建群/加人暂停,已建群不新建第二个群"
+17 -3
View File
@@ -289,6 +289,15 @@ def _cabin(flow: Any, ticket: object, chat_id: str, sender_id: str, text: str, i
operator_name,
)
if intent == "ask":
if not is_airline(flow, sender_id):
send_group_text(group_client_of(flow), chat_id, copy.air_airline_only_cabin())
return "not_airline"
from agent.redis_coord.pending_cabin_cancel import save_pending_cabin_cancel
save_pending_cabin_cancel(chat_id, ticket_no(ticket))
send_group_text(group_client_of(flow), chat_id, copy.air_release_ask())
return "release_ask"
if intent == "release":
return apply_air_release(
flow=flow,
@@ -314,10 +323,15 @@ def _cabin(flow: Any, ticket: object, chat_id: str, sender_id: str, text: str, i
def _cabin_intent(text: str) -> str:
raw = text or ""
if "释放" in raw and "舱" in raw:
"""取消舱位马上办;和舱位有关的「释放」只提问。"""
from agent.routing.air_group_intent import cabin_release_kind
kind = cabin_release_kind(text or "")
if kind == "direct":
return "release"
if "锁舱" in raw:
if kind == "ask":
return "ask"
if "锁舱" in (text or ""):
return "lock"
return ""
@@ -888,7 +888,7 @@ def _resume_cabin_step(
is_ok=lambda x: bool((x or {}).get("ok")),
)
service = "空运舱位"
reason = "空运释放舱位接口调用失败"
reason = "空运取消舱位接口调用失败"
else:
# 与首次群锁舱对齐:重试必须带 operatorName / airline,否则 MANUAL 出站缺姓名。
locker = getattr(ledger, "lock_cabin", None)
+2
View File
@@ -57,6 +57,8 @@ QUOTE_FILE_READY = "quote_file_ready"
PENDING_PRODUCT_QUOTE = "pending_product_quote"
# 陆运核对卡已出、等确定查价:短协调,不当六态、不当工单号
PENDING_LAND_CONFIRM = "pending_land_confirm"
# 空运群问过「是否需要取消舱位」:短协调,不当六态
PENDING_CABIN_CANCEL = "pending_cabin_cancel"
# 空运/海运/陆运当前书签:HTTP 与 Worker 共用,不当六态
FLOW_BOOKMARK = "flow_bookmark"
# 私聊图片波次:HTTP 与 Worker 必须共用,不当六态
@@ -0,0 +1,72 @@
"""
空运群取消舱位待确认。
航线说出和舱位有关的「释放」后先问一句,确认前不打 TMS。
短协调,不当六态、不当 checkpoint。按群记下工单号,双进程仍能读到。
两小时没人接话就过期,避免过后回一个「是」误取消。
"""
from __future__ import annotations
import json
import logging
from agent.redis_coord.keys import PENDING_CABIN_CANCEL
from agent.redis_coord.runtime import get_redis_runtime
logger = logging.getLogger(__name__)
# 问句只在这一阵有效。过期后「是」不再取消舱位。
_TTL_SECONDS = 2 * 60 * 60
def save_pending_cabin_cancel(chat_id: str, work_order_no: str) -> None:
"""记下本群正在等航线确认取消哪张单。"""
room = (chat_id or "").strip()
no = (work_order_no or "").strip()
if not room or not no:
return
payload = {"work_order_no": no}
try:
client = get_redis_runtime().client
client.raw.set(
client.key(PENDING_CABIN_CANCEL, room),
json.dumps(payload, ensure_ascii=False),
ex=_TTL_SECONDS,
)
logger.info("cabin.ask saved chat=%s wo=%s", room, no)
except Exception:
logger.exception("写取消舱位待确认失败 chat=%s", room)
def load_pending_cabin_cancel(chat_id: str) -> str:
"""本群正在等确认的工单号。没有则空串。"""
room = (chat_id or "").strip()
if not room:
return ""
try:
client = get_redis_runtime().client
raw = client.raw.get(client.key(PENDING_CABIN_CANCEL, room))
if not raw:
return ""
if isinstance(raw, bytes):
raw = raw.decode("utf-8")
data = json.loads(raw)
if not isinstance(data, dict):
return ""
return str(data.get("work_order_no") or "").strip()
except Exception:
logger.exception("读取消舱位待确认失败 chat=%s", room)
return ""
def clear_pending_cabin_cancel(chat_id: str) -> None:
"""确认、否认或改口办别的事时清掉。"""
room = (chat_id or "").strip()
if not room:
return
try:
client = get_redis_runtime().client
client.raw.delete(client.key(PENDING_CABIN_CANCEL, room))
except Exception:
logger.exception("清取消舱位待确认失败 chat=%s", room)
@@ -35,12 +35,15 @@ logger = logging.getLogger(__name__)
INTENT_ACTIVATE = "air_activate"
INTENT_LOCK = "air_lock"
INTENT_RELEASE = "air_release"
# 说出和舱位有关的「释放」:先问是否取消,不直接执行。
INTENT_RELEASE_ASK = "air_release_ask"
INTENT_PICK_OPTION = "air_pick_option"
_VALID = {
INTENT_ACTIVATE,
INTENT_LOCK,
INTENT_RELEASE,
INTENT_RELEASE_ASK,
INTENT_PICK_OPTION,
INTENT_FIELDS,
INTENT_QUOTE,
@@ -56,7 +59,10 @@ _VALID = {
# 相近说法回退,不是唯一口令。
_LOCK_HINTS = ("锁舱", "锁仓", "锁定舱位", "锁住舱位", "帮我锁舱")
_RELEASE_HINTS = ("释放舱位", "放舱", "解锁舱", "取消锁舱", "释放舱")
# 这四句马上取消舱位。「释放舱位」不在这里。
_RELEASE_DIRECT = ("取消舱位", "放舱", "解锁舱", "取消锁舱")
_CONFIRM_YES = ("是", "需要", "确认")
_CONFIRM_NO = ("不需要", "不用", "否")
def is_missed_air_bot_at(text: str, *, room_already_air: bool = False) -> bool:
@@ -154,10 +160,53 @@ def classify_air_group_text(
return INTENT_OTHER
def _compact_cabin_text(text: str) -> str:
"""去掉空白,方便认「取消舱位」「释放舱位」。"""
return (text or "").replace(" ", "").replace(" ", "")
def cabin_release_kind(text: str) -> str:
"""
舱位取消怎么认。
direct:马上执行。ask:先问「是否需要取消舱位」。
跟舱位有关的「释放」只问不办。没说舱位的「释放」不当取消。
"""
blob = _compact_cabin_text(text)
# 「释放舱位」里含着「放舱」,必须先认释放,避免被放舱直接取消。
if "释放" in blob and "舱" in blob:
return "ask"
if any(hint in blob for hint in _RELEASE_DIRECT):
return "direct"
return ""
def cabin_confirm_answer(text: str) -> str:
"""
问过之后这一句是确认、否认,还是别的业务。
只认整句(可带工单号和 @)。「不需要」不能被看成「需要」。
返回 yes / no / 空串。空串表示询问作废,调用方按原句继续办。
"""
raw = text or ""
no = copy.extract_work_order_no(raw)
rest = raw.replace(no, "").replace(no.lower(), "")
rest = rest.replace("@询价小助手", "").replace("询价小助手", "")
rest = "".join(ch for ch in rest if ch.isalnum() or "\u4e00" <= ch <= "\u9fff")
if rest in _CONFIRM_NO:
return "no"
if rest in _CONFIRM_YES or rest == "取消舱位":
return "yes"
return ""
def _hint_lock_or_release(text: str) -> str:
blob = (text or "").replace(" ", "").replace(" ", "")
if any(x in blob for x in _RELEASE_HINTS):
kind = cabin_release_kind(text)
if kind == "direct":
return INTENT_RELEASE
if kind == "ask":
return INTENT_RELEASE_ASK
blob = _compact_cabin_text(text)
if any(x in blob for x in _LOCK_HINTS):
return INTENT_LOCK
return ""
@@ -191,7 +240,8 @@ def _classify_with_model(text: str, settings) -> str:
client = LlmHttpClient.from_settings(settings)
system = (
"你是空运协同群意图分类。只回复一个英文词,不要解释。"
"air_lock=航线要锁舱;air_release=航线要释放舱位;"
"air_lock=航线要锁舱;air_release=航线要取消舱位(取消舱位、放舱、解锁舱、取消锁舱);"
"说出释放舱位、释放舱、把舱位释放了时不要回 air_release;"
"air_activate=只是指定/切换工单号;"
"air_pick_option=在补充或选择舱位编号、航司、航班号,写法不限;"
"collab_fields=在补是否含电/是否含磁;"