ask-docs

询问 CrewAI 文档

通过查阅 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、automations、traces、deployment、triggers、integrations
• 工具库 — 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 中设置遥测？"	其他技能未涵盖的 niche 功能
"Process.sequential 和 Process.hierarchical 有什么区别？"	详细比较最好从文档获取
"使用 output_pydantic 时遇到 ValidationError"	故障排除——文档可能包含已知问题或注意事项
"如何将 CrewAI flow 部署到生产环境？"	部署指南存在于文档中，而非设计技能中
"crewai 支持哪些 CLI 命令？"	CLI 参考是文档的范畴
"如何为 crew 配置 memory？"	超出 design-agent 覆盖范围的详细配置选项
"有哪些可用于网页抓取的工具？"	工具库参考
"如何为 CrewAI 企业版设置 SSO？"	企业功能存在于文档中
"如何使用 Flow.handle_turn() 构建聊天应用？"	实验性对话式 Flow API；验证最新指南

---

相关技能

• getting-started — 项目脚手架、选择抽象、Flow 架构
• design-agent — agent 角色-目标-背景故事、参数调优、工具、记忆与知识
• design-task — 任务描述、expected_output、护栏、结构化输出、依赖