Oz — веб-приложение Warp и его API/SDK для запуска и управления облачными агентами. Через него можно настраивать среды выполнения, сохранять конфигурации агентов, создавать расписания, подключать внешние интеграции и просматривать результаты запусков.

📌
Область этого руководства. Общий справочник по Warp находится здесь. Ниже рассматривается именно Oz и Automation Platform. Материал актуализирован 24 октября 2026 года по официальной документации Warp и не основан на личном тестировании.

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


Что Oz даёт команде

Oz объединяет несколько способов работы с облачными агентами:

  • запуск из браузера, командной строки (CLI), API, расписания или интеграции;
  • повторяемую среду с нужными репозиториями и инструментами;
  • сохранённые конфигурации агентов с промптом, навыками, движком агента (harness), моделью, средой и секретами;
  • централизованный список запусков со статусами, транскриптами и артефактами;
  • просмотр родительских и дочерних запусков при многоагентной оркестрации.

Для локального интерактивного запуска отдельная среда не нужна: агент использует текущий checkout и настройки компьютера. Среда требуется для типового удалённого запуска, которому нужен воспроизводимый набор зависимостей. У самостоятельно размещённых исполнителей возможны отдельные конфигурации образа; не переносите их настройки на обычный облачный запуск.

Для новых многоэтапных процессов Warp рекомендует Warp Factories в раннем доступе. Там работа распределяется по стадиям планирования, реализации и проверки; система не выполняет слияние вместо человека. Oz CLI остаётся поддерживаемым прежним интерфейсом, и текущая документация не требует немедленной миграции существующих процессов.

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

Основные разделы веб-приложения

РазделЧто в нём доступно
RunsВсе запуски, фильтры и поиск, статусы, транскрипты, артефакты и стоимость или расход договорных кредитов
AgentsСохранённые агенты: промпт, навыки, движок агента, модель, среда и секреты
SkillsПереиспользуемые инструкции из подключённых репозиториев и запуск агентов с выбранным навыком
SchedulesСоздание и управление запусками по cron-расписанию, приостановка и возобновление, история запусков
EnvironmentsDocker-образы, репозитории и команды подготовки среды
SecretsСекреты, которыми управляет Warp и которые передаются облачным агентам во время выполнения
IntegrationsПодключение Slack, Linear и GitHub как источников задач

Веб-приложение работает на мобильных устройствах. Для скриптов, автоматизации и CI/CD-процессов Warp рекомендует CLI либо API.

Как устроена среда выполнения

Среда выполнения описывает, как агент выполняет задачу. Инструкции агента и контекст конкретного запуска задаются отдельно.

В среду могут входить:

  • Docker-образ с инструментами и зависимостями;
  • один или несколько Git-репозиториев;
  • команды подготовки среды (setup commands) для установки зависимостей, сборки или генерации кода;
  • переменные окружения;
  • Agent Secrets, которые настраиваются отдельно и внедряются во время запуска.

Настройки окружения создают свежую рабочую область для каждого обычного запуска. Облачные агенты работают в контейнере от имени пользователя без root-прав, поэтому образ и команды подготовки среды должны учитывать ограничения доступа.

💡
Практический принцип: используйте общую среду для запусков, которым нужны одинаковые версии языка, системные пакеты, репозитории и команды подготовки. Это уменьшает различия между расписанием, интеграциями и ручными запусками.

Создание среды в браузере

  1. Откройте раздел Environments и нажмите New environment.
  2. Укажите понятное имя.
  3. Выберите репозитории, доступные агенту.
  4. Выберите готовый dev-образ Warp, официальный Docker-образ или собственный образ.
  5. Добавьте команды подготовки среды, например npm install.
  6. Нажмите Create environment.

Успешный результат: новая среда появилась в списке, а в её карточке видны выбранный образ, репозитории и команды подготовки среды.

Первый запуск через Oz web app

  1. Откройте страницу Runs.
  2. Нажмите New run.
  3. Выберите Quick run для запуска от своего имени либо сохранённого агента.
  4. Укажите среду выполнения.
  5. Добавьте промпт с задачей и контекстом.
  6. Запустите агента и откройте созданную запись.

В карточке запуска можно проверить статус, среду, источник, создателя, артефакты, стоимость или расход договорных кредитов и полный транскрипт. Среди отображаемых состояний есть working, succeeded, failed, canceled, errored и blocked.

Сохранённые агенты и Skills

Сохранённый агент — конфигурация облачного агента для повторяющихся задач. Она может содержать имя, описание, базовый промпт, навыки, движок агента (harness), модель, среду и секреты. Дополнительный промпт конкретного запуска дополняет эти настройки.

Skill — переиспользуемый набор инструкций в репозитории. В Oz можно:

  • просматривать навыки из репозиториев подключённых сред;
  • прикреплять один или несколько навыков к агенту;
  • запускать агент непосредственно из карточки навыка;
  • создать навык через веб-интерфейс и открыть PR с добавлением SKILL.md в выбранный репозиторий.

Навык появится в Oz после слияния PR и обновления списка Skills.

Запуск через REST API

Для API нужны два предварительных условия:

  • ключ Warp API (Warp API key), созданный в Oz web app;
  • облачная среда с репозиториями и зависимостями.

Храните ключ в переменной окружения и не вставляйте его в код или репозиторий:

export WARP_API_KEY="wk-..."

Создайте асинхронный запуск через POST /agent/runs. Путь во множественном числе соответствует официальному примеру API:

curl -X POST https://app.warp.dev/api/v1/agent/runs \
  -H "Authorization: Bearer $WARP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Scan the repo for outdated dependencies and summarize the findings.",
    "config": {
      "environment_id": "<ENV_ID>"
    }
  }'

Ответ должен содержать run_id. Проверьте состояние запуска:

curl "https://app.warp.dev/api/v1/agent/runs/<RUN_ID>" \
  -H "Authorization: Bearer $WARP_API_KEY"

Основные состояния API:

  • QUEUED — запуск ожидает выполнения;
  • INPROGRESS — агент работает;
  • SUCCEEDED — задача завершена;
  • FAILED — произошла ошибка; подробности следует искать в status_message.

Это наиболее распространённые состояния. Полный список приведён в справочнике API.

Чтобы получить список последних запусков, выполните:

curl "https://app.warp.dev/api/v1/agent/runs" \
  -H "Authorization: Bearer $WARP_API_KEY"

После перехода запуска в состояние SUCCEEDED ответ содержит session_link со ссылкой на полный транскрипт, выполненные команды, изменённые файлы и вывод агента. Для Python доступен пакет warp-platform-sdk, для TypeScript — @warp-dot-dev/warp-platform-sdk. Успешный статус означает завершение запуска, но не доказывает корректность изменений: отдельно проверьте дифф, тесты и артефакты. Не повторяйте POST вслепую при потерянном ответе — сначала проверьте список запусков, чтобы не создать платную задачу повторно.

Интеграции и расписания

Slack, Linear и GitHub

Актуальные официальные интеграции используют разные упоминания:

  • в Slack агент запускается упоминанием @warp в сообщении или треде;
  • в Linear — упоминанием @warp в issue;
  • в GitHub — упоминанием @warp-agent в issue, pull request или review-комментарии.

Для Slack и Linear Oz предлагает пошаговое подключение с авторизацией и выбором среды. GitHub настраивается иначе: администратор команды подключает Warp Factories GitHub App через Admin Panel. После того как установка связана с командой, в Oz выбираются среда, модель, агент, промпт и секреты для запусков из GitHub.

Запуски по расписанию

В разделе Schedules можно указать имя, расписание в формате cron, среду, сохранённого агента и промпт. Расписание разрешается редактировать, приостанавливать, снова включать и удалять; в его карточке доступна история запусков.

Полезные сценарии

Реакция на задачу из рабочего трекера

Задача: передать агенту issue без ручного копирования контекста.

Как использовать: подключите Linear или GitHub, выберите среду с нужным репозиторием и упомяните агента: @warp в Linear или @warp-agent в GitHub.

Проверка: новый запуск появился на странице Runs с соответствующим источником; в его карточке доступны статус и транскрипт.

Ограничение: доступный контекст и права зависят от настроек интеграции и выбранной конфигурации.

Регулярная проверка репозитория

Задача: запускать аудит зависимостей или документации по расписанию.

Как использовать: создайте сохранённого агента либо подготовьте промпт, затем настройте cron-расписание и среду.

Проверка: в карточке расписания отображаются следующий запуск и история выполнений; созданные запуски видны в Runs.

Ограничение: стоимость может различаться даже у похожих запусков; на договорном плане учитывайте также единицы кредита.

Агент как часть внутреннего сервиса

Задача: запускать обработку из backend-приложения, вебхука (webhook) или CI/CD.

Как использовать: отправьте запрос к REST API, сохраните run_id, опрашивайте состояние и после завершения заберите session_link.

Проверка: состояние меняется с QUEUED или INPROGRESS на SUCCEEDED; при ошибке API возвращает FAILED и пояснение в status_message.

Ограничение: API-запуск асинхронный, поэтому вызывающая система должна хранить идентификатор и обрабатывать ожидание, ошибки и повторные запросы.

Наблюдение за многоагентными запусками

Oz показывает оркестрацию как вложенные родительские и дочерние строки на странице Runs. У родительского запуска появляется вкладка Sub-agents, где видны названия и состояния дочерних агентов.

Статус родителя описывает его собственную работу и не заменяет статусы дочерних запусков. Для проверки конкретного исполнителя откройте соответствующую дочернюю строку.

По журналу изменений последний указанный на дату проверки выпуск — v0.2026.10.14.08.27 от 15 октября 2026 года. В сентябре–октябре добавлены снимки рабочего пространства для передачи и восстановления задачи, выбор исполнителя окружения через oz environment update --default-runner <RUNNER_UID>, уточнённые сообщения об ошибках подготовки и исправления зависающих MCP-вызовов.

Если запуск получил blocked, проверьте запрос к человеку, а не ждите бесконечно. При восстановлении после выхода оболочки сопоставьте снимок, рабочую копию и последний выполненный шаг; не считайте повторный запуск гарантией отсутствия побочных действий.

Кредиты и ограничения

По состоянию на 24 октября 2026 года правила оплаты Warp разделяют три составляющие:

  • Модель: обращения к языковой модели; при собственном ключе их оплачивают выбранному провайдеру.
  • Вычисления: инфраструктура Warp, где работает облачный агент. Локальный компьютер и собственный исполнитель не используют вычислительный объём Warp.
  • Платформа: организация облачных запусков, интеграции, API и наблюдение. Она может оплачиваться и при стороннем движке или собственном исполнителе. У Business и Enterprise отдельные локальные сценарии со своей моделью также могут включать платформенную составляющую — проверяйте условия именно своего плана.

На самообслуживаемых планах использование отображается в долларах, а у Enterprise могут действовать договорные кредиты. Не смешивайте новые денежные лимиты с прежними числами AI credits. Даже если в карточке запуска нет стоимости внешней модели, это не означает отсутствие счёта у её провайдера.

На странице тарифов Build включает $20 использования в месяц, Max — $200, Business — $20 на место. Подписка и цена дополнительного использования — разные величины. Включённый объём обновляется каждый месяц даже при годовой оплате и не переносится; дополнительный баланс команды имеет собственные условия срока действия.

По умолчанию расписание использует подходящий баланс своего создателя. Запуск от сохранённого агента может относиться к общему использованию команды. Не предполагайте, что любую задачу по расписанию оплачивает владелец команды: проверьте идентичность запуска, баланс и лимиты в Settings → Billing and usage.

Расход зависит от модели, токенов, контекста, инструментов, длительности и кэша. Ограничьте расходы и проверьте автоматическое пополнение до включения расписаний; фиксированная цена задачи не гарантирована.

Чеклист проверки запуска

Запуск появился на странице Runs или API вернул run_id.
В карточке указана ожидаемая среда и правильный источник запуска.
Команды подготовки среды завершились без ошибки.
Статус достиг succeeded в интерфейсе или SUCCEEDED в API.
Транскрипт соответствует поставленной задаче.
Ожидаемые файлы или PR перечислены среди артефактов.
Для оркестрации отдельно проверены дочерние агенты.
Стоимость запуска или расход договорных кредитов укладывается в установленный бюджет.

Когда Oz подходит

Oz полезен, если задаче нужны удалённое выполнение, повторяемая среда, внешний триггер, расписание, программный API или единое место для наблюдения за агентами. Для короткой интерактивной работы в уже настроенном локальном checkout достаточно локального агента без среды выполнения.

Следующий шаг

Warp — терминал с AI-агентами для разработчиков

Если вы выбираете процессы для переноса в облачных агентов, полезно отдельно обсудить границы доступа, проверку результата и бюджет автоматизации.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov