接口地址、API Key、模型名都填了，WorkBuddy 却一直转圈，或者发出去的消息没有回复。遇到这种情况，先别把所有配置都改一遍。

“不回复”只是表面现象。请求可能根本没发到服务端，也可能被鉴权、模型权限、额度或限流拦住；还有一种情况是普通聊天正常，但工具调用或流式返回不兼容。

本文从客户端选择、请求地址、鉴权、模型权限、错误响应和工具兼容性几个环节整理排查方法。地址示例使用蓝博API（Lanbuff）的 OpenAI 兼容接口，其他服务请替换为各自文档中的地址。本文为排查指南，未在本次编写中进行实机调用测试。


## 一、先做一个最小测试

新建对话，手动选中刚添加的自定义模型，然后只发送一句：


> 请只回复“连接成功”，不要读取文件或调用工具。

先用短文本，暂时不加图片、附件、长历史和工具任务。如果短对话正常，而读取文件或执行任务失败，接下来应重点检查工具兼容性。

不要同时改地址、模型和密钥。每次只改一项，才能知道是哪一步起了作用。


## 二、保存配置，不代表当前对话选中了它

先检查对话页显示的模型。是否仍然使用默认模型？是否开启了自动选择？是否选中了另一个同名配置？

测试时明确指定目标自定义模型，必要时重新开一个对话。不要只问“你是什么模型”来判断配置是否生效，模型自我介绍不能代替使用日志。


## 三、先看服务端有没有收到请求

记下发送时间，到 API 平台的使用日志中查看对应请求。蓝博用户可以在控制台查看使用记录。

有对应记录：说明请求至少到达了日志记录的环节。继续查看模型、状态、错误信息和消耗；这不等于整个对话已经成功完成。

没有对应记录：先核对账户、日志时间范围和令牌，再检查客户端是否选中目标配置、接口地址和网络连接。有些失败发生在用量记录之前，所以没有记录也不能直接认定是客户端的问题。

如果一直转圈，先停止重复提交，保留错误信息。连续点击或自动重试可能产生更多请求。


## 四、检查接口地址：Base URL 和完整请求地址不要混用

蓝博正确的 Base URL 是：


```text
https://lanbuff.app/v1
```
OpenAI 兼容 Chat Completions 的完整请求地址是：


```text
https://lanbuff.app/v1/chat/completions
```
如果客户端会自动补全 /chat/completions，就填写 Base URL；如果当前配置明确要求完整请求地址，则按该字段说明填写。不要出现 /v1/v1 或重复的 /chat/completions。

选择与服务端相匹配的协议。Claude 模型名并不意味着所有渠道都能使用同一种请求格式。这里采用的是支持 OpenAI 兼容 Chat Completions 的渠道，不能直接把其他协议的配置照搬过来。

WorkBuddy 不同版本的设置项可能变化，具体请核对当前字段提示及官方模型配置说明。


## 五、检查密钥、模型 ID 和额度

密钥：填写 API 平台创建的令牌，不是网页登录密码。检查是否复制完整、是否启用、是否过期，以及是否设置了调用限制。

模型：复制当前模型列表里的完整 ID。配置的显示名称可以自己起，但请求里的模型标识不能随意填写。还要检查令牌所属分组是否允许调用这个模型。

额度：账户余额与令牌额度都要看。账户有余额，不代表某个令牌没有达到它自己的限制。

不要为了排查直接大额充值。先根据具体错误信息确认是否确实属于额度问题。


## 六、看到错误码，按错误信息继续定位

401：优先检查鉴权、令牌是否有效及填写位置。

403：检查模型或分组权限、访问限制。以响应中的具体信息为准。

404：检查路径和模型 ID。既可能是请求地址不正确，也可能是模型没有开放。

400：检查请求参数和协议是否匹配，是否使用了渠道不支持的功能或参数。

429：检查限流、并发或额度相关提示。不要立刻连续重试，先按照服务端提示调整。

5xx、超时或连接中断：可能涉及上游服务、网关或网络。记录请求时间和错误内容，再用短对话对照测试。

这些是排查方向，不是只凭状态码就能确定的结论。不同平台的错误定义可能不同，响应里的错误内容更关键。


## 七、能聊天，却执行不了任务怎么办

普通文本对话成功，只能说明基础调用可用。WorkBuddy 的文件操作、代码修改等任务，还涉及工具调用、上下文和多轮请求。

先确认目标渠道支持所需工具调用，再检查客户端设置和具体报错。若请求返回成功，但界面没有显示内容，应继续核对返回格式与流式输出兼容性；如果当前版本提供流式设置，可用非流式请求进行对照。

没有这个设置时，不要随意增加未知参数。可以先用平台提供的基础调用示例确认服务端是否能正常返回，再把问题缩小到客户端与渠道的兼容性。


## 八、求助时提供这些信息，比只说“不回复”有效

建议整理：WorkBuddy 版本、所选模型 ID、使用协议、接口地址（不含密钥）、发生时间、错误码和错误信息，以及短文本测试与工具任务是否分别成功。

有请求 ID 就一并提供。截图前遮住完整 API Key、个人资料和任务里的私密内容。不要把完整密钥发到评论区。


## 排查顺序速查

新对话与短文本 → 明确选择自定义模型 → 检查服务端记录 → 核对协议与地址 → 检查令牌和模型权限 → 阅读错误响应 → 对照工具和流式兼容性。

每次测试记录修改项和结果；不要把连续重试当作排查方法。基础请求与客户端表现分别验证，才能缩小问题范围。


## 参考资料

WorkBuddy 官方模型配置说明：
https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model

本文由 AI 辅助整理，未进行实机调用测试。具体能力及设置以当前客户端和服务端文档为准。

接口地址、API Key、模型名都填了，WorkBuddy 却一直转圈，或者发出去的消息没有回复。遇到这种情况，先别把所有配置都改一遍。

WorkBuddy 接入自定义模型后不回复：API 调用排查指南

WorkBuddy 自定义模型配置后不回复，可从模型选择、请求日志、接口地址、鉴权、模型权限及工具兼容性逐项排查。本文整理最小测试、常见状态码和求助信息清单。

开发工具

客户端

后端

接口配置正确但WorkBuddy无响应时，先做短文本最小测试并明确选中自定义模型。检查服务端日志确认请求是否送达，核对BaseURL与完整地址勿混用，验证密钥权限、模型ID及额度。依据401、403、429等错误码定位问题，注意工具调用和流式兼容性。排查时每次只改一项，提供版本、时间、错误信息等关键数据。

代码解释

WorkBuddy 

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

WorkBuddy 接入自定义模型后不回复：API 调用排查指南-腾讯云开发者社区-腾讯云

WorkBuddy 接入自定义模型后不回复：API 调用排查指南

WorkBuddy 接入自定义模型后不回复：API 调用排查指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐