交给你的 AI 智能体
把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。
Use Lovely Router cloud agents in this project: hosted agents, each with its own private sandbox and files, driven over an API. - Docs (read first): https://lovelyrouter.com/docs/agents.md and https://lovelyrouter.com/docs/api/agents.md - Create one with POST https://lovelyrouter.com/v1/agents, give it work with POST https://lovelyrouter.com/v1/agents/<id>/runs and read its files with GET https://lovelyrouter.com/v1/agents/<id>/files/<path>. Billed per hour while it runs. - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <describe what you want to build or get>
工作原理
创建智能体
给它取个名字;如果它为你的某个用户服务,再填上你给该用户的 ID。预算可以限制它能花费的金额。
cURLcurl https://lovelyrouter.com/v1/agents \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{"name": "Support bot", "user": "cust-42", "budget_micros": 5000000}'给它发送任务
向智能体的运行接口提交一个任务。已停止的智能体会自动唤醒,在沙箱中用它的工具和设置完成工作,并在最后一次运行结束几秒后再次停止。
cURLcurl https://lovelyrouter.com/v1/agents/agt_3f9a1c7e0b2d4e6f8a9b0c1d/runs \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{"input": "Summarize README.md in three bullets.", "wait": 120}'获取它的成果
运行会返回智能体的回答、token 用量以及它交付的文件,每个文件都附有下载 URL。分享链接可以打开一个文件,也可以把整个文件夹作为网站打开,任何拿到链接的人都能访问。
每个智能体包含什么
:对话、会话、计划模式、子智能体、技能、定时任务、插件和终端,都在该智能体专属的地址上。
新会话默认使用我们最便宜的 Claude Haiku 5.5;你可以为每个智能体选择其他默认模型,也可以在会话中切换。参阅全部模型。
数据工具和浏览器智能体以 MCP 工具的形式提供,智能体可以搜索网页,一次调用就从 YouTube、Reddit、Google Maps 或 Amazon 获取结构化数据,生成图片,或操控浏览器。
:包含 Node.js 22、Python 3、git、编译工具和 ripgrep,可访问互联网,并与其他所有智能体和客户隔离。它的工作区在每次运行之间都会保留。
运行 API
POST /v1/agents/{id}/runs 发送一个任务,最长 100,000 个字符。设置 wait 可让请求最多等待 300 秒以获取结果;设置 stream 则以服务器发送事件(SSE)的形式接收运行事件:带 token 用量的状态、工具调用及其结果、文本和最终回答。传入之前某次运行的 session_id 即可继续那段对话。
已完成的运行包含 output、usage、steps、tool_calls 和 files。你还可以列出运行、稍后再流式获取某次运行的事件,或取消它。每个智能体最多同时处理 4 个运行。
为你自己的用户提供智能体
把智能体集成到你的产品中:为你的每个用户创建一个智能体,各有独立的工作区,费用都从你的余额中扣除。
创建智能体时带上 {"user": "cust-42"} 和任意 metadata,再用 GET /v1/agents?user=cust-42 列出某个用户的智能体。
agtok_ 令牌只能访问一个智能体,并会在 1 分钟到 30 天后自动过期。api 权限用于发送运行和读取文件;ui 权限附带一个链接,可打开该智能体的页面并已自动登录。你可以随时吊销某个智能体的令牌。
,限制每个用户可花费的金额;花费达到预算后,智能体就会停止。
即使智能体已停止,也可以列出或下载它主目录中的任何内容,并生成无需登录的链接,有效期从一分钟到一年。
给智能体一个品牌,你的用户看到的就是你的名称、Logo 和配色,而不是我们的。参阅白标智能体。
每个智能体的设置
在控制台中或通过 PATCH /v1/agents/{id},每个智能体都可以单独设置:默认模型;数据工具和浏览器智能体的开关;最多 8 个你自己的远程 MCP 服务器,请求头的值加密存储;最多 4,000 个字符、会添加到每个会话中的指令;规格;空闲多久后停止(5 分钟到 24 小时,默认 30 分钟);最长会话时长(1 到 24 小时,默认 8 小时);以及默认开启的被调用时自动唤醒,这样一次运行或一次页面访问就能启动已停止的智能体。
大家用它做什么
为你产品中的每个账户创建一个智能体,给你的后端一个 api 令牌,各设一个预算,再用数据工具进行网页搜索和获取平台数据。
一个中型或大型智能体,把你的编码规范写进指令,由它克隆仓库、运行测试并报告失败项。
智能体把 HTML 报告或静态网站构建到一个文件夹中,再用分享链接发布这个文件夹。
你的定时任务提交一次运行;智能体醒来、完成任务后再回去休眠,你只为它实际运行的时间付费。
费用说明
每个智能体的沙箱在运行期间按秒计费,它使用的内容另按常规价格计费:模型 token、数据工具结果和浏览器步数。
| 规格 | CPU | 内存 | 运行每小时 |
|---|---|---|---|
| 小型 | 2 个共享 vCPU | 2 GiB | $0.05 |
| 中型 | 4 个共享 vCPU | 4 GiB | $0.10 |
| 大型 | 8 个共享 vCPU | 8 GiB | $0.20 |
突发用量(例如一次编译)不另收费。两次会话之间,智能体保持就绪,几秒即可再次启动:每月 $0.36,另加磁盘每 GB·月 $0.30 和每日备份每 GB·月 $0.16(新智能体每月约 $0.66)。7 天未使用后会被归档,按其文件每 GiB·月 $0.20 计费。启动智能体时,余额需覆盖该规格 15 分钟的费用;没有订阅。参阅价格页。
常见问题
什么是托管 AI 智能体?+
它就是运行在我们托管的私有云端沙箱中的 Lovely Agent。它会在每次运行之间保留文件、会话和设置,你可以在浏览器中或通过 /v1/agents API 访问它,无需自己搭建云端 agent 运行环境,也无需运维任何基础设施。
我可以运行多少个智能体?+
每个账户最多 1,000 个智能体,其中最多 20 个同时运行。每个智能体最多同时处理 4 个 API 运行。
我的用户能在看不到我的 API 密钥的情况下使用智能体吗?+
可以。给每个用户一个对应其智能体的智能体令牌。它只能访问那一个智能体,会自动过期,也可以随时吊销。
智能体停止时还要付费吗?+
只需支付工作区存储费用。沙箱从启动起计费,直到停止为止;智能体在一段时间未使用后会自动停止。
智能体可以使用哪些模型?+
模型列表中的所有对话模型,包括 Claude、GPT 和 Gemini,均已配置好。默认模型是 Claude Haiku 5.5;你可以为每个智能体设置其他默认模型,也可以在会话中切换模型。
智能体可以使用 GPU 吗?+
不可以。智能体运行在三种规格的 CPU 沙箱上,单次会话最长 24 小时,之后需要重新启动;工作区会保留。
阅读云端智能体文档和智能体 API 参考,或查看 MCP 服务器,为你自己的智能体接入同样的工具。