CrewAI 多代理协作平台

Build with AI

Using an AI coding agent? Teach it CrewAI best practices in one command:

Claude Code:

/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins
/reload-plugins

Cursor, Codex, Windsurf, and others (skills.sh):

npx skills add crewaiinc/skills

This installs the official CrewAI Skills — structured instructions that teach coding agents how to scaffold Flows, configure Crews, design agents and tasks, and follow CrewAI patterns.

Getting Started

Setup and run your first CrewAI agents by following this tutorial.

Getting Started with Installation

To get started with CrewAI, follow these simple steps. The full walkthrough lives in the installation guide.

1. Installation

CrewAI requires Python >=3.10 and <3.14. Check your version with:

python3 --version

CrewAI uses UV for dependency management and package handling. If you haven't installed uv yet, install it first.

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

If your system doesn't have curl, you can use wget:

wget -qO- https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

If you run into any issues, refer to UV's installation guide.

Then install the CrewAI CLI:

uv tool install crewai

If you encounter a PATH warning, run:

uv tool update-shell

If you encounter the chroma-hnswlib==0.7.6 build error (fatal error C1083: Cannot open include file: 'float.h') on Windows, install Visual Studio Build Tools with Desktop development with C++.

Verify the install:

uv tool list

You should see something like:

crewai v0.102.0
- crewai

To upgrade the global CLI later:

uv tool install crewai --upgrade

This upgrades the global crewai CLI tool only. To upgrade the crewai version inside a project's virtual environment, see Upgrading CrewAI in a project.

Q: How do I install CrewAI?

A: Install the CrewAI CLI with UV:

uv tool install crewai

Then create a project with crewai create crew <project_name>, run crewai install, and start it with crewai run. See the installation guide for details.

Q: Is CrewAI AMP available for cloud and on-premise deployments?

A: Yes, CrewAI AMP supports both cloud-based and on-premise deployment options, allowing enterprises to meet their specific security and compliance requirements.

Examples

You can test different real life examples of AI crews in the CrewAI-examples repo:

• Landing Page Generator
• Having Human input on the execution
• Trip Planner
• Stock Analysis

Quick Tutorial

Q: Can CrewAI handle complex use cases?

A: Yes. CrewAI excels at both simple and highly complex real-world scenarios, offering deep customization options at both high and low levels, from internal prompts to sophisticated workflow orchestration.

Q: Where can I find real-world CrewAI examples?

A: Check out practical examples in the CrewAI-examples repository, covering use cases like trip planners, stock analysis, and job postings.

2. Setting Up Your Crew

crewai create crew creates a JSON-first crew project. Agents live in agents/*.jsonc, tasks and crew-level settings live in crew.jsonc, and crewai run loads that JSON definition directly.

crewai create crew <project_name>

This command creates a new project folder with the following structure:

my_project/
├── .gitignore
├── .env
├── agents/
│   └── researcher.jsonc
├── crew.jsonc
├── knowledge/
├── pyproject.toml
├── README.md
├── skills/
└── tools/

If you need the older Python/YAML scaffold with crew.py, config/agents.yaml, and config/tasks.yaml, run:

crewai create crew <project_name> --classic

See Using Annotations for the classic pattern.

To customize your project, you can:

• Modify agents/*.jsonc to define each agent's role, goal, backstory, LLM, tools, and behavior.
• Modify crew.jsonc to define tasks, process, and input defaults.
• Add custom tools in tools/ and reference them as "custom:<name>".
• Add optional knowledge files in knowledge/ and skill files in skills/.
• Add your environment variables into the .env file.

Use {placeholder} values in agent and task text, then set defaults in crew.jsonc under inputs. When you run crewai run, the CLI prompts for any missing values.

Example of a simple crew with a sequential process:

crewai create crew latest-ai-development
cd latest_ai_development

Then edit the generated files:

agents/researcher.jsonc

{
  "role": "{topic} Senior Data Researcher",
  "goal": "Uncover cutting-edge developments in {topic}",
  "backstory": "You're a seasoned researcher who finds relevant information and presents it clearly.",
  "llm": "openai/gpt-4o",
  "tools": ["SerperDevTool"],
  "settings": {
    "verbose": true
  }
}

agents/reporting_analyst.jsonc

{
  "role": "{topic} Reporting Analyst",
  "goal": "Create detailed reports based on {topic} data analysis and research findings",
  "backstory": "You're a meticulous analyst who turns complex data into clear, concise reports.",
  "llm": "openai/gpt-4o",
  "settings": {
    "verbose": true
  }
}

crew.jsonc

{
  "name": "Latest AI Development",
  "agents": ["researcher", "reporting_analyst"],
  "tasks": [
    {
      "name": "research_task",
      "description": "Conduct thorough research about {topic}. Find recent, relevant information.",
      "expected_output": "A list with 10 bullet points of the most relevant information about {topic}.",
      "agent": "researcher"
    },
    {
      "name": "reporting_task",
      "description": "Review the research and expand each topic into a full section for a report.",
      "expected_output": "A markdown report with the main topics, each with a full section of information. No fenced code blocks around the whole document.",
      "agent": "reporting_analyst",
      "context": ["research_task"],
      "output_file": "output/report.md",
      "markdown": true
    }
  ],
  "process": "sequential",
  "verbose": true,
  "inputs": {
    "topic": "AI Agents"
  }
}

Q: Is CrewAI suitable for production environments?

A: Yes, CrewAI is designed with production-grade patterns that support reliable, stable, and scalable agentic workflows.

Q: Can CrewAI agents interact with external tools and APIs?

A: Absolutely! CrewAI agents can easily integrate with external tools, APIs, and databases, empowering them to leverage real-world data and resources.

Q: Can CrewAI automate human-in-the-loop workflows?

A: Yes, CrewAI fully supports human-in-the-loop workflows, allowing seamless collaboration between human experts and AI agents for enhanced decision-making.

Frequently Asked Questions (FAQ)