CrewAI — это open-source framework для multi-agent систем: вы собираете Flows (структурированный процесс со state) и внутри них запускаете Crews (команды агентов с ролями, целями и tools). Фокус-ключ: crewai. Pillar — ИИ-автоматизация / n8n; сосед по сравнению — LangChain vs CrewAI.

Соседи: LangGraph, n8n AI Agent, Dify.

Crew vs Flow vs AMP

Слой Роль Старт Когда брать
Flow оркестрация, state, listen/start crewai create flow production-контур и порядок шагов
Crew команда агентов + tasks crewai create crew нужна collaborative работа ролей
CLI / uv установка и run uv tool install crewai локальная разработка
CrewAI AMP managed / SaaS app.crewai.com когда нужен деплой без своего сервера

Источники: docs.crewai.com/en/introduction (Crews + Flows); docs.crewai.com/en/installation (Python >=3.10 и <3.14, uv tool install crewai, JSON-first create crew); docs.crewai.com/en/quickstart (Flow + researcher + crewai run). Цены AMP/Enterprise в ₽ не фиксируем — только кабинет. Срез: 2026-10-04.

Как пользоваться CrewAI: маршрут новичка

  1. Проверьте Python: нужен >=3.10 и <3.14.
  2. Поставьте uv, затем CLI: uv tool install crewai и проверьте crewai version.
  3. Для production-паттерна создайте Flow: crewai create flow latest-ai-flow (имя папки со underscores).
  4. Либо начните с crew: crewai create crew my_project — JSON-first scaffold с agents/*.jsonc и crew.jsonc. Старый YAML/Python — флаг --classic.
  5. Положите ключи LLM (и для quickstart research — SERPER_API_KEY) в .env, не в код.
  6. В корне проекта: crewai install, затем crewai run.
  7. В Quickstart Flow шаг @start() задаёт topic в state, @listen гоняет crew; отчёт пишется в output/report.md.
# Каркас по docs.crewai.com
# 1) uv tool install crewai
# 2) crewai create flow latest-ai-flow && cd latest_ai_flow
# 3) agents/researcher.jsonc + crew.jsonc (process: sequential)
# 4) .env: LLM keys + SERPER_API_KEY (для web search в quickstart)
crewai install
crewai run
# артефакт quickstart: output/report.md

Чеклист:
[ ] Python в диапазоне доки (>=3.10, <3.14)
[ ] Flow держит state; Crew делает research/задачу
[ ] Имена agents в crew.jsonc совпадают с файлами
[ ] Ключи только в .env
[ ] Цены AMP не выдумываем

Типичные ошибки

  • Путать Crew и Flow: без Flow state и порядок шагов размазываются по скриптам.
  • Хардкодить API keys вместо .env.
  • Ждать, что research-crew заработает без SERPER_API_KEY в quickstart с SerperDevTool.
  • Фиксировать цену AMP/Enterprise в ₽ без кабинета — не делаем.

FAQ: CrewAI

Что такое CrewAI?

CrewAI — open-source framework для multi-agent систем: Crews (команды агентов с ролями и задачами) работают внутри Flows (event-driven оркестрация со state). Канон: docs.crewai.com/en/introduction.

Чем Flow отличается от Crew?

Flow — каркас приложения: state, порядок шагов, ветки и события. Crew — команда агентов, которой Flow делегирует сложную задачу. Для production дока рекомендует начинать с Flow и вызывать Crew внутри шага.

Как установить CrewAI новичку?

Нужен Python >=3.10 и <3.14. Ставят uv, затем CLI: uv tool install crewai. Дальше scaffold: crewai create crew или crewai create flow , затем crewai install и crewai run. Источник: docs.crewai.com/en/installation.

Что лежит в новом JSON-first проекте crew?

В актуальной доке crewai create crew создаёт JSON-first scaffold: agents/*.jsonc, crew.jsonc, плюс .env, tools/, knowledge/, skills/. Классический YAML/Python scaffold доступен через флаг —classic.

Нужен ли Serper для quickstart Flow?

В официальном Quickstart Flow с research-агентом нужен SERPER_API_KEY для web search плюс ключи LLM-провайдера. Без ключей crewai run не соберёт живой отчёт. Смотрите docs.crewai.com/en/quickstart.

Чем CrewAI отличается от LangGraph и n8n AI Agent?

CrewAI заточен под role-playing Crews + Flows. LangGraph — low-level граф состояния. n8n AI Agent — no-code/low-code нода в workflow. Соседи на сайте: LangChain vs CrewAI, LangGraph, n8n AI Agent.

Вывод

CrewAI — связка Flows + Crews: Flow ведёт процесс и state, Crew решает задачу ролями агентов. Старт: uv → CLI → create flow/crew → install → run по docs.crewai.com. Когда нужна система обучения под агентов и автоматизацию — форматы на странице обучения.

Артём Денисов — эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Сверяет CrewAI с docs.crewai.com (Introduction, Installation, Quickstart).

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — ИИ-автоматизация / n8n.