阅读排版
---
name: ask-docs
description: "Query the official CrewAI documentation for answers. Use when the user has a CrewAI question that isn't fully covered by the getting-started, design-agent, design-task skills — e.g., specific API details, configuration options, advanced features, troubleshooting errors, enterprise features, tool references, or anything where the latest docs are the best source of truth."
---
# Ask CrewAI Docs
Answer CrewAI questions by looking up the official documentation at `docs.crewai.com`.
---
## When to Use This Skill
Use this skill when:
- The user asks about a CrewAI feature, parameter, or behavior not covered in detail by the other skills
- You need to verify current API syntax, method signatures, or configuration options
- The user hits an error and needs troubleshooting guidance from official docs
- The question is about a newer or less common CrewAI feature (e.g., telemetry, testing, CLI commands, deployment, enterprise features)
- The question is about experimental conversational Flows and you need the current `handle_turn()`, `ConversationConfig`, `RouterConfig`, tracing, or streaming behavior
- You're unsure whether your knowledge is current — the docs reflect the latest published state
**Do NOT use this skill** when the question is clearly answered by one of the other skills (getting-started, design-agent, design-task). Those skills contain curated, opinionated guidance. This skill is for filling gaps and verifying details.
---
## How to Query the Docs
### Step 1: Fetch the docs index
The CrewAI docs site publishes an `llms.txt` file — a structured index of every documentation page with descriptions. Fetch it first to find the right page:
```
WebFetch: https://docs.crewai.com/llms.txt
```
This returns a categorized list of all doc pages in the format:
```
- [Page Title](https://docs.crewai.com/path/to/page): "Description of what the page covers"
```
Categories include:
- **API Reference** — REST endpoints (kickoff, status, resume, inputs)
- **Concepts** — agents, crews, tasks, tools, flows, memory, knowledge, LLMs, processes, training, testing
- **Enterprise** — RBAC, SSO, automations, traces, deployment, triggers, integrations
- **Tools Library** — 40+ tools organized by category (AI/ML, automation, cloud, database, files, search, web scraping)
- **MCP Integration** — MCP server setup, transports, DSL, security
- **Examples & Cookbooks** — practical implementations
- **Learning Paths** — tutorials and advanced topics
- **Observability** — monitoring integrations
For conversational Flow questions, go directly to:
```
WebFetch: https://docs.crewai.com/en/guides/flows/conversational-flows
```
Treat this page as the source of truth for the experimental `crewai.experimental.conversational` surface. Verify it before answering detailed API questions because the feature may change before it graduates.
### Step 2: Fetch the relevant page
Once you identify the right page from the index, fetch its content:
```
WebFetch: https://docs.crewai.com/
```
### Step 3: Synthesize and cite
Combine what you find from the docs with context from the other skills to give a clear, actionable response. Always include the docs URL so the user can read further.
---
## Workflow Summary
1. **Understand the user's question** — what specific CrewAI concept, API, or behavior are they asking about?
2. **Fetch `llms.txt`** — scan the index to find the most relevant page(s)
3. **Fetch the page(s)** — retrieve the actual documentation content
4. **Synthesize the answer** — combine docs content with context from other skills
5. **Cite the source** — include the docs URL in your response
---
## For an Even Better Experience
Users who frequently query CrewAI docs can configure the CrewAI docs MCP server in their coding agent for richer, structured search:
```
https://docs.crewai.com/mcp
```
This is optional — the `llms.txt` workflow above works without any setup.
---
## Examples of Good Use Cases
| User Question | Why This Skill |
|---|---|
| "What parameters does `Crew()` accept?" | Specific API reference — docs are authoritative |
| "How do I set up telemetry in CrewAI?" | Niche feature not covered in other skills |
| "What's the difference between `Process.sequential` and `Process.hierarchical`?" | Detailed comparison best sourced from docs |
| "I'm getting `ValidationError` when using `output_pydantic`" | Troubleshooting — docs may have known issues or caveats |
| "How do I deploy a CrewAI flow to production?" | Deployment guidance lives in docs, not in design skills |
| "What CLI commands does `crewai` support?" | CLI reference is a docs concern |
| "How do I configure memory for a crew?" | Detailed config options beyond what design-agent covers |
| "What tools are available for web scraping?" | Tools library reference |
| "How do I set up SSO for CrewAI enterprise?" | Enterprise features live in docs |
| "How do I build a chat app with Flow.handle_turn()?" | Experimental conversational Flow API; verify the latest guide |
---
## Related Skills
- **getting-started** — project scaffolding, choosing abstractions, Flow architecture
- **design-agent** — agent Role-Goal-Backstory, parameter tuning, tools, memory & knowledge
- **design-task** — task descriptions, expected_output, guardrails, structured output, dependencies