ask-docs

CrewAI ドキュメントに質問する

ユーザーが実際に実行している crewai のバージョンに合わせて、公式ドキュメントから CrewAI に関する質問に回答します。

2026-10-01 に、crewai 1.15.23 と以下のドキュメントサイトで検証済みです。 2026-10-01 に、実際の LLM を使用してライブテスト済みです。

ドキュメントサイトは 2 つあります。

サイト	対象	インデックス	MCP サーバー
docs.crewai.com	オープンソースのフレームワーク：エージェント、クルー、タスク、フロー、メモリ、ナレッジ、LLM、ツール、CLI、テスト、テレメトリ、オブザーバビリティ、AMP REST API リファレンス（/inputs、/kickoff、/status、/resume）	https://docs.crewai.com/llms.txt	https://docs.crewai.com/mcp
docs-platform.crewai.com	CrewAI AMP（ホスト型プラットフォーム）：デプロイ、自動化、トリガー、RBAC、シークレット、Studio、プラットフォーム API	https://docs-platform.crewai.com/llms.txt	https://docs-platform.crewai.com/mcp

以前の docs.crewai.com/en/enterprise/... リンクは docs-platform.crewai.com/platform/en/... にリダイレクトされます。該当ページが存在する場合はそのページに（.md URL からでも HTML として）、存在しない場合はプラットフォームの概要ページにリダイレクトされます。プラットフォーム関連のトピックは docs-platform.crewai.com で直接確認してください。こちらのページも .md サフィックス付きで Markdown を提供します。

---

このスキルを使用する場合

• 他のスキルで扱われていない CrewAI の機能、パラメーター、または動作
• ユーザーの crewai version が、そのスキルの確認時に使われたバージョンと異なるため、「ask-docs で再検証してください」と別のスキルに記載されている場合
• 現在の API 構文、メソッドシグネチャ、または設定オプション
• ドキュメントのトラブルシューティング項目や注意事項に該当する可能性があるエラーメッセージ
• あまり一般的でない機能：テレメトリ、オブザーバビリティ連携、CLI コマンド、ツールライブラリ、AMP プラットフォーム機能
• 実験的な会話型 Flows（handle_turn()、ConversationConfig、RouterConfig、トレーシング、ストリーミング）

トピックを扱う兄弟スキルがある場合は、まずそちらを使用してください。 crewai 1.15.x に照らして確認済みの、厳選されたガイダンスがまとめられています。

トピック	スキル
プロジェクトのひな形作成、LLM.call()／Agent／Crew／Flow の選択	getting-started
エージェントの役割／目標／背景、LLM、メモリ、ナレッジ	design-agent
タスクの説明、expected_output、ガードレール、構造化出力	design-task
現行の 1.15.x API と、記憶にある 0.x API の比較	check-crewai-api
Flow の状態、@start／@listen／@router、永続化	build-flow
カスタムツール、crewai_tools、エージェント向け MCP サーバー	connect-tools-and-mcp
pytest と crewai test によるクルーおよびフローのテスト	test-crewai-project
CrewAI AMP へのデプロイ	deploy-to-amp
HTTP（/kickoff、/status、Webhook）経由でのデプロイ済みクルーの呼び出し	call-deployed-crew

ask-docs は、他のスキルで扱われていない内容と、兄弟スキル内のバージョン依存の項目の再確認に使用してください。

---

ドキュメントへの問い合わせ方法

利用可能な最初の方法を使用してください。

パス A：docs MCP サーバー（設定済みの場合）

docs.crewai.com/mcp サーバーに認証は必要ありません。次のツールを公開しています。

ツール	用途
search_crew_ai(query, version?, language?)	セマンティック検索です。各チャンクに Link が付いた、タイトル付きのチャンクを返します
query_docs_filesystem_crew_ai(command)	すべてのページと OpenAPI 仕様書を含む仮想ツリーに対する、読み取り専用のシェル（rg、head、ls、tree）です
submit_feedback(path, feedback)	ドキュメントの問題をドキュメントチームに報告します。ユーザーから依頼された場合を除き、呼び出さないでください

Claude Code では、ツールは mcp__<server-name>__search_crew_ai（例：mcp__crewai-docs__search_crew_ai）として表示されます。プラットフォームサーバーも同じ形式で、末尾に _platform が付きます。例：search_crew_ai_platform、query_docs_filesystem_crew_ai_platform。

ルール：

• version は必ず先頭に v を付けて指定してください。例："version": "v1.15.23"。指定しないと、edge とホストされているすべてのリリース（1.10.0 以降）の結果が混在し、古いものが先に表示されることがよくあります。v を付けずに "1.15.23" を指定すると、"No results found" が返されます。
• ファイルシステムは /<version>/<lang>/<path>.mdx（/v1.15.23/en/concepts/knowledge.mdx、/edge/en/...）および /openapi/<version>/enterprise-api.en.yaml の構成です。rg -l "restore_from_state_id" /v1.15.23/en を実行すると、該当シンボルに言及しているすべてのページが見つかります。
• 検索結果は大きくなることがあります（60 KB 以上）。まずクエリを絞り込み、必要なページに対して head -120 <file> を実行してください。
• 呼び出しが "Search failed" で失敗することがあります。その場合は Path B に切り替える前に、1 回再試行してください。

パス B：llms.txt と Markdown ページ（セットアップ不要）

1. インデックスを取得します。

   WebFetch: https://docs.crewai.com/llms.txt
   

   ## Docs の下に、およそ 220 行の - [Title](https://docs.crewai.com/v1.15.23/en/<path>.md): description が並び、その後に ## OpenAPI Specs（AMP REST API の YAML）が続きます。インデックスにはカテゴリ見出しがありません。タイトルまたはパスの接頭辞（/en/concepts/、/en/guides/、/en/learn/、/en/tools/、/en/mcp/、/en/observability/、/en/api-reference/）からページを探してください。
2. .md サフィックスを付けてページを取得します。レンダリング済み HTML（約 850 KB）ではなく、整形済みの Markdown（約 30 KB）が返されます。

   WebFetch: https://docs.crewai.com/en/<path>.md
   

   バージョンを指定しない /en/... URL は、最新リリース（2026-10-01 時点では /v1.15.23/en/...）にリダイレクトされます。
3. AMP プラットフォームに関する質問では、同様に https://docs-platform.crewai.com/llms.txt を使用します。見出し（Getting Started、Build、Operate、Manage、Integration Docs、Triggers、How-To Guides、API Reference）ごとに整理されています。

https://docs.crewai.com/llms-full.txt はすべてのページを 1 つのファイルにまとめたものです（約 2 MB）。コンテキストに読み込まないでください。インデックスから適切なページが見つからない場合は、ダウンロードして検索してください（curl -s ... | grep -n -A20 "restore_from_state_id"）。

会話型 Flows については、https://docs.crewai.com/en/guides/flows/conversational-flows.md を直接参照してください。これは会話型 API（crewai.flow からインポート。crewai.experimental.conversational は同じモジュールの非推奨エイリアス）の信頼できる情報源です。内容は今後も変更される可能性があります。

パス C：ドキュメントの GitHub ソース

ドキュメントは、公開リポジトリ crewAIInc/crewAI の docs/<version>/<lang>/<path>.mdx にあります。例：https://raw.githubusercontent.com/crewAIInc/crewAI/main/docs/v1.15.23/en/concepts/knowledge.mdx または .../docs/edge/en/...。以前の docs/en/... の構成は存在せず、404 になります。ドキュメントサイトにアクセスできない場合に限り、こちらを使用してください。

---

ユーザーのバージョンに合わせてドキュメントを参照する

1. crewai version を実行します（uv プロジェクトの場合は uv run python -c "import crewai; print(crewai.__version__)" を実行します）。
2. そのリリースのドキュメントを読みます。URL のプレフィックスは https://docs.crewai.com/v<X.Y.Z>/en/<path>.md です。または、MCP サーバーで version: "v<X.Y.Z>" を指定します。1.10.0 以降のリリースと edge（未リリースの main）がホストされています。ルートの llms.txt のみ存在し、/v<X.Y.Z>/llms.txt は 404 になるため、ルートのインデックスからパスを取得し、バージョンのプレフィックスを置き換えてください。
3. ユーザーのリリースがホストされていない場合は、最も近いホスト済みのバージョンを参照し、その旨を伝えます。ホストされていないバージョンは 404 にはなりません。/v1.9.0/en/concepts/knowledge.md はステータス 200 でホームページにリダイレクトされるため、取得したページがリクエストしたページと一致しているか確認してください。

---

ドキュメントのスニペットとインストール済みパッケージを照合する

ドキュメントは利用可能な機能を調べるうえで最適な索引ですが、スニペットが実行できる証拠ではありません。たとえば、@persist() のようなデコレーターの呼び出し形式は、インストール済みのバージョンに照らして確認してください。

重要なコードをユーザーに提示する前に、次のことを行います。

• インストール済みパッケージのシグネチャを確認します：python -c "import inspect, crewai.flow.flow as m; print(inspect.signature(m.Flow.kickoff))。
• API キーが不要であれば、主張を検証できる最小限のスニペットを実行します。
• ドキュメントとパッケージの内容が一致しない場合は、その旨を伝え、動作するバージョンを提示して、両方を引用します。check-crewai-api スキルには、記憶している API と現在の API の既知の相違点が記載されています。

---

ワークフローの概要

1. 質問を理解する - どの概念、API、動作についての質問か、また crewai のバージョンを確認します。
2. 参照先を選ぶ - フレームワーク（docs.crewai.com）か AMP プラットフォーム（docs-platform.crewai.com）を選びます。
3. 検索する - version を設定して MCP を使うか、llms.txt を参照してから該当バージョンの .md ページを参照します。
4. 確認する - コードが関係する場合は、インストール済みパッケージでシグネチャまたは小規模な実行を確認します。
5. 回答して引用する - ユーザーがさらに読めるよう、バージョンのプレフィックスを含むドキュメント URL を提示します。

作業例（2026-10-01 に crewai 1.15.23 で確認済み）

質問	回答が記載されている場所	ドキュメントの記載内容（確認済み）
「Flow をどのように永続化すればよいですか？」	/en/guides/flows/mastering-flow-state.md、/en/guides/flows/inputs-id-deprecation.md	crewai.flow.persistence の @persist() で Flow クラス（またはメソッド）をデコレートします。state には id が必要です。kickoff(restore_from_state_id=...) は保存済みの state から新しい state.id の下に分岐します。kickoff(inputs={"id": ...}) は同じ id で再開する方法として記載されていますが、非推奨です（1.15.23 では警告は出ません）。どちらもローカルで実行しました
「POST /kickoff には何を指定しますか？」	/en/api-reference/kickoff.md	必須の inputs（文字列値）と、任意の meta、taskWebhookUrl、stepWebhookUrl、crewWebhookUrl を含む JSON ボディです。{"kickoff_id": ...} が返されます。Bearer トークン認証です。インストール済みの crewai_tools の InvokeCrewAIAutomationTool も、同じ {"inputs": ...} ボディを POST します。完全なクライアントについては call-deployed-crew を参照してください
「ナレッジ用の埋め込みモデルを設定するにはどうすればよいですか？」	/en/concepts/knowledge.md	Crew（または Agent）に embedder={"provider": ..., "config": {...}} を渡します。LLM が OpenAI 以外の場合でも、デフォルトでは OpenAI の埋め込みが使われます。OPENAI_API_KEY がない場合、ナレッジの upsert でエラーが記録されます。Anthropic LLM と {"provider": "onnx", "config": {}} を使用した crew は、ナレッジソースから回答しました

その他の有用な質問：

ユーザーの質問	このスキルが役立つ理由
「Crew() が受け取るパラメーターは何ですか？」	API リファレンスを確認し、インストール済みのシグネチャと照合します
「テレメトリーを無効にするにはどうすればよいですか？」	収集される情報については /en/telemetry.md を参照してください。test-crewai-project スキルでは、インストール済みパッケージと照合済みの正確な切り替え値を確認できます
「crewai がサポートする CLI コマンドは何ですか？」	/en/concepts/cli.md を参照し、次にインストール済みバージョンで crewai --help を実行します
「ウェブスクレイピングに使えるツールは何ですか？」	/en/tools/ にある Tools ライブラリのページを参照してください
「AMP で RBAC を設定するにはどうすればよいですか？」	docs-platform.crewai.com（/platform/en/features/rbac）を参照してください
「Flow.handle_turn() を使ってチャットアプリを構築するにはどうすればよいですか？」	実験的な会話型 Flow API です。最新のガイドを参照してください

---

Docs MCP サーバーのセットアップ（任意）

パス B はセットアップなしで利用できます。構造化検索を使うには、コーディングエージェントにサーバーを追加してください。

Claude Code（claude mcp add）：

claude mcp add --transport http crewai-docs https://docs.crewai.com/mcp
# --scope project writes .mcp.json in the repo instead; --scope user makes it global
claude mcp list   # shows "crewai-docs: https://docs.crewai.com/mcp (HTTP) - Connected"

このコマンドで書き込まれるプロジェクトスコープの .mcp.json：

{
  "mcpServers": {
    "crewai-docs": {
      "type": "http",
      "url": "https://docs.crewai.com/mcp"
    }
  }
}

Codex CLI - codex mcp add crewai-docs --url https://docs.crewai.com/mcp を実行すると、~/.codex/config.toml（または $CODEX_HOME/config.toml）に以下が書き込まれます：

[mcp_servers.crewai-docs]
url = "https://docs.crewai.com/mcp"

Cursor - プロジェクト内の .cursor/mcp.json、または全プロジェクト共通の ~/.cursor/mcp.json に追加します（Cursor の MCP ドキュメント）：

{
  "mcpServers": {
    "crewai-docs": { "url": "https://docs.crewai.com/mcp" }
  }
}

その他のエージェントでは、https://docs.crewai.com/mcp をリモート（ストリーミング可能な HTTP）MCP サーバーとして追加してください。AMP プラットフォームのドキュメントについても、同じ方法で https://docs-platform.crewai.com/mcp を追加してください。

---

関連スキル

• getting-started — プロジェクトのひな型作成、抽象化の選択、Flow アーキテクチャ
• design-agent - エージェントの Role-Goal-Backstory、パラメーター調整、ツール、メモリ、ナレッジ
• design-task — タスクの説明、expected_output、ガードレール、構造化出力、依存関係
• check-crewai-api - 現在の 1.15.x API と、アシスタントが記憶している 0.x API の比較
• build-flow - Flow の state、デコレーター、ルーティング、永続化
• connect-tools-and-mcp - カスタムツール、crewai_tools、エージェント用 MCP サーバー
• test-crewai-project - crew と flow の決定論的な pytest テスト
• deploy-to-amp - crew または flow を CrewAI AMP にデプロイ
• call-deployed-crew - HTTP 経由でデプロイ済み crew を呼び出す