一家跨境 SaaS 公司把客服助手接上 DeepSeek API。上海用户询问“明天还能续费吗”,洛杉矶用户询问“今天是否已经过期”。两个人面对同一个套餐,系统却需要先确定两个不同的问题:用户所在地区现在是哪一天,以及账户服务实际在哪个时刻截止。
这是一个假设的业务场景,没有对应某家公司的线上事故。它揭示的接入问题很具体:模型不知道应用想使用哪一个“今天”;知道今天的日期,也不等于知道订单是否过期。
对于通过 AI API 中转站接入 DeepSeek 的团队,解决方式是先由后端建立明确的时间上下文,再验证所选模型接口能否保留它。换一个模型名称、增加一句“请认真检查日期”,都不能代替这项工作。
这篇文章把一次客服接口设计拆成业务约定、请求装配和上线走查。目标是让工程师能回答一个可验收的问题:同一时刻、不同地区、跨越午夜的用户请求,是否仍然引用正确的日期和订单事实。
业务约定:把“现在”与“截止”分别交给正确的数据源
先写清楚三种时间,不要只在日志里保存一个日期字符串。
| 时间 | 推荐来源 | 负责回答的问题 |
|---|---|---|
| 请求收到的时刻 | 应用后端的带时区时间 | 这次提问发生在什么时候 |
| 用户所在地区的日期 | 已确认的用户时区与请求时刻换算 | 用户所说的“今天”是哪一天 |
| 订单或服务的截止时刻 | 订单系统、合同配置或业务规则 | 权限究竟何时结束 |
用户语言也需要独立保存。一个选择英文界面的上海用户,不应该因此被系统放到美国时区;一个使用中文的洛杉矶用户,也不应该自动得到北京时间。IP 定位可以作为待确认线索,但不宜覆盖账户中已经确认的时区。
例如,业务系统收到的时刻是 2026-11-18T00:30:00Z。同一时刻,上海已经是 11 月 18 日,洛杉矶仍是 11 月 17 日。后端如果直接把 UTC 日期写进所有用户的请求,洛杉矶用户的“今天”就可能提前一天。
这里需要的是确定性的时间换算。Python 的 datetime 文档区分了带时区与不带时区的时间对象;在这个流程里,应拒绝含义不清楚的无时区输入。不要让模型猜测一个裸的 2026-11-18 00:30 究竟属于哪个地区。
订单到期判断也应由业务代码完成。模型可以把“有效期截至当地时间 17:00”解释给用户,但实际是否允许续费、是否收取费用,仍由订单接口和规则引擎决定。这样,即使模型的自然语言表达发生变化,账户权限也不会随一句回答改变。
接口约定:latest_reminder 是 DeepSeek 的具体能力
DeepSeek 当前的 User Metadata Marker 文档提供了 latest_reminder 消息,用于向模型传入日期、星期、地区、平台和语言。它适用于 DeepSeek 的 Chat Completions 与 Messages 接口,放在对应的 user 消息前面;Responses 接口不接受这一角色。
本文使用的消息示意为:
{
"role": "latest_reminder",
"content": "2026-11-18,星期三,Shanghai,Web,中文"
}这个消息没有独立的时区标识字段,也没有订单截止时间字段。时区换算应在应用中完成;需要模型理解的具体时刻和业务事实,可以再通过业务上下文明确传入。
这也是选择 API 中转线路时必须问清楚的细节。“兼容 Chat Completions”不代表允许任意厂商扩展角色。某些客户端或中间适配器可能只接受固定的角色集合,在请求出站之前就把扩展消息拒绝或删掉。因此,应沿着“业务后端—SDK 或 HTTP 客户端—中转接口—DeepSeek”的路径检查消息。
如果团队正从 Harness 切换模型,可以先结合站内的 Agent Harness 接入其他模型指南确定所用协议。本文没有假定任何 Harness 版本已经提供这个字段的配置界面;下面的示例针对自己控制请求体的后端应用。
同样,DeepSeek 提供 Anthropic 格式的接口,并不意味着 Claude 原生接口也接受 latest_reminder。两者的差异应按 DeepSeek Anthropic API 兼容说明核对。切换到 Gemini 或 Claude 时,应为目标协议重新组织普通的时间上下文,不能把 DeepSeek 专有角色原样广播给所有模型。
实现记录:后端只生成一次时间快照
下面是一段离线 Python 示例,只验证日期换算与消息装配,不会发起模型请求。它把 UTC 时刻转换到用户确认的地区,再生成 DeepSeek 的时间提醒和供应用留存的快照。
示例只实现中文、英文两种语言,不代表官方只支持这两种语言。增加语言时,应补齐对应星期名称并核对官方支持值。平台和地区来自受控配置,不应直接拼接任意用户文本。
from datetime import datetime, timezone
from zoneinfo import ZoneInfo
WEEKDAYS = {
"中文": ("星期一", "星期二", "星期三", "星期四",
"星期五", "星期六", "星期日"),
"English": ("Monday", "Tuesday", "Wednesday", "Thursday",
"Friday", "Saturday", "Sunday"),
}
def time_context(at, zone, location, language, platform="Web"):
if at.tzinfo is None or at.utcoffset() is None:
raise ValueError("at must include a timezone")
if language not in WEEKDAYS or platform not in {"Web", "App"}:
raise ValueError("unsupported application configuration")
if not isinstance(location, str) or any(
ord(c) < 32 or ord(c) == 127 for c in location
):
raise ValueError("invalid location")
local = at.astimezone(ZoneInfo(zone))
marker = ",".join([
local.date().isoformat(),
WEEKDAYS[language][local.weekday()],
location, platform, language,
])
return {
"received_at_utc": at.astimezone(timezone.utc).isoformat(),
"timezone": zone,
"local_now": local.isoformat(),
"reminder": {"role": "latest_reminder", "content": marker},
}
at = datetime(2026, 11, 18, 0, 30, tzinfo=timezone.utc)
sh = time_context(at, "Asia/Shanghai", "Shanghai", "中文")
la = time_context(at, "America/Los_Angeles", "Los Angeles", "English")
assert sh["local_now"].startswith("2026-11-18T08:30")
assert la["local_now"].startswith("2026-11-17T16:30")
history = [{"role": "system", "content": "仅依据给定订单事实答复。"}]
messages = history + [
sh["reminder"],
{"role": "user", "content": "请解释我所在地区今天的日期。"},
]
assert messages[-2]["role"] == "latest_reminder"
assert messages[-1]["role"] == "user"
print(sh["reminder"]["content"])
print(la["reminder"]["content"])Python 的 zoneinfo使用 IANA 时区数据。部署环境需要可用的系统时区库,或者安装对应的 tzdata 依赖;不能在时区不存在时悄悄退回服务器本地时间。IANA 时区数据库会随地区规则变化更新,因此生产镜像里的时区数据也应纳入常规维护。
这段代码刻意没有使用固定的“洛杉矶等于 UTC 减八小时”规则。固定偏移无法表达一个地区全年可能发生的时间变化。对于预约、账期和跨国客服,地区时区名称比一条临时心算公式更适合作为持久配置。
生成好 messages 后,可按 DeepSeek Chat Completions 请求参考装配请求。官方直连示例使用 /chat/completions;通过中转站调用时,完整地址、鉴权方式和模型 ID 均应使用当前账号对应的文档,不能假定博客域名就是 API Base URL。
如果线路不接受扩展角色,有两个明确选择:选择已验证支持的接口,或把时间信息转成目标模型允许的普通上下文。后一种属于应用自己的替代实现,应重新测试模型理解效果,不应声称与原生标记具有完全相同的行为。
多轮约定:历史里的“昨天”不能被今天覆盖
客服对话可能跨越午夜,也可能中断数天后继续。此时不能简单地遍历全部历史消息,把每一轮之前的日期都替换成最新日期。
假设用户周一说“明天出差”,周三又问“之前说的安排还在吗”。如果系统把周一的提醒重写成周三,旧句子的时间依据就被改变了。正确做法是保留已经写入的历史时间快照,在新的用户轮次前追加本轮快照。
DeepSeek 的 多轮对话说明解释了 Chat Completions 的历史传递方式。应用应负责保存上下文;启用服务器工具等功能时,还需要遵循对应的历史回传规则。日期处理不能成为丢弃其他协议内容的理由。
长任务还有另一类时间:用户发问的时刻与后台真正执行任务的时刻。比如 23:59 提交、00:02 才运行的报告,产品需要明确“今天”按提交日还是执行日计算。这个约定由业务决定,不能交给模型在重试时随机改变。
建议为同一次逻辑用户轮次保存不变的提问时间,另行记录每次执行时间;如果确实需要刷新订单状态,应再次查询订单接口,并标明查询时刻。这样既能解释用户原话,也能提供当前可用的业务事实。
上线走查:用跨日样本验证,而不是只问一次日期
下面是一组建议验收场景,不是模型准确率测试结果。固定输入时刻,再分别检查装配的请求、模型回答和最终业务决策。
| 场景 | 应用必须先保证的条件 | 回答检查重点 |
|---|---|---|
| 同时刻的上海与洛杉矶用户 | 两个已确认的时区分别换算 | 不把两个地区的“今天”写成同一天 |
| 用户语言与地区不一致 | 语言和时区独立配置 | 输出语言正确,日期依据不被语言覆盖 |
| 对话跨越午夜 | 旧快照保留,新轮次追加 | 旧消息中的相对日期仍能解释 |
| 任务排队跨日 | 明确提交时间与执行时间的用途 | 不在无提示的情况下改写用户的时间基准 |
| 用户尚未确认时区 | 使用产品明确的默认规则或询问 | 不把推测地点描述成已确认事实 |
| 接口不支持扩展角色 | 在适配层发现并明确处理 | 不以 HTTP 成功代替字段透传验证 |
对业务开发者,最有价值的检查不是模型复述了多少个日期,而是用户能否得到明确、有依据的下一步。例如,“您的套餐将在洛杉矶时间 11 月 17 日 17:00 到期,当前仍可续费”,应该建立在订单系统返回的截止时刻和后端的比较结果上。
如果订单数据缺失,正确的结果应是请用户提供订单、调用获准的查询工具,或转人工。给模型补充 latest_reminder 并不会补出缺失的订单记录,也不会自动开启搜索。
时间上下文只需要必要的地区信息,不需要为了日期换算把客户详细住址传给模型。涉及不同部门与环境的接入,可结合站内多模型 API 权限隔离明确哪些业务可以访问哪些模型。记录时保留时区来源、快照时刻、模型标识和请求关联信息;具体日志结构可参考企业 API 调用日志验收。
接入决策:让一条真实客服流程证明接口是否适合
企业评估中转接口时,可以把本文的跨日样本作为一次小范围试用任务。先确认 DeepSeek 模型、协议和扩展角色支持,再运行脱敏样本,核对请求中的时间快照是否保留,回答是否使用了正确业务依据。
费用也按实际请求记录检查。如果测试中切换了协议、增加上下文或发生了重新调用,就应分别记录;不要把“只是补了一条日期”理解成所有计费条件必然不变。站内的 DeepSeek 接口账单核对指南提供了核对方法,具体价格仍以当前账号的线路报价为准。
准备开始时,可从 Treerouter 接入入口确认当前 DeepSeek 线路,随后注册并验证这一条客服流程。采购范围更大时,再结合大模型 API 中转站接入核查补全其他能力的确认。一次小试用应留下可复用的请求样本和验收结果,而不是只有一张聊天成功的截图。
常见问题
使用 DeepSeek API 时,必须传当前日期吗?
不必为每个任务添加。纯粹的代码解释、固定文档摘要可能不依赖当前日期;涉及今天、明天、当地日期的业务,应提供明确的时间依据,并验证模型如何使用它。
切换到 Responses API 后,能保留同一个特殊角色吗?
不能直接照搬。该标记当前不适用于 Responses。切换前应核对 DeepSeek Responses API 文档,重新定义时间上下文的输入方式,并为目标协议运行同一组业务样本。
模型知道当前日期,就能判断套餐是否到期吗?
还需要实际截止时间、业务规则和确定性的比较结果。日期上下文帮助模型解释问题;账户授权、扣费和续费操作应由业务系统决定。
官方参考资料
- DeepSeek User Metadata Marker:标记的格式与适用接口。
- DeepSeek Chat Completions API:请求消息与接口结构。
- DeepSeek Anthropic API 兼容说明:兼容格式与厂商接口的边界。
- DeepSeek 多轮对话:历史上下文传递。
- DeepSeek Responses API:另一种协议的独立请求约定。
- Python zoneinfo:地区时区换算与数据依赖。
- Python datetime:带时区时间对象。
- IANA Time Zone Database:时区规则的维护来源。






