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

White label

Разместите на страницах ваших агентов собственное имя, логотип, цвета и шрифты, чтобы пользователи видели ваш продукт и ничего, что упоминает Lovely Router. Сохраните несколько брендингов и выберите свой для каждого агента.

Агент под вашим брендом (white label) — это облачный агент, который носит ваш брендинг вместо нашего. Его веб-страница, вкладка браузера и окружающие страницы показывают имя вашего агента, ваш логотип, ваши цвета и шрифты и вашу приветственную строку. Используйте это, чтобы поставлять агентов внутри собственного продукта: один брендинг на продукт или на каждого вашего клиента и сколько угодно агентов под каждым.

Создайте брендинг
В разделе Облачные агенты → Брендинги выберите Новый брендинг. Задайте имя, которое увидят пользователи, загрузите логотип, выберите тему, цвета и шрифты и напишите приветственную строку; предпросмотр по ходу показывает страницу агента. Или создайте брендинг через POST /v1/agents/brandings.
Назначьте его агенту
Выберите его в поле Брендинг при создании агента или позже в Настройках агента. Через API передайте "branding": "brd_…" при создании или обновлении агента. Брендинг применяется со следующего старта агента.
Дайте пользователям его страницу
Выдайте пользователю токен агента со scope ui: его ссылка открывает страницу агента с выполненным входом, в вашем брендинге. Или оставьте страницу себе и используйте только запуски.

Что видят ваши пользователи#

Страница агента: имя вашего агента в заголовке страницы, на боковой панели и во вкладке браузера; ваш логотип как значок боковой панели, крупный значок над полем сообщения и favicon; ваша приветственная строка как заголовок; ваши цвета повсюду, в тёмной или светлой теме; ваши шрифты.
Окружающие страницы: Запуск…, Войти, Остановлено и другие уведомления по адресу агента тоже используют ваш брендинг и никогда не ссылаются на Lovely Router. Если агент не может стартовать из-за вашего баланса или бюджета, пользователю сообщают лишь, что сейчас он недоступен.
Сам агент: он называет себя именем вашего агента, предлагаемые им модели перечислены под этим именем, а его встроенные инструменты не упоминают Lovely Router.

Адрес — agent.lovelyrouter.com/a/<agent id>/ (и agent.lovelyrouter.com/s/… для ссылок для доступа), пока вы не подключите собственный домен: тогда он ваш, например agents.yourcompany.com/a/<agent id>/.

Выберите имя агента, которое пользователи узнают, например Nova Assistant. Так агент будет называть себя и в разговоре.

Цены#

Агенты под вашим брендом стоят в 1,5 раза дороже стандартных тарифов на их песочницу: вычисления и хранение. Модели, инструменты данных и браузерный агент, которые они используют, сохраняют обычные цены.

Позиция	Стандарт	White label
Маленький (2 общих vCPU, 2 GiB)	$0.05 в час	$0.075 в час
Средний (4 общих vCPU, 4 GiB)	$0.10 в час	$0.15 в час
Большой (8 общих vCPU, 8 GiB)	$0.20 в час	$0.30 в час
Готовность между сессиями	$0.36 в месяц + $0.30 за ГБ-месяц диска + $0.16 за ГБ-месяц резервных копий	$0.54 в месяц + $0.45 за ГБ-месяц диска + $0.24 за ГБ-месяц резервных копий
Архив (не использовался 7 дней)	$0.20 за GiB-месяц	$0.30 за GiB-месяц
LLM-токены, инструменты данных, браузерный агент	Обычные цены	Обычные цены
Собственный домен	—	$0.50 в день, пока подключён

Сессия оплачивается по тарифу, с которым она началась: включение или отключение брендинга у агента меняет цену со следующего старта. Хранение оплачивается каждый день по тарифу, соответствующему брендингу агента в этот день. Хранить сами брендинги бесплатно.

Брендинги#

Брендинг содержит:

Название агента: то, что видят пользователи (от 1 до 40 букв, цифр, пробелов и . _ -).
Имя в консоли: ваша собственная метка, пользователям никогда не показывается.
Логотип: PNG, JPEG, WebP или SVG. Лучше всего подходит квадратный; консоль масштабирует изображения до 256 пикселей. Без логотипа показывается первая буква названия агента на акцентном цвете. SVG отображается как изображение, поэтому скрипты в нём никогда не выполняются.
Тема: тёмная или светлая, с акцентным и фоновым цветом. Остальные цвета (панели, рамки, текст, ссылки, текст на акцентном цвете) выводятся из них; при желании каждый можно настроить вручную.
Шрифты: шрифт текста и шрифт кода из Google Fonts или собственные шрифты страницы.
Приветственная строка: заголовок над первым полем сообщения, до 80 символов. По умолчанию: What can I do for you?

Можно хранить до 50 брендингов. Изменение доходит до каждого агента, использующего брендинг, при его следующем старте; окружающие страницы обновляются в течение минуты. Брендинг, который используют агенты, удалить нельзя: сначала переключите их на другой брендинг или обратно на стандартный вид.

cURL

curl https://lovelyrouter.com/v1/agents/brandings \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"agent_name": "Nova Assistant", "scheme": "light", "colors": {"accent": "#0d9488"}, "font": "Inter", "welcome": "How can Nova help today?"}'

# then create an agent that wears it
curl https://lovelyrouter.com/v1/agents \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"name": "Nova for cust-42", "user": "cust-42", "branding": "brd_6c1f0a9e3b7d2c4e8f5a1b0d"}'

Все поля описаны в разделе эндпоинты брендингов.

Собственный домен#

Размещайте агентов брендинга на своём домене, например agents.yourcompany.com. Их ссылки, вход, страницы и ссылки для доступа тогда используют его, и ничто в адресной строке не указывает на нас.

Подключите домен
Откройте брендинг в разделе Брендинги и введите домен в поле Ваш собственный домен или вызовите PUT /v1/agents/brandings/{id}/domain.
Добавьте одну DNS-запись
У своего DNS-провайдера добавьте показанную запись CNAME: ваш домен → указанная там цель. Для корневого домена (yourcompany.com) нужен провайдер, который допускает там записи CNAME (CNAME flattening или ALIAS).
Дождитесь сертификата
Как только запись заработает, сертификат выпускается автоматически, обычно за несколько минут; статус сменится на Активен. Чтобы подготовить сертификат до того, как вы направите домен на нас, добавьте также показанные TXT-записи.

Когда домен активен, новые ссылки на открытие, токены агента ui и ссылки для доступа указывают на ваш домен. Ссылки, созданные раньше, продолжают работать на agent.lovelyrouter.com. На вашем домене отвечают только агенты этого брендинга; больше ничего из Lovely Router там не доступно.

Домен стоит $0.50 в день, пока подключён: плата берётся за каждый день (UTC), когда он подключён, начиная с дня подключения. Отключение прекращает плату со следующего дня. Один домен на брендинг; удаление брендинга удаляет и его домен. Домены учётной записи, баланс которой остаётся ниже нуля, удаляются через 24 часа, как и её рабочие пространства.