常见问题

模型与连接

模型服务已经填写 API Key，为什么仍无法对话？

打开【设置】→【模型服务】，确认服务商已启用、API 地址正确，并使用连接检查。再确认【设置】→【默认模型】选择的是该服务商下实际可用的模型。企业代理或防火墙环境还要检查网络代理。

为什么列表里没有想用的模型？

先在模型服务中同步或手动添加模型，再检查模型类型和接口是否匹配。不同页面会按能力筛选模型，例如 Agent、绘画和嵌入模型不会使用完全相同的列表。

Agent 提示必须启用 API 网关怎么办？

点击提示中的【启用并启动】，或打开【设置】→【API 网关】手动启动。状态仍不正常时，检查端口是否被占用以及本机安全软件是否拦截。

Agent 与工具

Agent 为什么看不到本地文件？

确认当前任务选择了正确工作目录，并且目录仍可访问。知识库绑定不能代替工作目录；知识库用于检索已处理资料，工作目录用于直接读写文件。

Agent 一直在等待，没有继续运行怎么办？

打开右侧【状态】，查看是否有待处理的权限请求、后台命令、子任务或服务商重试。需要更深信息时开启开发者模式并复现一次，再查看调用链。

已经安装技能，为什么 Agent 不使用？

打开 Agent 编辑窗口→【技能】确认已启用，然后新发一条消息。安装和绑定是两个步骤。

怎样让 Agent 生成图片？

先在【设置】→【默认模型】→【绘画模型】选择可用模型，再到 Agent 编辑窗口→【内置工具】确认【生成图片】已启用。回到【工作】直接描述图片即可。

MCP 与自动化

MCP 服务器已启动，Agent 仍找不到工具怎么办？

确认服务器详情中能看到工具，再检查 Agent【MCP】是否绑定。配置改变从下一条消息生效；工具关闭或权限未批准也会阻止调用。

频道显示已连接但不回复怎么办？

检查绑定 Agent、工作区、允许的会话 ID 和频道权限模式，再查看频道日志。飞书、微信等平台还要确认机器人权限或扫码登录状态。

定时任务运行了，为什么没有收到消息？

先在【运行历史】判断 Agent 是否成功。如果成功但未送达，检查频道是否有可用接收目标；通常需要先在平台端主动给机器人发送一条消息。

数据与窗口

删除 Cherry Studio 中的工作目录会删除磁盘文件吗？

从 Agent 任务列表删除工作目录记录不会删除磁盘目录，但会移除该目录下的任务记录。Agent 执行中的文件操作仍可能修改真实文件，因此要检查权限模式。

怎样把对话或 Agent 任务放到单独窗口？

右键话题、任务或顶部标签页，选择【从新窗口打开】。独立窗口可以【窗口置顶】，也能点击【回到主窗口】重新接回。

没有找到对应问题时，打开【设置】→【关于我们】→【反馈】，优先选择【使用 Agent 提交】。Cherry Assistant 会帮助检查当前状态、整理可复现信息并在提交前给你确认。