ask-docs

Ask CrewAI Docs

透過查閱 docs.crewai.com 的官方文件來回答 CrewAI 相關問題。

---

何時使用此技能

請在以下情況使用此技能：

• 使用者詢問其他技能未詳細涵蓋的 CrewAI 功能、參數或行為
• 你需要確認最新的 API 語法、方法簽章或設定選項
• 使用者遇到錯誤，需要官方文件的疑難排解指引
• 問題涉及較新或較少使用的 CrewAI 功能（例如：遙測、測試、CLI 指令、部署、企業功能）
• 問題涉及實驗性的對話式 Flow，你需要最新的 handle_turn()、ConversationConfig、RouterConfig、追蹤或串流行為
• 你不確定自己的知識是否為最新——文件反映了最新的發布狀態

請勿使用此技能 當問題明顯可由其他技能（getting-started、design-agent、design-task）回答時。那些技能包含經過策劃的指引。此技能用於填補缺口和驗證細節。

---

如何查詢文件

步驟 1：取得文件索引

CrewAI 文件網站發布了一個 llms.txt 檔案——一個結構化的索引，包含每個文件頁面及其描述。先取得它以找到正確的頁面：

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

這會回傳所有文件頁面的分類列表，格式如下：

- [頁面標題](https://docs.crewai.com/path/to/page): "頁面內容的描述"

分類包括：

• API 參考 — REST 端點（kickoff、status、resume、inputs）
• 概念 — agents、crews、tasks、tools、flows、memory、knowledge、LLMs、processes、training、testing
• 企業 — RBAC、SSO、自動化、追蹤、部署、觸發器、整合
• 工具庫 — 40+ 個工具，按類別分類（AI/ML、自動化、雲端、資料庫、檔案、搜尋、網頁爬取）
• MCP 整合 — MCP 伺服器設定、傳輸、DSL、安全性
• 範例與食譜 — 實際實作
• 學習路徑 — 教學與進階主題
• 可觀測性 — 監控整合

對於對話式 Flow 的問題，直接前往：

WebFetch: https://docs.crewai.com/en/guides/flows/conversational-flows

將此頁面視為實驗性 crewai.experimental.conversational 介面的權威來源。在回答詳細的 API 問題前請先驗證，因為該功能在正式發布前可能會有變動。

步驟 2：取得相關頁面

一旦從索引中識別出正確的頁面，取得其內容：

WebFetch: https://docs.crewai.com/<path-from-index>

步驟 3：綜合並引用

將從文件中找到的資訊與其他技能的上下文結合，提供清晰且可操作的答案。務必包含文件 URL，以便使用者進一步閱讀。

---

工作流程摘要

1. 理解使用者的問題 — 他們詢問的是哪個特定的 CrewAI 概念、API 或行為？
2. 取得 llms.txt — 掃描索引以找到最相關的頁面
3. 取得頁面 — 擷取實際的文件內容
4. 綜合答案 — 將文件內容與其他技能的上下文結合
5. 引用來源 — 在回覆中包含文件 URL

---

更好的使用體驗

經常查詢 CrewAI 文件的使用者可以在他們的程式碼代理中設定 CrewAI 文件 MCP 伺服器，以獲得更豐富的結構化搜尋：

https://docs.crewai.com/mcp

這是可選的——上述的 llms.txt 工作流程無需任何設定即可運作。

---

良好使用案例範例

使用者問題	為何使用此技能
"Crew() 接受哪些參數？"	特定 API 參考——文件具有權威性
"如何在 CrewAI 中設定遙測？"	其他技能未涵蓋的冷門功能
"Process.sequential 和 Process.hierarchical 有什麼差別？"	詳細比較最好從文件取得
"使用 output_pydantic 時出現 ValidationError"	疑難排解——文件可能包含已知問題或注意事項
"如何將 CrewAI flow 部署到正式環境？"	部署指引存在於文件中，而非設計技能
"crewai 支援哪些 CLI 指令？"	CLI 參考是文件的範疇
"如何為 crew 設定記憶體？"	比 design-agent 涵蓋的更詳細的設定選項
"有哪些工具可用於網頁爬取？"	工具庫參考
"如何為 CrewAI 企業版設定 SSO？"	企業功能存在於文件中
"如何使用 Flow.handle_turn() 建立聊天應用？"	實驗性對話式 Flow API；驗證最新指南

---

相關技能

• getting-started — 專案架構、選擇抽象層、Flow 架構
• design-agent — 代理的角色-目標-背景故事、參數調整、工具、記憶體與知識
• design-task — 任務描述、expected_output、護欄、結構化輸出、相依性