Oz — оркестрация облачных AI-агентов: полное руководство по сценариям использования

Oz — платформа оркестрации облачных AI-агентов от Warp. Запускает, координирует и отслеживает десятки агентов параллельно — из терминала, веб-интерфейса, Slack, Linear или по расписанию. Работает с Warp Agent, Claude Code и OpenAI Codex.

• Официальный сайт: warp.dev/oz
• Веб-приложение: oz.warp.dev
• Документация: docs.warp.dev/agent-platform

Что такое Oz и зачем он нужен

Oz — это слой оркестрации поверх Warp. Если Warp — это терминал, в котором вы работаете с одним агентом интерактивно, то Oz — это платформа, которая позволяет:

• запускать агентов в облаке, не занимая локальную машину;
• координировать десятки агентов параллельно — каждый в изолированном Docker-контейнере;
• запускать агентов по триггерам — из Slack, Linear, GitHub Actions, по расписанию или через API;
• наблюдать за каждым запуском: логи, транскрипты сессий, статусы, артефакты;
• передавать контекст между локальными и облачными сессиями без потери истории.

2025-й был годом интерактивных агентов. 2026-й — год оркестрации. Oz появился ровно в этой точке.

Архитектура платформы

flowchart TB
    subgraph Triggers["Триггеры"]
        SL["Slack"]
        LN["Linear"]
        GH["GitHub Actions"]
        CR["Cron / Расписание"]
        CLI["Oz CLI"]
        API["Oz API / SDK"]
        WEB["Oz Web App"]
    end

    subgraph ControlPlane["Control Plane"]
        ORCH["Оркестратор"]
        SCHED["Планировщик"]
        AUTH["Права и секреты"]
        OBS["Наблюдаемость"]
    end

    subgraph Execution["Execution Layer"]
        ENV1["Environment 1"]
        ENV2["Environment 2"]
        ENV3["Environment N"]
    end

    subgraph Agents["Агенты"]
        WA["Warp Agent"]
        CC["Claude Code"]
        CX["Codex"]
    end

    Triggers --> ControlPlane
    ControlPlane --> Execution
    Execution --> Agents

Каждый запуск агента в Oz — это задача (task). Задача включает:

• Промпт и контекст — текст запроса плюс данные из триггера (Slack-тред, Linear-issue, PR-метаданные).
• Environment — Docker-образ, репозитории, команды подготовки.
• Жизненный цикл — created → running → completed / failed.
• Транскрипт и артефакты — полная запись того, что агент делал.

Ключевые компоненты

Сценарии использования

Oz решает три класса задач: реактивные (агент реагирует на событие), проактивные (агент работает по расписанию) и оркестрационные (несколько агентов координируются).

Реактивные сценарии

Самый частый сценарий. Разработчик тегает @Oz в Slack-треде с описанием бага. Oz:

1. Читает весь тред и прикреплённые логи.
2. Поднимает Docker-контейнер с нужным репозиторием.
3. Воспроизводит проблему, находит причину.
4. Открывает PR с фиксом.
5. Постит результат обратно в тред.

Тегаете @Oz на issue в Linear. Агент читает описание задачи, берёт контекст из прикреплённых документов и создаёт PR. Прогресс виден прямо в комментариях к issue.

В CI-пайплайне при падении тестов или линтера запускается Oz-агент. Он анализирует логи, находит причину и открывает PR с фиксом. Разработчик просыпается утром и видит готовый PR, а не красный CI.

Вы работаете с агентом в терминале. Задача оказалась объёмной — нужно 40 минут на рефакторинг. Командой handoff вы передаёте сессию в облако:

• контекст, история диалога и артефакты переносятся автоматически;
• вы закрываете ноутбук;
• агент продолжает работу в Docker-контейнере;
• когда он закончит, вы подключаетесь из терминала, веба или телефона и проверяете результат.

Проактивные сценарии (по расписанию)

oz schedule create \
  --name "Weekly Dead Code Cleanup" \
  --cron "0 10 * * 1" \
  --environment <ENV_ID> \
  --prompt "Scan for dead code, unused imports, and stale feature flags. Open a PR with removals."

Каждый понедельник в 10:00 агент сканирует кодовую базу, находит неиспользуемый код и открывает PR с предложением удалить.

Агент проверяет package.json, requirements.txt или Cargo.toml на наличие security-обновлений. Если находит — обновляет, прогоняет тесты, открывает PR.

Каждое утро агент просматривает открытые GitHub Issues, классифицирует по приоритету и серьёзности, добавляет лейблы и присваивает ответственных по заданным правилам.

Раз в неделю агент проверяет, соответствует ли README и API-документация текущему состоянию кода. Если находит расхождения — обновляет и открывает PR.

Оркестрационные сценарии (multi-agent)

Warp Agent выступает супервизором: декомпозирует большую задачу на подзадачи и распределяет их между Claude Code и Codex агентами, каждый из которых работает параллельно в отдельном контейнере.

Пример: миграция монолита на микросервисы. Супервизор делит работу по сервисам, каждый worker-агент мигрирует свой сервис.

Одна задача раздаётся N агентам параллельно. Каждый обрабатывает свой фрагмент (файл, модуль, сервис). Результаты собираются в один PR.

Пример: обновление 50 микросервисов на новую версию SDK. Каждый агент берёт один сервис, обновляет, прогоняет тесты. Все 50 PR готовы через 30 минут.

Один агент пишет код, второй — ревьюит. Если находит проблемы, отправляет замечания первому. Цикл повторяется, пока код не пройдёт проверку.

Агент вносит согласованные изменения в несколько репозиториев одновременно: обновляет контракт в API-сервисе, адаптирует клиентскую библиотеку и обновляет документацию.

Специализированные сценарии

Настройте интеграцию с GitHub — каждый PR автоматически проходит через Oz-агента, который проверяет type safety, обработку ошибок, соответствие код-стайлу и потенциальные баги.

После мержа PR агент анализирует изменения и генерирует юнит-тесты для нового кода. Открывает PR с тестами, прогоняет их.

Переезд с одного фреймворка на другой (React → Next.js, Express → Fastify). Агент обрабатывает файл за файлом, сохраняя логику и адаптируя синтаксис.

Оповещение из мониторинга (PagerDuty, Datadog) триггерит Oz-агента. Он анализирует логи, находит причину, предлагает или применяет фикс, отписывается в инцидент-канал.

Оз получает спецификацию проекта и создаёт полное приложение: структуру, код, конфигурацию, тесты, CI/CD. Всё в изолированном Docker-контейнере, результат — готовый репозиторий.

Environments: настройка среды выполнения

Environment — фундамент облачного запуска. Без него Oz не знает, в какой среде запускать агента.

Что определяет Environment

• Docker-образ (обязательно) — toolchain и runtime. Можно использовать стандартные (node:22, python:3.12) или кастомные. Warp также предлагает готовые dev-образы.
• Репозитории — один или несколько Git-репозиториев, которые клонируются в контейнер.
• Setup-команды — npm ci, pip install -r requirements.txt, сборка, миграции.

Быстрая настройка

Самый простой путь — команда /create-environment в Warp:

# Из директории проекта
/create-environment

# Или с указанием репозиториев
/create-environment ./frontend ./backend

# Или по URL
/create-environment https://github.com/your-org/api.git

Warp автоматически определит языки, фреймворки, подберёт Docker-образ и предложит setup-команды.

Настройка через CLI

oz environment create \
  --name "My Project" \
  --docker-image node:22 \
  --repo your-org/frontend \
  --repo your-org/backend \
  --setup-command "cd frontend && npm ci" \
  --setup-command "cd backend && pip install -r requirements.txt"

Управление

# Список environments
oz environment list

# Детали
oz environment get <ENV_ID>

# Обновить образ
oz environment update <ENV_ID> --docker-image node:22

# Добавить репозиторий
oz environment update <ENV_ID> --repo your-org/new-service

# Удалить
oz environment delete <ENV_ID>

Skills: переиспользуемые workflow

Skill — это набор инструкций, который определяет, что агент делает. Environment определяет где, Skill — что.

Зачем нужны Skills

• Повторяемость — один Skill даёт одинаковый результат, кто бы его ни запускал.
• Автоматизация — привяжите Skill к расписанию и получите регулярную автоматику.
• Командная работа — Skills живут в репозитории, можно версионировать и ревьюить.

Как создать Skill

Положите файл в .warp/skills/ вашего репозитория:

<!-- .warp/skills/dead-code-cleanup.md -->
# Dead Code Cleanup

Scan the codebase for:
- Unused imports
- Dead functions (not called anywhere)
- Stale feature flags
- Commented-out code blocks older than 30 days

For each finding, remove the dead code and open a single PR
with a clear description of what was removed and why.

Warp автоматически обнаруживает Skills из директорий:

.warp/skills/, .agents/skills/, .claude/skills/, .codex/skills/, .cursor/skills/, .gemini/skills/, .copilot/skills/, .factory/skills/, .github/skills/, .opencode/skills/

Запуск Skill

# Локально
oz agent run --skill "your-org/repo:dead-code-cleanup"

# В облаке
oz agent run-cloud \
  --environment <ENV_ID> \
  --skill "your-org/repo:dead-code-cleanup" \
  --prompt "Focus on the /src/legacy directory"

Skill + расписание

oz schedule create \
  --name "Weekly Dead Code" \
  --cron "0 10 * * 1" \
  --environment <ENV_ID> \
  --skill "your-org/repo:dead-code-cleanup"

Warp также предлагает готовые Skills в публичном репозитории warpdotdev/oz-skills — можно использовать как отправную точку.

Интеграции

Slack

Настройка:

# Создать интеграцию
oz integration create slack --environment <ENV_ID>

Использование:

• Тегните @Oz в сообщении или треде.
• Или напишите боту в личные сообщения.

Oz читает контекст треда, поднимает Environment, выполняет задачу, постит результат обратно.

Linear

oz integration create linear --environment <ENV_ID>

Тегните @Oz на issue — агент прочитает описание, возьмёт задачу в работу и опубликует PR.

GitHub Actions

Запуск Oz-агентов из CI-пайплайна. Упал билд — агент автоматически получает логи и пытается починить.

Веб-приложение и мобильный доступ

oz.warp.dev — полнофункциональный веб-интерфейс, который работает и на мобильных устройствах. Можно:

• запускать агентов;
• управлять расписаниями;
• просматривать Skills;
• подключаться к работающим сессиям;
• настраивать Environments и интеграции.

Multi-agent оркестрация: паттерны

Oz поддерживает несколько архитектурных паттернов для координации нескольких агентов.

Выбор harness для задачи

Oz работает с тремя harness'ами (движками агентов):

CLI: основные команды

Запуск агентов

# Локальный запуск
oz agent run --prompt "Fix the failing test in src/auth"

# Облачный запуск
oz agent run-cloud \
  --environment <ENV_ID> \
  --prompt "Refactor the payment module"

# С указанием Skill
oz agent run-cloud \
  --environment <ENV_ID> \
  --skill "your-org/repo:skill-name" \
  --prompt "Additional context"

Управление расписаниями

# Создать
oz schedule create \
  --name "Daily Dep Update" \
  --cron "0 8 * * *" \
  --environment <ENV_ID> \
  --prompt "Check for dependency security updates"

# Список
oz schedule list

# Удалить
oz schedule delete <SCHEDULE_ID>

Управление интеграциями

# Создать Slack-интеграцию
oz integration create slack --environment <ENV_ID>

# Создать Linear-интеграцию
oz integration create linear --environment <ENV_ID>

API и SDK

Oz предоставляет REST API для программного управления:

{
  "prompt": "Migrate auth module to OAuth 2.1",
  "config": {
    "environment_id": "<ENV_ID>",
    "skill_spec": "your-org/repo:oauth-migration"
  }
}

Через API можно:

• создавать и запускать задачи;
• получать статусы и результаты;
• строить внутренние дашборды мониторинга.

Shared Data Plane: общий контекст для всех агентов

Одно из ключевых преимуществ Oz — все агенты (независимо от harness) работают с общим слоем данных:

• Транскрипты сессий — полная история взаимодействия.
• Артефакты — файлы, PR, результаты.
• Skills — переиспользуемые инструкции.
• Rules — командные конвенции.
• Agent Memory — персистентная память, которая накапливается между сессиями.

Это значит, что Claude Code может продолжить работу, начатую Warp Agent, без потери контекста. А память об ошибках одного агента автоматически доступна всем остальным.

Безопасность и соответствие

Hosting: где выполняются агенты

Self-hosting работает в двух режимах:

• Managed worker — daemon на вашей машине, Oz оркестрирует агентов в Docker-контейнерах.
• Unmanaged — вы запускаете oz agent run напрямую в вашем CI, Kubernetes или dev-окружении.

Тарифы и требования

Быстрый старт: от нуля до первого облачного агента за 10 минут

1. Установите Warp — warp.dev
2. Создайте Environment:

/create-environment

1. Подключите GitHub — Warp предложит установить GitHub App при создании Environment.
2. Запустите агента в облаке:

oz agent run-cloud \
  --environment <ENV_ID> \
  --prompt "List all TODO comments in the codebase and create GitHub issues for each"

1. Подключите Slack (опционально):

oz integration create slack --environment <ENV_ID>

Чеклист: когда использовать Oz

Oz — правильный выбор, если совпадают хотя бы два пункта:

Ссылки

• Сайт Oz: warp.dev/oz
• Веб-приложение: oz.warp.dev
• Документация: docs.warp.dev/agent-platform
• Публичные Skills: github.com/warpdotdev/oz-skills
• Dev-образы Warp: github.com/warpdotdev (images)
• Changelog: docs.warp.dev/changelog

По теме

• Статья: AI Native без шаманства: как строить ИИ-системы, которые реально работают
• Блог: Warp стал open-source — и предлагает строить терминал будущего вместе с агентами
• База знаний: Warp — терминал с AI-агентами для разработчиков

Если вы уже используете Warp и хотите понять, какие рабочие процессы перевести на Oz-оркестрацию — пишите в Telegram @pimenov