7.5 KiB
| title | description | lang |
|---|---|---|
| Быстрый старт – Документация Agent Teams | От свежей установки до запущенной команды AI-агентов за несколько минут. Установка, выбор рантайма, создание команды и первый код-ревью. | ru-RU |
Быстрый старт
Этот гайд проводит от свежей установки до первой запущенной команды за несколько минут.
1. Установите Agent Teams
Скачайте последний релиз под вашу платформу на странице загрузок или в GitHub releases.
::: tip Приложение бесплатное и с открытым кодом. Выбранный runtime может требовать доступ к провайдеру — подробности в разделе Установка. :::
::: info
Desktop-приложение — основной продукт. Agent Teams также работает в браузере для разработки, но браузерный режим не имеет полного desktop IPC, терминала, provider auth и lifecycle. Для обычной разработки используйте pnpm dev (Electron), а не браузерный режим.
:::
2. Откройте проект
Запустите приложение и выберите директорию проекта, где агенты будут работать. Agent Teams читает локальные файлы проекта и runtime/session state, чтобы показывать задачи, логи, diffs и активность команды.
::: tip Выберите проект под Git — так вы получите лучший опыт. Изоляция через worktree и ревью по diff зависят от Git. :::
Перед запуском команды проверьте базовое состояние проекта:
git status --short
Не обязательно иметь идеально чистое дерево, но важно понимать, какие изменения уже были вашими до старта агентов. Так проще доверять task diffs и hunk-level review.
3. Выберите runtime
Мастер настройки автоматически определит установленные рантаймы на вашей машине. Стандартные варианты:
| Runtime | Когда подходит |
|---|---|
| Claude | Если вы уже используете Claude Code или у вас есть Anthropic access |
| Codex | Для Codex-native workflows и OpenAI access |
| OpenCode | Для multi-model команд и большого числа provider backends |
::: info Поддержка провайдера Gemini в разработке. Текущий статус провайдеров смотрите в разделе Провайдеры и рантаймы. :::
Подробная настройка каждого провайдера — в разделе Настройка рантайма.
Чтобы проверить выбранный runtime вне приложения, запустите соответствующую команду версии:
claude --version
codex --version
opencode --version
Если команда падает в терминале, сначала исправьте runtime installation или PATH. Team prompts не смогут компенсировать отсутствующий binary или provider auth.
4. Создайте первую команду
Начните с маленькой команды: lead, implementation agent и review-oriented agent. Этого достаточно, чтобы проверить workflow без лишнего шума.
Рекомендованная структура и советы — в разделе Создание команды.
Для первого запуска используйте примерно такую структуру:
| Member | Responsibility | Notes |
|---|---|---|
| Lead | Делит цель на tasks и координирует status | Держите на самом надёжном provider |
| Builder | Реализует scoped tasks | Дайте понятные file или feature boundaries |
| Reviewer | Проверяет завершённую работу | Попросите фокусироваться на regressions и missing tests |
Не начинайте сразу с пяти и более teammates. Больше агентов означает больше concurrency, logs, provider usage и риск конфликтов до того, как вы убедились, что setup здоровый.
5. Дайте lead-агенту конкретную цель
Пишите задачу как инженерному лиду:
Улучши onboarding flow. Разбей работу на задачи, держи изменения маленькими и проси review перед широкими рефакторингами.
Хороший первый prompt содержит scope, safety boundaries и verification:
Improve the docs quickstart. Keep edits inside landing/product-docs. Add practical examples, preserve existing VitePress syntax, and run the docs build before marking tasks done.
Избегайте размытых prompts вроде "make the app better" для первого запуска. Lead может дробить большие цели, но хороший input даёт более маленькие tasks и чище review.
Lead создаёт задачи, назначает работу и координирует teammates. Вы следите за прогрессом на канбан-доске и вмешиваетесь через комментарии или direct messages в любой момент.
6. Проверьте результат
Откройте задачи в review/done, посмотрите diff, примите или отклоните изменения. Если нужно понять мотивацию агента, откройте task logs.
Полный процесс ревью — в разделе Код-ревью.
Перед approval первой task проверьте три вещи:
- Task comment объясняет, что изменилось
- Изменённые файлы совпадают со scope задачи
- Verification result виден в task comment или logs
Дальше
- Создание команды — рекомендованные структуры и написание brief
- Настройка рантайма — авторизация провайдеров и выбор моделей
- Код-ревью — ревью, одобрение и запрос правок