CrewAI 除錯與常見錯誤：新手最常爆的 8 個雷

真相時間：Agent 開發不是最難，除錯才是最花時間。
這篇給你一張踩雷地圖，讓你少繞彎路。

8 個最常見問題

現象	常見原因	快速解法
輸出格式每次不同	expected_output 太模糊	加入格式規範，必要時用 output_pydantic
後續 Task 拿不到資料	缺 context	在 tasks.yaml 明確串接
Tool 完全沒被叫	任務描述沒寫工具使用條件	在 Task 指令中強制要求先查工具
成本暴增	任務太長、重複呼叫	任務拆小、縮短 prompt、加快取
回答幻覺嚴重	缺來源約束	要求 source URL 與引用格式
流程卡住	分支條件不完整	檢查 router 回傳值與 listener 對應
啟動就噴錯	環境變數未設	檢查 .env 與 API Key
表現忽好忽壞	測試資料不固定	建立固定測試輸入與驗收規則

建議的除錯順序

1. 先看配置：agents.yaml、tasks.yaml
2. 再看輸入：inputs 是否穩定
3. 再看工具：參數、回傳格式
4. 最後看模型：溫度、上下文長度、成本

順序不要反過來，很多人一出問題就怪模型，結果是 YAML 少一行。

一個很好用的小技巧

把每個 Task 都加上「輸出摘要」與「關鍵欄位檢查」，像這樣：

• 是否有結論
• 是否有來源
• 是否符合 markdown 結構

你可以把它當作流程中的小型單元測試。

下一步

最後一篇我們把前面全部串起來，變成可上線的實戰準則：
👉 上線最佳實踐