CrewAI 是什麼、怎麼用：開源多智能體框架的 Crews 與 Flows 入門教學

本文根據 CrewAI 官方 GitHub 倉庫 README 與官方文檔整理，資料核對於 2026-10-11。開源項目變化快，以官方倉庫為準。

是什麼

CrewAI 是一個開源的 Python 框架，用來搭建多智能體工作流，倉庫 crewAIInc/crewAI 在 GitHub 上約有 5.95 萬星標，採用 MIT 許可。README 對它的描述是：同時提供高層抽象和底層 API、面向生產環境的多智能體框架。

它最容易理解的地方在於「擬人化」的建模方式——你像組建一個小團隊那樣寫代碼：誰是研究員、誰是撰稿人、各自的目標是什麼、要完成哪些任務、產出交給誰。

核心概念

• Agent（智能體）：由角色（role）、目標（goal）、背景設定（backstory）、所用模型和工具定義。
• Task（任務）：包含任務描述、期望輸出，以及指派給哪個智能體。
• Crew（團隊）：一組按角色分工、自主協作的智能體。
• Flow（流程）：事件驅動的工作流，帶狀態管理和條件分支，可以在其中調用 Crew——適合需要精確控制步驟的生產場景。

簡單記：想讓智能體自己商量着幹用 Crew，想按固定流程走用 Flow，兩者可以嵌套。

怎麼上手

README 要求 Python 版本不低於 3.10、低於 3.14。先安裝命令行工具：

bash
uv tool install crewai
crewai create crew my_project

腳手架會生成項目結構，其中 agents.yaml 寫智能體的角色與目標，tasks.yaml 寫任務，crew.py 把它們組裝起來。填好模型的 API Key 後在項目目錄運行 crewai run。建議第一個項目只放兩個智能體（如「資料搜集」和「報告撰寫」），跑通後再加角色。

免費與付費

• 開源框架：MIT 許可，免費使用和商用。
• CrewAI AMP Suite：官方的商業平台，提供託管部署、可觀測性、治理、安全和企業支持；README 提到其中的 Crew Control Plane 可以免費試用，價格以官網為準。
• 模型費用：框架本身不含模型，調用哪家的模型就按哪家計費。

適合誰 / 不適合誰

適合：

• 會 Python、想用代碼而不是拖拽畫布搭 Agent 應用的開發者；
• 任務可以清晰拆成幾個角色分工的場景：調研寫作、數據整理、內容審核流水線等；
• 想了解多智能體協作模式的學習者。

不適合：

• 不寫代碼的用戶，釦子、Dify 這類可視化平台更合適；
• 只需要單個智能體加幾個工具的簡單場景，直接用模型廠商的 SDK 更輕；
• 需要對每一步狀態做極細粒度控制的複雜系統，可以對比 LangGraph。

注意事項

• 成本容易失控：多個智能體來回對話會成倍消耗 Token，開發階段先用便宜的模型並限制最大迭代次數。
• 結果不穩定是常態：同樣的輸入可能走出不同的協作路徑，關鍵環節要加校驗或改用 Flow 固定流程。
• 版本變化快：API 在迭代中，網上的老教學可能跑不通，以官方文檔的當前版本為準。
• 工具權限：給智能體掛載能執行代碼、訪問文件或發請求的工具時，要在隔離環境裏運行。