Lovely Router文档
获取密钥
云端智能体

白标

在智能体页面上使用你自己的名称、Logo、配色和字体,让你的用户只看到你的产品,看不到 Lovely Router 的名字。可保存多个品牌,并为每个智能体选择一个。

白标智能体是穿上你的品牌、而不是我们品牌的云端智能体。它的网页、浏览器标签页以及周边页面都会显示你的智能体名称、你的 Logo、你的配色和字体,以及你的欢迎语。用它把智能体嵌入你自己的产品:每个产品或你的每个客户一个品牌,每个品牌下可以有任意多个智能体。

  1. 设计品牌

    在云端智能体 → 品牌定制中选择新建品牌。设置用户看到的名称,上传 Logo,选择主题、配色和字体,并写一句欢迎语;预览会实时显示智能体页面的样子。也可以用 POST /v1/agents/brandings 创建。

  2. 为智能体选择它

    创建智能体时在品牌中选择它,或之后在智能体的设置中选择。通过 API,在创建或更新智能体时发送 "branding": "brd_…"。从智能体下次启动起生效。

  3. 把页面交给你的用户

    给你的用户一个带 ui 权限范围的智能体令牌:它的链接会以你的品牌打开智能体页面,且已登录。也可以不给用户页面,只使用运行。

你的用户看到什么#

  • 智能体页面:页面标题、侧边栏和浏览器标签页上是你的智能体名称;侧边栏标志、输入框上方的大标志和网站图标是你的 Logo;标题语是你的欢迎语;整套配色(深色或浅色主题)和字体都是你的。
  • 周边页面:智能体地址上的正在启动…、登录、已停止等提示页同样使用你的品牌,并且从不链接到 Lovely Router。如果智能体因你的余额或预算无法启动,你的用户只会看到它暂时不可用。
  • 智能体本身:它以你的智能体名称自称,它提供的模型列在这个名称下,它的内置工具也不会提到 Lovely Router。

在你连接自己的域名之前,地址是 agent.lovelyrouter.com/a/<智能体 ID>/(分享链接为 agent.lovelyrouter.com/s/…);连接之后就是你的,例如 agents.yourcompany.com/a/<智能体 ID>/。

Tip

选一个你的用户熟悉的智能体名称,例如 Nova Assistant。智能体在对话中也会这样称呼自己。

价格#

白标智能体的沙箱费用(计算和存储)为标准价格的 1.5×。它们使用的模型、数据工具和浏览器智能体仍按原价计费。

项目标准白标
小型(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 + 磁盘每 GB·月 $0.30 + 备份每 GB·月 $0.16每月 $0.54 + 磁盘每 GB·月 $0.45 + 备份每 GB·月 $0.24
已归档(7 天未使用)每 GiB·月 $0.20每 GiB·月 $0.30
LLM token、数据工具、浏览器智能体原价原价
你自己的域名—连接期间每天 $0.50

会话按其启动时的价格计费:为智能体开启或关闭品牌,会从它下次启动起改变价格。存储按当天智能体所用品牌的价格逐日计费。保存品牌本身免费。

品牌#

一个品牌包含:

  • 智能体名称:你的用户看到的名称(1–40 个字母、数字、空格及 . _ -)。
  • 控制台中的名称:你自己的标签,不会展示给你的用户。
  • Logo:PNG、JPEG、WebP 或 SVG,方形效果最好;控制台会把图片缩放到 256 像素。没有 Logo 时,使用智能体名称首字母配强调色。SVG 以图片方式显示,其中的脚本永远不会运行。
  • 主题:深色或浅色,加上强调色和背景色。其他颜色(面板、边框、文字、链接、强调色上的文字)由它们推导,也可以逐个微调。
  • 字体:从 Google Fonts 中选一个正文字体和一个代码字体,或使用页面自带字体。
  • 欢迎语:第一个输入框上方的标题,最多 80 个字符。默认:有什么可以帮你?

最多可保存 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?"}'

# 然后创建一个使用它的智能体
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)上提供一个品牌的智能体。它们的链接、登录、页面和分享链接都会使用这个域名,地址栏里不会出现我们的名字。

  1. 连接域名

    在品牌定制中打开该品牌,在你自己的域名下输入域名,或调用 PUT /v1/agents/brandings/{id}/domain。

  2. 添加一条 DNS 记录

    在你的 DNS 服务商处添加页面上显示的 CNAME 记录:你的域名 → 页面上显示的目标。根域名(yourcompany.com)需要 DNS 服务商支持在根上设置 CNAME(CNAME 展平或 ALIAS)。

  3. 等待证书

    记录生效后证书会自动签发,通常只需几分钟,状态随即变为已生效。如果想在把域名指向我们之前先准备好证书,请同时添加页面上显示的 TXT 记录。

生效后,新生成的打开链接、ui 智能体令牌和分享链接都会指向你的域名;之前生成的链接在 agent.lovelyrouter.com 上继续有效。你的域名上只会响应该品牌的智能体,Lovely Router 的其他内容都不会出现。

域名连接期间每天 $0.50,按连接的每一天(UTC)计费,从连接当天开始。移除后从第二天起停止计费。每个品牌一个域名;删除品牌会一并移除其域名。账户余额持续为负时,域名会和工作区一样在 24 小时后被移除。

限制#

  • 每个账户最多 50 个品牌;每个品牌下的智能体数量不限。
  • Logo 最大 64 KB(通过 API 以 base64 data: URI 发送)。
  • 每个品牌一个域名;一个域名只能连接到一个账户。