应启用阿里云百炼国内高速通道：一、确保api key地域与hermes agent配置地域一致；二、ecs/计算巢场景使用内网endpoint；三、轻量服务器/无影云电脑配置百炼专属dns；四、cli或脚本调用时显式指定region参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功部署 Hermes Agent，但调用阿里云百炼模型时响应缓慢或出现超时，则可能是由于未启用国内高速通道导致请求绕行境外节点。以下是配置阿里云百炼国内高速通道的具体步骤：
一、确认百炼服务地域与API Key匹配
百炼 API 请求性能高度依赖地域一致性。若 API Key 在北京地域申请，而 Hermes Agent 实例部署在杭州，且未显式指定地域，系统可能默认走公网路由，造成延迟升高。必须确保百炼 API Key 所属地域与 Hermes Agent 配置中指定的地域完全一致。
1、登录阿里云百炼控制台，进入「API密钥管理」页面。
2、查看当前 API Key 的「所属地域」字段，记录该值（例如：cn-beijing 或 cn-hangzhou）。
3、在 Hermes Agent 部署环境（如轻量应用服务器控制台或计算巢实例）中，进入「应用详情页签」→「初始化配置百炼API Key」界面。
4、在「百炼地域」下拉菜单中，手动选择与API Key所属地域完全相同的选项，不可依赖默认值。
二、使用百炼专属内网Endpoint（ECS/计算巢场景）
当 Hermes Agent 运行于阿里云 ECS 或计算巢实例时，若实例与百炼服务处于同一地域且同属阿里云内网，可直接使用百炼内网 Endpoint，彻底规避公网传输与 DNS 解析开销，显著降低首字节时间（TTFB）。
1、在百炼控制台对应地域的服务概览页，点击「接入点信息」展开区域。
2、复制「内网Endpoint」地址（格式为：https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation，域名含 aliyuncs.com 而非 alibabacloud.com）。
3、进入 Hermes Agent 配置目录，定位到模型配置文件（通常为 config.yaml 或 hermes.toml）。
4、将 base_url 字段值替换为上一步复制的内网Endpoint地址。
5、保存文件后，重启 Hermes Agent 服务：sudo systemctl restart hermes。
三、启用百炼专属DNS解析（轻量应用服务器/无影云电脑）
轻量应用服务器与无影云电脑默认使用公共 DNS（如 114.114.114.114），可能导致百炼域名解析至非最优 IP。通过强制指定阿里云百炼 DNS 解析服务器，可确保返回低延迟、高可用的国内 CDN 节点 IP。
1、以 root 权限编辑系统 DNS 配置文件：sudo nano /etc/resolv.conf。
2、在文件顶部插入一行：nameserver 100.100.2.136（阿里云百炼官方推荐 DNS）。
3、保存并退出，执行 sudo systemctl restart systemd-resolved 刷新解析缓存。
4、验证生效：运行 nslookup dashscope.aliyuncs.com，确认返回 IP 地址归属中国大陆 IDC（如 106.11.248.* 或 118.31.179.*）。
5、重新触发一次 Hermes Agent 的百炼调用，观察日志中请求耗时是否明显下降。
四、配置百炼 SDK 的 Region 参数（CLI/自定义脚本方式）
若通过命令行或自定义 Python 脚本调用百炼 API，SDK 默认行为可能忽略地域上下文。显式传入 Region 参数可强制 SDK 使用该地域的最优接入点，避免自动探测带来的不确定性延迟。
1、在调用百炼 SDK 的代码中，查找初始化 client 的位置（如 DashScopeClient() 或 Generation() 类实例化处）。
2、为初始化参数添加 region_name 字段，值设为与 API Key 一致的地域标识（例如："cn-beijing"）。
3、若使用 CLI 工具，检查其配置命令是否支持 --region 选项；若有，执行时显式指定：hermes run --model bailian --region cn-hangzhou。
4、执行调用前，确认当前 shell 环境变量中未设置冲突的 DASHSCOPE_REGION 或 ALIBABA_CLOUD_REGION_ID，否则优先级高于代码参数。
