> 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/zhong-wen-fan-ti/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" %}
冇搵到對應問題時，打開側欄【幫助】→【問題反饋】。需要團隊查看私密日誌或者調用鏈時揀【上傳診斷包】；唔確定問題類型時揀【求助問題反饋助手】整理重現信息。
{% 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/zhong-wen-fan-ti/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.