把 DeepSeek 等大模型接到运维 Agent，需要解决密钥、路由、配额与调用可观测。本文给出 OpenOcta 接入 DeepSeek-V4 的步骤要点，便于工程师按同一路径复现。

本教程面向新手，每一步都附带说明，跟着操作即可配置成功。

** 适用版本 ** ：DeepSeek-V4（2026-04-24 正式发布）

---

接入 DeepSeek-V4 只需要三步：

1. ** 拿 Key ** ：去 DeepSeek 开放平台 创建 API Key
2. ** 配置 ** ：在 模型 的 DeepSeek 里配置 DEEPSEEK_API_KEY ，在 agents 里指定模型为 deepseek/deepseek-v4-pro
3. ** 验证 ** ：启动 OpenOcta 发一条消息测试

一、前置说明：DeepSeek-V4 模型版本

DeepSeek 官方 API 目前提供 V4 系列模型，旧版模型名即将弃用：

模型 ID	对应版本	特点	上下文长度
deepseek-v4-pro	DeepSeek-V4-Pro	性能最强，Agent 能力、推理能力、世界知识全面领先，适合复杂任务	1M
deepseek-v4-flash	DeepSeek-V4-Flash	经济快速版，推理能力接近 Pro，适合日常对话和简单任务	1M
deepseek-chat	** 兼容旧名 **	将于 ** 2026-07-24 ** 弃用，当前指向 deepseek-v4-flash ** 非思考模式 **	1M
deepseek-reasoner	** 兼容旧名 **	将于 ** 2026-07-24 ** 弃用，当前指向 deepseek-v4-flash ** 思考模式 **	1M

**
**

** 建议 ** ：新接入请直接使用 deepseek-v4-pro 或 deepseek-v4-flash ，旧模型名将在三个月后停止服务。

---

二、获取 DeepSeek API Key

1. 打开 DeepSeek 开放平台
2. 登录账号（没有就注册一个，新注册账户需要实名）
3. 进入左侧菜单「API Keys」
4. 点击「创建 API Key」，给它起个名字（如 openocta ）
5. ** 立即复制生成的 Key ** （格式类似 sk-xxxxxxxxxxxxxxxx ），它只会显示一次

保存好这个 Key，下一步会用到。

---

三、配置 OpenOcta json 文件

1、选择deepseek模型

2、填入配置

输入API Key

3、添加模型

输入对应版本模型ID

4、设为默认模型，并选择对应模型

5、json 配置（可选）

OpenOcta 的配置文件路径如下：

• ** Windows ** : C:\Users\你的用户名\.openocta\openocta.json
• ** macOS/Linux ** : ~/.openocta/openocta.json

---

四、进阶配置：自定义模型参数与思考强度

如果你需要显式声明模型参数（如上下文长度、思考强度、Base URL 等），请在 模型-DeepSeek 中配置：

---

五、验证配置是否成功

方法一：启动后看日志

1. 在 OpenOcta 的 Web UI 中打开任意对话，选择对应模型
2. 发送一条消息，如 “你好”
3. 如果能正常收到 DeepSeek 的回复，说明配置成功

方法二：通过命令行快速验证（适合开发者）

如果你本地有 curl

，可以直接测试 DeepSeek API 是否通：

curl https://api.deepseek.com/chat/completions \  
  -H "Content-Type: application/json" \  
  -H "Authorization: Bearer sk-你的Key" \  
  -d '{  
    "model": "deepseek-v4-pro",  
    "messages": [{"role": "user", "content": "你好"}]  
  }'

能返回 JSON 且包含 choices 字段，说明 Key 和模型都有效。

---

六、完整参考：模型引用速查表

你想用的模型	配置写法
DeepSeek-V4-Pro（最强性能）	deepseek-v4-pro
DeepSeek-V4-Flash（经济快速）	deepseek-v4-flash
旧版兼容（2026-07-24 前可用）	deepseek-chat
旧版推理（2026-07-24 前可用）	deepseek-reasoner
通过 OpenRouter 接入	openrouter/deepseek-v4-pro
** deepseek-V3 **	deepseek-v3
** DeepSeek-R1 **	deepseek-r1
deepseek-v2.5	deepseek-v2.5

预览时标签不可点

常见问题

什么是本文讨论的核心问题？

核心围绕「OpenOcta接入DeepSeekV4教程」。开篇摘要给出直接结论，正文展开步骤、对比或案例，便于检索与 AI 引用。

按本文操作要注意什么？

先确认运行环境与版本依赖，保留回滚路径；涉及密钥与微信等通道时，注意最小权限与生产隔离。

OpenOcta 适合什么团队？

适合需要把告警、可观测与运维操作接到 Agent 工作流的 SRE / 平台 / 运维团队，尤其关注开源可部署与企业治理的组织。

如何开始试用？

访问 https://openocta.com 了解社区版与企业版差异，按文档完成安装；需要企业能力可查看定价页或联系原厂支持。

<div