最終更新日:2026年8月5日
CrewAIは、複数のAIエージェントが協力してタスクを遂行するフレームワークです。本記事では、CrewAIの環境構築方法から活用事例まで詳しく解説します。
1. CrewAIの概要
CrewAIは、AIエージェントを活用して効率的にタスクを分担・自動化するツールです。各エージェントが独自の役割を持ち、協調して作業を進めることで、より高度なAIアプリケーションを構築できます。
CrewAIの主な特徴
- エージェントベースのタスク管理: 役割ごとのエージェントを設定し、自動でタスクを処理。
- カスタマイズ可能なワークフロー: 柔軟な設定が可能で、プロジェクトの要件に応じた最適な構成が可能。
- 外部ツールとの統合: OpenAI APIをはじめ、LiteLLM経由でAnthropic・Google Gemini・Azure OpenAI・Ollamaなど多くのLLMプロバイダーやツールと連携可能。
2. 前提条件
システム要件
- Python 3.10以上 3.14未満(2026年8月時点の公式要件。
python3 --versionで事前に確認) - 使用するLLMプロバイダーのAPIキー(OpenAIが代表的だが、Anthropic・Google Gemini・Azure OpenAI・Ollama等もLiteLLM経由で利用可能)
3. インストール手順
uvの利用を公式に推奨しており、crewai create crew <プロジェクト名>コマンドを実行すると、エージェント設定を.jsoncファイルで管理する新形式のプロジェクトが自動生成されます。以下で紹介する pip + venv による手動セットアップと、次項で紹介するPython/YAML構成は現在「クラシック形式」という位置付けで、--classicフラグを付けることで引き続き利用できます。
1. 仮想環境の構築
python -m venv crewai-env
source crewai-env/bin/activate # Linux/macOSの場合
venvScriptsactivate # Windowsの場合
2. CrewAIのインストール
pip install crewai # 基本パッケージのみ
# または
pip install 'crewai[tools]' # 追加ツール込み
3. APIキーの設定
import os
os.environ["OPENAI_API_KEY"] = "your-api-key-here"
なお、現在の公式ドキュメントでは、コード内にAPIキーを直接書かず、.envファイルに記述して環境変数として読み込む方法が推奨されています。crewai create crewで生成したプロジェクトには.envファイルの雛形が自動で用意されます。
4. CLIコマンドによるプロジェクト作成(新形式・推奨)
手動でのvenv構築に加えて、CrewAI公式CLIを使うと雛形一式が自動生成され効率的です。
pip install crewai
crewai create crew my_project
cd my_project
crewai install
crewai run
crewai create crewを実行すると、エージェント設定(agents/*.jsonc)とクルー設定(crew.jsonc)をJSON形式で管理する新形式のプロジェクトが作られます。次項で紹介する従来のPython/YAML形式が必要な場合は、crewai create crew my_project --classicのように--classicフラグを付けて実行してください。
4. プロジェクト構造
以下は、--classicフラグで生成される従来型(クラシック形式)のプロジェクト構成です。前項で触れた通り、現在のデフォルトはJSON主導の新形式のため、最新のドキュメントに沿って開発する場合は構成が異なる点に注意してください。
推奨されるフォルダ構成
my_project/
├── .gitignore
├── pyproject.toml
├── README.md
└── src/
└── my_project/
├── __init__.py
├── main.py
├── crew.py
├── tools/
└── config/
5. 追加の依存関係
必要に応じて、以下のライブラリもインストールします:
pip install beautifulsoup4 gradio langchain_openai python-dotenv
6. 動作確認
インストールが正しく行われたかを確認するため、以下のコマンドを実行します:
pip freeze | grep crewai
# または、CLIでインストール済みのバージョンを直接確認
crewai version
7. CrewAIの活用事例
1. 自動化タスク管理
CrewAIを使用することで、データ収集やレポート生成などの定型業務を自動化できます。
2. AIアシスタントの開発
エージェントを組み合わせて、カスタムAIアシスタントを作成可能です。
3. データ分析と処理
機械学習モデルと統合し、大量データの解析・処理を効率化できます。
まとめ
この記事のポイント:
- CrewAIは、複数のAIエージェントが役割を分担して協調動作するマルチエージェントフレームワーク
- Python 3.10以上3.14未満が必要(2026年8月時点の公式要件)
pip install crewai(従来型)またはuv+crewai create crew(公式推奨の新形式)でセットアップ可能- APIキーはOpenAIだけでなく、LiteLLM経由でAnthropic・Gemini等も利用可能。
.envファイルでの管理が推奨されている - 自動化タスク管理・AIアシスタント開発・データ分析など幅広い用途に活用できる
これで基本的な環境構築と活用方法の紹介は完了です。CrewAIを活用し、より高度なAIプロジェクトに挑戦してみてください!
関連記事
- 複数AIエージェントによる革新的ワークフロー:CrewAI導入のメリットと活用事例
- AWS EC2のT3インスタンスで始めるCrewAI開発入門 — ローカルとクラウドを使い分けたハイブリッド環境構築ガイド
- エージェントAIの「精度」を高めるには?― AutoGenとcrewAIの特性比較から考える最適な選択肢 ―
- エージェントAI開発における主要オープンソースフレームワーク
▼ アクロビジョンについて