crewAI：マルチエージェントワークフローのためのオープンソースPythonフレームワーク

Crew と Flow を分ける設計

crewAIは、自律的なAIエージェントをオーケストレーションするためのオープンソースのPythonフレームワークです。READMEでは、本番対応のマルチエージェントワークフローを構築するための高水準の抽象化と低水準のAPIを備えたフレームワークと説明されています。中核となる考え方は、補完的な2つのプリミティブです。Crews（役割、目標、タスクを持ち自律的に協調するAIエージェントのチーム）とFlows（実行、状態、分岐を精密に制御するイベント駆動のワークフロー）です。リポジトリメタデータには56,643スターと8,072フォークが示され、プロジェクトはMITライセンスで公開されています。READMEはまた、管理されたデプロイと可観測性を必要とする企業向けの商用製品、CrewAI AMP Suiteにも言及しています。

エージェントへ渡す役割とタスク

CrewsはcrewAIの自律的な側面です。エージェントに役割、目標、バックストーリーを定義し、タスクを割り当てます。READMEでは、研究者エージェントが情報を収集し、レポートアナリストがレポートを書くという順次プロセスを示しています。エージェントには、Web検索用のSerperDevToolなどのツールを与えることができます。Crewは@CrewBaseデコレータで作成され、タスクはYAMLファイルまたはPythonで直接定義されます。READMEはまた、マネージャーエージェントを自動的に割り当てて結果を調整および検証する階層プロセスにも言及しています。プロセスの詳細については、READMEにドキュメントリンクが提供されています。

イベント駆動で組む Flow

Flowsは精密でイベント駆動の制御を提供します。READMEでは、フローは@start、@listen、@routerなどのデコレータを使用して実行パスを定義します。状態は、多くの場合Pydanticモデルである構造化オブジェクトを通じて管理されます。or_やand_などの論理演算子は複数の条件を組み合わせます。フローはステップとしてCrewを呼び出し、その結果に基づいてルーティングできます。たとえば、信頼度スコアをチェックし、high_confidenceまたはmediumとlowの信頼度の組み合わせをリッスンするルーターです。READMEには、これらの機能を使用するAdvancedAnalysisFlowの完全な例が含まれています。

CLI が作るプロジェクトの骨格

READMEではプロジェクトの作成手順を説明しています。Python >=3.10 <3.14とUVパッケージマネージャーが必要です。crewaiはuv pip install crewaiでインストールし、オプションのツールはuv pip install 'crewai[tools]'で追加します。次に、crewai create crew <project_name>を実行して、srcディレクトリ、設定ファイル、.envテンプレートを含むプロジェクトをスキャフォールドします。生成されるファイルには、エージェントとタスクを定義するagents.yamlとtasks.yaml、Crewを組み立てるcrew.py、エントリポイントとしてのmain.pyが含まれます。READMEは、研究者とレポートアナリストを含む簡単なCrewを示し、crewai runまたはpython src/my_project/main.pyで実行します。OpenAIとSerper.devの環境変数が必要です。

ツール接続と実行時の制御

READMEは、ランディングページジェネレーター、旅行プランナー、株価分析、求人情報などの例を含む別の例リポジトリを指しています。また、CrewAIを学ぶための2つのdeeplearning.aiコースもリストしています。エンタープライズユーザー向けに、CrewAI AMP Suiteはトレーシング、可観測性、ガバナンス、デプロイオプションを備えたコントロールプレーンを追加します。その一部であるCrew Control Planeは無料で試せます。READMEはまた、Pythonバージョン、OS、エージェントとタスクの数、エージェントがメモリを使用するかどうかなど、匿名の使用データを収集するテレメトリシステムにも言及しています。share_crew機能が有効でない限り、プロンプト、タスク説明、API応答は収集されず、ユーザーはOTEL_SDK_DISABLED=trueでテレメトリを無効にできます。

README から読めない本番条件

プロジェクトはMITライセンスです。ライセンス文は、ソフトウェアの使用、コピー、変更、結合、公開、配布、サブライセンス、販売の権利を許可し、ソフトウェアは保証なしで現状のまま提供されます。READMEは貢献者にリポジトリをフォークし、ブランチを作成し、機能を追加し、プルリクエストを送信するよう求めています。ドキュメントはdocs/ディレクトリからMintlifyを使用して公開され、リリース後に不変のバージョン付きスナップショットが作成されます。READMEには、テストの実行（uv run pytest .）と静的型チェック（uvx mypy src）のコマンドが含まれています。リポジトリはアーカイブされておらず、デフォルトブランチはmainです。

CrewAI の中心的な判断は、処理を Crew と Flow のどちらに置くかです。Crew は役割、エージェント、タスクの協調を表し、Flow はイベントを受けた状態遷移を記述します。README が示す CLI のスキャフォールドは、空の Python プロジェクトから構成を揃える出発点です。外部ツールを接続した場合、モデルの推論だけでなくツール呼び出しの失敗、再試行、権限を追跡する必要があります。README はベンチマークや監査結果を示していないため、マルチエージェント化による遅延やトークン消費を当然の前提にしないほうがよいでしょう。単一の関数で完結する処理なら、通常の Python 呼び出しのほうが読解しやすい場合があります。

編集部の結論

役割を持つ複数エージェントの処理を Python で組みたいチームに向きます。単発のプロンプトや厳密な決定論的ジョブには構成が重くなります。最初に Crew のタスク委譲と Flow のイベント遷移を小さな実行で確認し、外部ツールの失敗時動作を記録してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes