需手动配置deepseek为openai兼容模型：更新requests≥2.31.0，编辑models.yaml添加deepseek_openai提供者，设default_model为其，扩展context_window_size至128000并注入系统提示，最后通过cli多轮测试验证上下文保持。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Hermes Agent中接入DeepSeek模型以获得高性价比的推理能力与强上下文理解支持，则需绕过默认模型路由限制，手动配置兼容OpenAI规范的API端点与会话参数。以下是完成该集成的具体操作路径：
一、确认Hermes运行环境与依赖兼容性
Hermes Agent基于Python构建，不直接加载本地模型，而是通过HTTP调用外部大模型API；因此必须确保其底层HTTP客户端能正确处理DeepSeek的OpenAI兼容接口，包括请求头格式、流式响应解析及超时控制。同时需验证requests库版本是否满足DeepSeek-V3 API对HTTP/1.1连接复用与JSON Schema校验的要求。
1、打开终端，执行python -m pip show requests，确认输出中Version ≥ 2.31.0。
2、若版本过低，运行python -m pip install --upgrade requests>=2.31.0进行更新。
3、检查Hermes安装目录下config/models.yaml是否存在可编辑权限，如为只读需先执行chmod u+w config/models.yaml（Linux/macOS）或属性修改（Windows+WSL2）。
二、配置DeepSeek为自定义OpenAI兼容模型
Hermes支持通过YAML声明式方式注册任意符合OpenAI API规范的第三方模型服务；DeepSeek-V3已明确声明完全兼容/v1/chat/completions等标准路径，只需将endpoint、api_key与model_id映射写入模型配置表，即可被Hermes技能调度器识别并路由。
1、使用文本编辑器打开config/models.yaml文件。
2、在providers区块末尾新增如下内容：
```yaml
deepseek_openai:
type: openai
api_base: https://api.deepseek.com/v1
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: deepseek-chat
temperature: 0.7
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
max_tokens: 4096
```
3、保存文件后，在config/profiles/default.yaml中将default_model字段值改为deepseek_openai。
三、设置长上下文会话参数与系统提示注入
Hermes默认会话上下文窗口较窄，而DeepSeek-V3支持最高128K tokens输入；需显式启用会话级上下文扩展机制，并在每次请求中注入结构化系统角色指令，以激活其深度推理与多步任务拆解能力。
1、进入config/skills/core.yaml，定位到chat技能定义段。
2、在parameters下添加context_window_size: 128000字段。
3、在同文件中找到system_prompt项，将其值替换为：
你是一个具备复杂逻辑链推演能力的AI助手，当前运行于DeepSeek-V3模型上。请严格遵循用户指令，保持上下文连贯性，对多步骤请求主动分阶段响应，并在必要时请求补充信息。
4、保存后重启Hermes服务进程。
四、验证API连通性与上下文保持能力
集成完成后需通过真实请求验证两点：一是Hermes能否成功发起认证请求并接收响应；二是连续多轮对话中历史消息是否被正确拼接进messages数组，从而触发DeepSeek-V3的长程上下文建模机制。
1、启动Hermes CLI模式：hermes shell。
2、输入测试指令：/debug http trace on开启HTTP调试日志。
3、发送首轮提问：请总结以下三句话的核心观点：①AI代理需具备自主记忆沉淀能力；②上下文长度直接影响多步任务完成率；③模型API兼容性决定集成成本。
4、立即追加第二轮指令：基于刚才的总结，列出三项落地建议。
5、检查终端输出中messages字段是否包含全部六条role-content对，且总token数超过8000。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
