ИИ-агенты для начинающих. Часть 3. Установка CrewAI и создание нового проекта

18.02.2025

При подготовке статьи использовалась публикация «Crew AI installation».

CrewAI требует версию Python от 3.10 до 3.12 (включительно). Вот как проверить вашу версию:

Bash

python3 --version

Создание виртуального окружения

Bash

python3 -m venv .venv

conda:

Bash

conda create -n crewai-env python=3.12

Активация виртуального окружения

macOS/Linux:

Bash

source .venv/bin/activate

Windows:

Bash

.venv\Scripts\activate

conda (все платформы):

Bash

conda activate crewai-env

Установка CrewAI

Установим CrewAI со всеми рекомендованными инструментами, используя один из способов:

Bash

pip install 'crewai[tools]'

или

Bash

pip install crewai crewai-tools

Обновление CrewAI (только для существующих установок)

Если у вас установлена более старая версия CrewAI, вы можете обновить ее:

Bash

pip install --upgrade crewai crewai-tools

Проверка установки

Проверьте установленные версии:

Bash

pip freeze | grep crewai

Вы увидите что-то типа:

Bash

crewai==X.X.X
crewai-tools==X.X.X

Создание нового проекта CrewAI

Введем в консоли:

Bash

crewai create crew hmhm_project

Выберем провайдера LLM, например, ollama.

Выберем модель llama3.1 (принадлежит Meta, которая признана экстремистской и запрещена в РФ):

Успешное создание нового проекта:

Структура проекта

Bash

hmhm_project/
├── knowledge/
│   └── user_preference.txt
├── src/
│   └── hmhm_project/
│       ├── config/
│       │   ├── agents.yaml
│       │   └── tasks.yaml
│       ├── tools/
│       │   ├── custom_tool.py
│       │   └── __init__.py
│       ├── crew.py
│       ├── main.py
│       └── __init__.py
├── tests/
├── .env
├── .gitignore
├── pyproject.toml
└── README.md

Установка дополнительных инструментов

Bash

uv add <tool-name>

Содержание проекта

Файл	Назначение
`agents.yaml`	Определение ИИ-агентов и их ролей
tasks.yaml	Настройка задач и рабочих процессов агентов
.env	API-ключи и переменные окружения
main.py	Основной файл, запускающий агентов
crew.py	Оркестрация и координация команды
tools/	Папка для инструментов агентов

***

Содержание

Практикум

Создание системы автоматического перевода и редактирования текстов