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

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

• Веб-приложение: oz.warp.dev
• Документация платформы: docs.warp.dev/platform
• API и SDK: docs.warp.dev/reference/api-and-sdk

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

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

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

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

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

Веб-приложение работает на мобильных устройствах. Для скриптов, автоматизации и 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-..."

Создайте асинхронный запуск:

curl -X POST https://app.warp.dev/api/v1/agent/run \
  -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 и TypeScript доступны официальные SDK с типизированными моделями, повторными попытками и обработкой ошибок.

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

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, где видны названия и состояния дочерних агентов.

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

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

В справке Warp, обновлённой 4 сентября 2026 года, описаны три вида кредитов:

• AI credits — обращения к моделям, когда Warp оплачивает вызов через управляемых провайдеров;
• compute credits — вычисления в инфраструктуре Warp, на которой работает агент;
• platform credits — жизненный цикл запусков, интеграции, dashboard, API и наблюдаемость.

Все три вида учитываются в общем пуле кредитов Warp и дополнительных кредитах (add-on credits), поэтому общий баланс проверяется в Settings → Billing and usage.

Все облачные запуски используют platform credits. Запуски на инфраструктуре Warp (Warp-hosted workers) также расходуют compute credits. Локальные агенты используют компьютер пользователя и не расходуют compute credits. Облачные запуски на собственных воркерах (self-hosted workers) не расходуют compute credits, но продолжают использовать platform credits.

Расход недетерминирован и зависит от модели, числа токенов, размера контекста, количества вызовов инструментов, сложности задачи и попаданий в кэш промптов. Slack и Linear требуют членства в команде, тогда как индивидуальные пользователи могут запускать облачных агентов через CLI и API.

Актуальный расход и остаток проверяйте в Settings → Billing and usage. Фиксированного числа кредитов для конкретной задачи официальная документация не обещает.

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

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

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

Официальные источники

• Oz web app for cloud agents
• Cloud agent environments
• API & SDK quickstart
• Warp credits and billing
• Changelog

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

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

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

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