常見問題

模型同連接

模型服務已經填咗 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 會幫你檢查而家狀態、整理可重現資訊，並喺提交前畀你確認。