前言最近在Trae Work中接入agnes‑2.5‑flash模型遇到一个非常迷惑的现象API连通性测试显示完全正常但是真正发起对话时要么一直转圈要么返回空白内容没有任何输出。一开始怀疑是密钥、网络、接口地址问题反复核对连通测试全部通过折腾很久才定位到根本原因Trae Work自定义模型的高级参数会在真实对话时携带额外字段而连通测试并不会加载这些高级配置所以造成“测试通实际不能用”的假象。关键点连通测试 ≠ 真实业务请求连通测试只校验key、网络、基础鉴权不会携带工具调用、思考模式等高级参数。环境信息IDETrae Work模型agnes‑2.5‑flash接口协议OpenAI Chat Completions 兼容格式第一步基础模型配置打开 Trae Work → 设置 → 模型 → 添加自定义模型配置项填写内容注意事项API格式OpenAI Chat Completions固定选择BaseURLhttps://apihub.agnes-shturl.cc末尾不要加斜杠不要手动拼接/v1/chat/completions关闭完整URL开关模型IDagnes-2.5-flash全部小写大小写错误会调用失败API Key你的sk‑agnes‑xxxx核对密钥额度是否充足⚠️坑点不要开启「完整URL」开关如果开启需要填写完整接口地址https://apihub.agnes-shturl.cc/chat/completions绝大多数情况建议关闭完整URL只填BaseURL。第二步高级配置核心导致无法对话的关键点开高级配置按照下表填写对照截图修改配置项配置值说明模型系列默认保持默认即可上下文窗口-输入131072agnes‑2.5‑flash最大输入上下文上下文窗口‑输出8192模型最大输出token上限工具调用轮数0填0代表关闭工具调用原500必须改掉该模型对tools函数调用schema兼容性差携带tools参数会直接空白/无输出连通测试不走工具调用逻辑所以显示正常支持图片输入支持模型原生支持多模态识图能力思考模式关闭禁止跟随模型默认配置agnes‑2.5‑flash没有深度思考能力开启思考模式会注入额外参数造成输出异常Temperature0.7代码场景推荐0.6‑0.7留空也可以Top P0.9可留空Top K留空OpenAI兼容接口一般不使用该参数填写完成点击保存模型。重要提醒保存之后不要再依赖连通测试按钮做验证连通测试不会加载高级配置。直接切到对话窗口顶部下拉选中该模型直接发消息测试。第三步排错定位手段方式1curl命令验证接口本身可用性先隔离问题判断是API服务问题还是Trae Work配置问题替换为自己的key执行curl https://apihub.agnes-shturl.cc/chat/completions \ -H Authorization: Bearer sk‑agnes‑你的APIKEY \ -H Content-Type: application/json \ -d { model:agnes-2.5-flash, messages:[{role:user,content:你好简单介绍自己}] }curl可以正常返回回答说明API服务本身没问题问题100%出在Trae Work配置curl报错检查密钥、余额、网络、接口地址和Trae无关。方式2代理排查Trae Work全局代理会干扰第三方API调用。 设置 → 通用 → Editor设置搜索proxy清空代理配置重启Trae Work。已知限制说明agnes‑2.5‑flash工具调用能力有限关闭工具调用轮数0后只适合问答、代码生成、阅读文件不能使用Trae Agent自动修改文件、执行命令等智能体能力区分国内和国际接口地址key和接口地址必须一一对应账号密钥不互通模型ID大小写敏感必须严格小写agnes‑2.5‑flash。总结现象连通测试✅对话❌转圈/空白 根因Trae真实对话会携带tools工具调用参数、思考模式参数而agnes‑2.5‑flash无法兼容连通测试不会携带这些参数造成鉴权成功假象。 解决方案工具调用轮数设置为0思考模式关闭正确填写上下文窗口参数保存后直接对话测试。