> 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" %}
搵唔到對應問題時，打開【設定】→【關於我哋】→【反饋】，優先揀【使用 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/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.