> 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/docs/en-us/question-contact/questions.md).
# Frequently Asked Questions
### Models and Connections
The API Key has already been entered in Model Services, so why can’t I chat yet?
Open \[Settings] → \[Model Services], confirm the provider is enabled, the API address is correct, and use the connection check. Then confirm \[Settings] → \[Default Model] is set to an actually available model under that provider. In enterprise proxy or firewall environments, also check the network proxy.
Why isn’t the model I want in the list?
First sync or manually add the model in Model Services, then check whether the model type and interface match. Different pages will filter models by capability; for example, Agent, drawing, and embedding models will not use exactly the same list.
What should I do when Agent says the API Gateway must be enabled?
Click \[Enable and Start] in the prompt, or open \[Settings] → \[API Gateway] to start it manually. If the status is still abnormal, check whether the port is occupied and whether local security software is blocking it.
### Agent and Tools
Why can’t Agent see local files?
Confirm the current task has selected the correct working directory, and that the directory is still accessible. Knowledge base binding cannot replace the working directory; the knowledge base is used to retrieve processed materials, while the working directory is used to read and write files directly.
Agent keeps waiting and doesn’t continue running—what should I do?
Open the \[Status] on the right to see whether there are pending permission requests, background commands, subtasks, or provider retries. If you need deeper information, enable developer mode and reproduce it once, then check the call chain.
I already installed the skill, so why isn’t Agent using it?
Open Agent edit window → \[Skills] to confirm it’s enabled, then send a new message. Installation and binding are two separate steps.
How do I get Agent to generate images?
First in \[Settings] → \[Default Model] → \[Drawing Model], choose an available model, then in Agent edit window → \[Built-in Tools], confirm \[Generate Image] is enabled. Return to \[Work] and simply describe the image.
### MCP and Automation
The MCP server has started, but Agent still can’t find the tools—what should I do?
Confirm you can see the tools in the server details, then check whether Agent \[MCP] is bound. Configuration changes take effect from the next message; tools being turned off or permissions not approved will also prevent invocation.
What should I do if the channel shows connected but doesn’t reply?
Check the bound Agent, workspace, allowed session IDs, and channel permission mode, then look at the channel logs. For platforms like Feishu and WeChat, also confirm bot permissions or the QR-code login status.
The scheduled task ran, so why didn’t I receive a message?
First check in \[Run History] whether the Agent succeeded. If it did but wasn’t delivered, check whether the channel has an available receiving target; usually you need to proactively send a message to the bot on the platform first.
### Data and Windows
Will deleting a working directory in Cherry Studio delete the disk files?
Deleting the working directory record from the Agent task list will not delete the directory on disk, but it will remove the task records under that directory. File operations performed by Agent may still modify real files, so check the permission mode.
How do I move a chat or Agent task to a separate window?
Right-click the topic, task, or top tab and choose \[Open in New Window]. The independent window can \[Always on Top], and you can also click \[Return to Main Window] to reattach it.
{% hint style="info" %}
If you can’t find the matching question, open the sidebar \[Help] → \[Feedback]. If the team needs to review private logs or the call chain, choose \[Upload Diagnostic Package]; if you’re unsure of the issue type, choose \[Ask the Feedback Assistant for Help] to organize reproduction details.
{% 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/docs/en-us/question-contact/questions.md?ask=&goal=
```
`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.