> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/question-contact/questions.md).

# 常见问题

## 模型与连接

<details>

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

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

</details>

<details>

<summary>为什么列表里没有想用的模型？</summary>

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

</details>

<details>

<summary>Agent 提示必须启用 API 网关怎么办？</summary>

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

</details>

## Agent 与工具

<details>

<summary>Agent 为什么看不到本地文件？</summary>

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

</details>

<details>

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

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

</details>

<details>

<summary>已经安装技能，为什么 Agent 不使用？</summary>

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

</details>

<details>

<summary>怎样让 Agent 生成图片？</summary>

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

</details>

## MCP 与自动化

<details>

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

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

</details>

<details>

<summary>频道显示已连接但不回复怎么办？</summary>

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

</details>

<details>

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

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

</details>

## 数据与窗口

<details>

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

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

</details>

<details>

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

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

</details>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/question-contact/questions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.