一家跨境 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 文档,重新定义时间上下文的输入方式,并为目标协议运行同一组业务样本。

模型知道当前日期,就能判断套餐是否到期吗?

还需要实际截止时间、业务规则和确定性的比较结果。日期上下文帮助模型解释问题;账户授权、扣费和续费操作应由业务系统决定。

官方参考资料

  1. DeepSeek User Metadata Marker:标记的格式与适用接口。
  2. DeepSeek Chat Completions API:请求消息与接口结构。
  3. DeepSeek Anthropic API 兼容说明:兼容格式与厂商接口的边界。
  4. DeepSeek 多轮对话:历史上下文传递。
  5. DeepSeek Responses API:另一种协议的独立请求约定。
  6. Python zoneinfo:地区时区换算与数据依赖。
  7. Python datetime:带时区时间对象。
  8. IANA Time Zone Database:时区规则的维护来源。