Облачные агенты

Облачный агент — это Lovely Agent, приложение ИИ-агента, работающее в собственной песочнице. Он общается с Claude, GPT или Gemini, выполняет команды, пишет код, редактирует файлы и использует инструменты данных и браузерного агента Lovely Router. Каждый агент сохраняет свои файлы, сессии и настройки между запусками. Агентов может быть много — по одному на проект или на каждого пользователя вашего продукта, — и к каждому можно обращаться в браузере или через API.

1. 1

   Создайте агента

   В разделе Облачные агенты выберите Новый агент или вызовите POST /v1/agents. Дайте ему имя, а если он обслуживает одного из ваших пользователей — ваш собственный id этого пользователя.

2. 2

   Работайте с ним

   Выберите Начать, затем Открыть: Lovely Agent откроется по собственному адресу агента (agent.lovelyrouter.com/a/<agent id>/) с уже выполненным входом. Или отправляйте ему задачи через POST /v1/agents/{id}/runs. Остановленный агент просыпается сам, когда приходит запуск или кто-то открывает его страницу, если только вы не отключили это.

3. 3

   Остановите его или дайте ему остановиться самому

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

Что внутри#

• Lovely Agent с веб-интерфейсом: чат, сессии, режим планирования, субагенты, навыки, задачи по расписанию, плагины и терминал.
• Модели: все чат-модели, которые продаёт Lovely Router, уже настроены. По умолчанию используется Claude Haiku 5.5, самая недорогая; выберите другую для каждого агента в настройках или переключайте модели внутри агента. На его странице Models можно также добавить собственных провайдеров моделей.
• Инструменты: инструменты данных и браузерный агент доступны как MCP-инструменты (mcp__tools__*), поэтому агент может искать в интернете, одним вызовом получать структурированные данные с платформ вроде YouTube, Reddit, Google Maps или Amazon (ему предписано предпочитать эти инструменты самостоятельному парсингу сайтов), создавать изображения или управлять браузером. Собственные MCP-серверы добавляются в настройках.
• Linux-песочница: Node.js 22, Python 3, git, инструменты сборки и ripgrep, с доступом в интернет. Внутри неё у агента полный доступ, за её пределами — никакого.

Цены#

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

Песочница оплачивается каждую минуту, пока агент работает, с момента старта до остановки. Общие vCPU работают на полной скорости при кратковременных всплесках, например при установке пакетов и сборке, и с более низкой базовой долей при длительной нагрузке на CPU; за всплески дополнительная плата не взимается. Для старта нужен баланс, покрывающий не меньше 15 минут работы выбранного размера (минимум $0.25). Когда баланс уходит ниже нуля, ваши агенты останавливаются и вам приходит письмо: если не пополнить баланс в течение 24 часов, их рабочие пространства удаляются.

Между сессиями агент держится наготове, поэтому следующий старт занимает несколько секунд, а агент продолжает с того места, где остановился. Его диск начинается с 1 ГБ и увеличивается на 1 ГБ каждый раз, когда заполнен на 80% (до 20 ГБ), так что новый агент в режиме готовности стоит около $0.66 в месяц. Агент, не использовавшийся 7 дней, архивируется: оплачиваются только его файлы, а следующий старт занимает на несколько секунд дольше.

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

Агенты под вашим брендом (white label), которые показывают пользователям ваш собственный брендинг, стоят в 1,5 раза дороже этих тарифов на песочницу (Маленький — $0.075 в час); цены на модели и инструменты не меняются.

Настройки#

У каждого агента свои настройки — в консоли или через PATCH /v1/agents/{id}. Они применяются со следующего старта.

• Модель по умолчанию: LLM, с которой начинаются новые сессии. По умолчанию — Claude Haiku 5.5.
• Инструменты данных и браузерный агент: включены по умолчанию. Отключите их для агента, который только пишет код и общается.
• Дополнительные инструменты (MCP-серверы): до 8 удалённых MCP-серверов (streamable HTTP), у каждого имя, URL https:// и необязательный заголовок, например Authorization: Bearer …. Значения заголовков хранятся в зашифрованном виде и больше никогда не показываются.
• Инструкции: до 4 000 символов, которые добавляются в каждую сессию, например ваши соглашения о стиле кода.
• Размер, Останавливать при простое (от 5 минут до 24 часов, по умолчанию 30 минут) и Самая длинная сессия (от 1 до 24 часов, по умолчанию 8 часов).
• Просыпаться при вызове (включено по умолчанию): остановленный агент стартует сам, когда приходит API-запуск, когда вы его открываете или когда кто-то открывает его страницу. Каждое пробуждение — обычная сессия, оплачиваемая как обычно. Сессия, используемая через API, останавливается примерно через 5 секунд после окончания последнего запуска, независимо от того, разбудил ли агента запуск или он уже работал; если же в сессии кто-то воспользовался страницей агента, эта сессия останавливается при простое (Останавливать при простое, по умолчанию 30 минут). Чтобы агент продолжал работать между API-вызовами, передайте с запуском stop_when_done: false. Отключите эту настройку, чтобы запускать агента только самостоятельно, из консоли или через POST /v1/agents/{id}/start; запуски и посещения страницы вашими пользователями тогда будут заставать его остановленным. Эта настройка применяется сразу.

Агент считается используемым, пока кто-то работает с его страницей, пока он вызывает модели или инструменты, пока выполняется запуск или пока занят его CPU (сборка или долгая команда). Одна лишь открытая вкладка не считается.

Агенты для ваших пользователей#

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

1. Создайте агента для каждого пользователя с вашим собственным id для него: {"user": "cust-42"}, плюс любые metadata. Агентов пользователя можно получить через GET /v1/agents?user=cust-42.
2. Выдайте пользователю токен агента вместо своего API-ключа (POST /v1/agents/{id}/tokens). Он даёт доступ только к одному агенту и истекает сам (от 1 минуты до 30 дней):
   • scope api: ваш пользователь (или ваш бэкенд от его имени) отправляет задачи через запуски агента и читает его статус. Используйте этот вариант, если пользователям не нужно видеть веб-страницу;
   • scope ui: поставляется со ссылкой, которая открывает веб-страницу агента с выполненным входом.

   При включённой настройке Просыпаться при вызове запуск или посещение вашего пользователя стартует остановленного агента; другого способа запустить его у пользователя нет.

3. Задайте бюджет для каждого агента, чтобы ограничить, сколько может потратить каждый пользователь, и следите за расходами каждого агента в консоли или через API.
4. Покажите пользователю, что сделал агент: запуск перечисляет переданные им файлы, а ссылка для доступа открывает файл или целую веб-страницу без входа в систему.
5. Разместите на странице агента свой продукт: назначьте ему один из ваших брендингов, и пользователи увидят ваше имя, логотип и цвета вместо наших.

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

Рабочие пространства#

У каждого агента своё рабочее пространство: домашняя папка с проектами, сессиями, настройками, навыками и установленными плагинами; оно создаётся при первом старте и сохраняется между запусками. Сессии, начатые через API, тоже видны на его веб-странице, сгруппированные как API Requests. Хранение оплачивается ежедневно: пока агент держится наготове, а после 7 дней без использования — за объём его архива (цены). Удаление агента безвозвратно удаляет его рабочее пространство и прекращает плату за хранение. Рабочие пространства также удаляются через 24 часа после того, как баланс ушёл ниже нуля, если вы не пополните его раньше.

Файлы и общие страницы#

То, что создаёт агент (документы, отчёты, графики, данные, веб-страница или целый статический сайт), остаётся в его домашней папке, и получить это можно тремя способами:

• На его веб-странице: файлы, которые передаёт агент, появляются в конце его ответа. Выберите файл, чтобы открыть предпросмотр; HTML-страницы выполняются в изолированном фрейме.
• Через API: запуск перечисляет переданные им файлы (files, у каждого url для скачивания), а GET /v1/agents/{id}/files/… показывает содержимое домашней папки или скачивает из неё что угодно. Это работает, пока агент запущен (в реальном времени), и пока он остановлен (в состоянии на момент последней остановки), без его запуска.
• По ссылке, которую может открыть кто угодно: Поделиться в списке файлов консоли или POST /v1/agents/{id}/shares создаёт ссылку, не требующую входа. Поделитесь файлом или папкой, чтобы опубликовать её как сайт: ссылка открывает её index.html, который загружает CSS, скрипты и изображения по относительным путям. Ссылки действуют от минуты до года (по умолчанию неделю) и продолжают работать, пока агент остановлен.

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

Безопасность и конфиденциальность#

• Песочница каждого агента изолирована от всех остальных агентов и клиентов.
• Общие страницы доступны всем, у кого есть ссылка. Делитесь только тем, что готовы опубликовать.
• Каждая сессия получает собственный API-ключ, который используется для вызовов моделей и инструментов агентом и отзывается при остановке сессии. Его вызовы видны в ваших логах.
• Телеметрия и выгрузка сессий третьим сторонам отключены.
• Выход из консоли в течение минуты завершает вход в агентов, которых вы из неё открывали.

Ограничения#

• До 1 000 агентов на учётную запись, из них одновременно работают до 20.
• Одна сессия на агента одновременно; до 4 API-запусков одновременно на агента, по одному на сессию.
• Сессия длится не более 24 часов; запустите её снова, чтобы продолжить (рабочее пространство сохраняется).
• Без GPU.