logo

DeepSeek扩展能力接入前,先核验这几件事

作者:rousong2026.11.17 03:21浏览量:0

简介:DeepSeek扩展能力涉及搜索、链接阅读、文件输入等功能,但接口名、参数与价格需要逐项对照官方文档。本文给出核验顺序、成本公式的变量写法、外部内容的安全规则和上线前检查清单,帮助团队在动手前排除信息偏差,避免按未确认的能力做选型和预算。

一、先核验能力是否已开放

很多团队看到”联网搜索””文件输入””语音交互”之类的功能名称,就直接开始设计方案。这一步容易出错。功能名称来自宣传材料或原始资料,并不等于官方 API 已经提供对应参数。

因此,接入前应先在 DeepSeek 官方开放平台的文档中找到每项能力的说明,确认三件事:该能力是否通过 API 提供,调用时使用哪个接口和哪些参数,以及计费规则是什么。只有三项都有明确出处,才能写入技术方案。

本文也以此为前提。文中不断言任何能力已经开放,所有名称、字段和价格都标注为”待核验”。

二、能力清单与核验状态

下表列出可能用到的能力。”当前状态”一列统一为待核验,团队应在每项后面补上文档链接、查询日期和适用模型。

能力 需要核验的内容 当前状态
联网搜索 是否支持 API 调用,搜索计费规则 待核验
深度思考搜索 是否支持,多步调用的延迟与费用 待核验
文件输入 支持的格式、文件大小上限、数据留存规则 待核验
阅读链接 是否支持,抓取失败时的返回形式 待核验
安全校验 开启条件,拒答标识的返回字段 待核验
语音能力 文字识别、语音识别、语音合成的计费单位和时长限制 待核验

核验结果应记录在内部表格中,包括文档地址、查询日期和模型版本。文档会更新,只有带日期的记录才便于后续复查。

三、接口选择的核验步骤

常见的接口形式有 Chat Completions、Responses 和 Messages,但 DeepSeek 对每种形式的支持范围需要以官方文档为准。团队不应凭经验假定某个接口支持某项工具调用。

建议按以下顺序判断:

  1. 确认团队现有代码使用的接口形式,以及官方是否支持该形式。
  2. 确认目标能力在该接口下是否可用,包括工具调用、流式输出和会话状态。
  3. 如果所需能力只在某一接口下提供,优先采用该接口,并评估迁移成本。
  4. 第三方工具可用于快速验证,但功能完整性需以工具自身文档和实际测试为准。

四、调用流程与伪代码

下面的伪代码只说明调用流程。字段名和取值都是占位符,不能直接用于生产环境。

  1. 请求 = {
  2. 模型: <官方文档中的模型名>,
  3. 消息: [{角色: "user", 内容: 用户输入}],
  4. 工具: <按官方文档构造的工具配置>,
  5. 安全校验: <按官方文档设置>
  6. }
  7. 结果 = 调用接口(请求)
  8. 如果 结果超时 或 工具调用失败:
  9. 返回 降级提示
  10. 否则:
  11. 展示 回答 和 引用来源

工具配置通常是对象列表,每个对象包含类型和参数。具体结构、必填项和取值范围,以官方文档为准。

编排工具调用前,应先定义以下规则:

  1. 哪些问题允许联网搜索。
  2. 哪些问题只基于用户上传的文件回答。
  3. 哪些链接允许抓取。
  4. 哪些场景必须开启安全校验。

失败时的提示语可以参考:

  • 搜索超时:实时信息暂时无法获取,以下内容基于已有知识,仅供参考。
  • 网页抓取失败:该链接暂时无法读取,请粘贴正文或稍后重试。
  • 文件解析失败:文件格式或大小不符合要求,请调整后重新上传。

前端通常需要支持流式输出、引用来源展示、文件上传状态提示、链接卡片、语音输入与转写展示,以及风险拒答提示。

五、成本估算的变量写法

调用扩展能力时,总费用由 Token 费用和各项工具费用组成。单价以官方计费页面为准,本文只给出公式结构,不写具体数值。

总成本 = Token 费用 + Σ(用量 × 单价)

各项用量和单价的对应关系如下:

变量 含义 单位 单价来源
搜索次数 每日搜索调用量 次 官方计费页面
抓取次数 每日网页抓取量 次 官方计费页面
识别页数 每日文字识别页数 页 官方计费页面
语音识别时长 每日语音识别时长 按官方计费单位 官方计费页面
合成字符数 每日语音合成字符数 按官方计费单位 官方计费页面

官方单价的计价单位可能是”每次””每千次””每页””每万字符”等。代入前,需要先把用量换算成同一计价单位。例如单价按每千次给出,就要先将次数除以 1000,再乘以单价。换算错误是预算偏差的常见来源,建议在成本表中单独记录换算系数。

假设某应用每天的用量为:搜索次数 A 次,抓取次数 B 次,识别页数 C 页,语音识别时长 D,语音合成字符数 E。把官方单价按计价单位换算后代入上式,即可得到日成本。这个估算只覆盖已知用量。实际费用还要加上重试、失败请求和峰值流量的余量。

控制成本可从以下方面入手:

  • 对高频问题建立缓存或摘要索引。
  • 限制单轮对话的最大搜索次数。
  • 长文档先分段,再摘要,最后做问答。
  • 语音场景使用简短指令,减少识别时长。
  • 按任务复杂度选择模型和参数。

上线前,应按应用、用户和场景拆分日志,记录搜索次数、抓取次数、文件页数、语音时长和合成字符数。只有这样,才能发现哪一项功能消耗超出预算。

六、外部内容的安全规则

联网搜索、文件输入和链接阅读都会把外部内容带入模型上下文。这些内容可能包含提示注入指令,例如要求模型忽略系统指令或泄露内部数据。

处理时应遵守以下规则:

  • 把外部内容当作数据,而不是指令。在提示词中用明确的分隔符包裹外部内容,并声明其仅供参考。
  • 不依赖单一过滤手段。关键词过滤无法覆盖全部注入方式,应同时限制权限,让模型无法直接触发敏感操作。
  • 外链抓取使用域名白名单,只允许访问列表中的域名。
  • 服务端解析域名后,检查目标地址是否属于内网或本机地址段,例如 127.0.0.0/8、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16 和 169.254.0.0/16。命中则拒绝访问。
  • 限制重定向次数,并对每次跳转后的地址重新执行上述检查。

上传文件前,应脱敏身份证号、手机号和银行卡号等敏感信息,并明确数据留存期限。日志应按合规要求设定保留期限,不记录原始敏感内容。回答中展示引用来源,便于用户核验。

七、合规提示

对外提供服务时,应开启安全校验。内容安全审核、算法备案、生成内容标识等义务,需要按服务所在地的法规履

发表评论

活动