Oz — веб-приложение Warp и его API/SDK для запуска и управления облачными агентами. Через него можно настраивать среды выполнения, сохранять конфигурации агентов, создавать расписания, подключать внешние интеграции и просматривать результаты запусков.
Откройте веб-приложение Oz, чтобы проверить доступ своей команды. Справочник веб-приложения описывает разделы и условия запуска.
Что Oz даёт команде
Oz объединяет несколько способов работы с облачными агентами:
- запуск из браузера, командной строки (
CLI), API, расписания или интеграции; - повторяемую среду с нужными репозиториями и инструментами;
- сохранённые конфигурации агентов с промптом, навыками, движком агента (
harness), моделью, средой и секретами; - централизованный список запусков со статусами, транскриптами и артефактами;
- просмотр родительских и дочерних запусков при многоагентной оркестрации.
Для локального интерактивного запуска отдельная среда не нужна: агент использует текущий checkout и настройки компьютера. Среда требуется для типового удалённого запуска, которому нужен воспроизводимый набор зависимостей. У самостоятельно размещённых исполнителей возможны отдельные конфигурации образа; не переносите их настройки на обычный облачный запуск.
Для новых многоэтапных процессов Warp рекомендует Warp Factories в раннем доступе. Там работа распределяется по стадиям планирования, реализации и проверки; система не выполняет слияние вместо человека. Oz CLI остаётся поддерживаемым прежним интерфейсом, и текущая документация не требует немедленной миграции существующих процессов.
В облаке можно выбирать Warp Agent либо поддерживаемые сторонние движки Claude Code и Codex. У стороннего движка собственная авторизация и оплата модели; окружение, секреты, наблюдение и расходы платформы Warp учитываются отдельно. Разрешения и запросы подтверждений также проверяйте для выбранного движка. Документация движков.
Основные разделы веб-приложения
| Раздел | Что в нём доступно |
| Runs | Все запуски, фильтры и поиск, статусы, транскрипты, артефакты и стоимость или расход договорных кредитов |
| Agents | Сохранённые агенты: промпт, навыки, движок агента, модель, среда и секреты |
| Skills | Переиспользуемые инструкции из подключённых репозиториев и запуск агентов с выбранным навыком |
| Schedules | Создание и управление запусками по cron-расписанию, приостановка и возобновление, история запусков |
| Environments | Docker-образы, репозитории и команды подготовки среды |
| Secrets | Секреты, которыми управляет Warp и которые передаются облачным агентам во время выполнения |
| Integrations | Подключение Slack, Linear и GitHub как источников задач |
Веб-приложение работает на мобильных устройствах. Для скриптов, автоматизации и CI/CD-процессов Warp рекомендует CLI либо API.
Как устроена среда выполнения
Среда выполнения описывает, как агент выполняет задачу. Инструкции агента и контекст конкретного запуска задаются отдельно.
В среду могут входить:
- Docker-образ с инструментами и зависимостями;
- один или несколько Git-репозиториев;
- команды подготовки среды (
setup commands) для установки зависимостей, сборки или генерации кода; - переменные окружения;
- Agent Secrets, которые настраиваются отдельно и внедряются во время запуска.
Настройки окружения создают свежую рабочую область для каждого обычного запуска. Облачные агенты работают в контейнере от имени пользователя без root-прав, поэтому образ и команды подготовки среды должны учитывать ограничения доступа.
Создание среды в браузере
- Откройте раздел Environments и нажмите New environment.
- Укажите понятное имя.
- Выберите репозитории, доступные агенту.
- Выберите готовый dev-образ Warp, официальный Docker-образ или собственный образ.
- Добавьте команды подготовки среды, например
npm install. - Нажмите Create environment.
Успешный результат: новая среда появилась в списке, а в её карточке видны выбранный образ, репозитории и команды подготовки среды.
Первый запуск через Oz web app
- Откройте страницу Runs.
- Нажмите New run.
- Выберите Quick run для запуска от своего имени либо сохранённого агента.
- Укажите среду выполнения.
- Добавьте промпт с задачей и контекстом.
- Запустите агента и откройте созданную запись.
В карточке запуска можно проверить статус, среду, источник, создателя, артефакты, стоимость или расход договорных кредитов и полный транскрипт. Среди отображаемых состояний есть 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.
Расход зависит от модели, токенов, контекста, инструментов, длительности и кэша. Ограничьте расходы и проверьте автоматическое пополнение до включения расписаний; фиксированная цена задачи не гарантирована.
Чеклист проверки запуска
run_id.succeeded в интерфейсе или SUCCEEDED в API.Когда Oz подходит
Oz полезен, если задаче нужны удалённое выполнение, повторяемая среда, внешний триггер, расписание, программный API или единое место для наблюдения за агентами. Для короткой интерактивной работы в уже настроенном локальном checkout достаточно локального агента без среды выполнения.
Следующий шаг
Warp — терминал с AI-агентами для разработчиков
Если вы выбираете процессы для переноса в облачных агентов, полезно отдельно обсудить границы доступа, проверку результата и бюджет автоматизации.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov


