# 面向智能体的 Arrakis

你的智能体可以搜索市场、租用 GPU、运行任务，然后关停机器。预算由你事先决定，它无法超支。

Arrakis 通过 Streamable HTTP 在与本站相同的地址上提供 MCP 服务，路径为 `/mcp`，无需安装任何东西。下文中，`$ARRAKIS_URL` 指本站地址，`ark_...` 指 API 令牌。

## 三步接入

1. **为你的智能体创建令牌。** 在控制台打开 API & agents，选择为智能体创建令牌：read 和 rent 权限、支出上限和最长租用时长。使用 CLI：

   ```sh
   arrakis tokens create --name eval-agent \
     --scope read --scope rent \
     --spend-limit 50 --max-rental-hours 6 --expires-in 7d
   ```

2. **添加 MCP 端点。** 把令牌作为 Bearer 请求头使用。

   Claude Code:

   ```sh
   claude mcp add --transport http arrakis $ARRAKIS_URL/mcp \
     --header "Authorization: Bearer ark_..."
   ```

   Cursor（`~/.cursor/mcp.json`）：

   ```json
   {
     "mcpServers": {
       "arrakis": {
         "url": "$ARRAKIS_URL/mcp",
         "headers": { "Authorization": "Bearer ark_..." }
       }
     }
   }
   ```

   任意客户端：传输方式选 Streamable HTTP，URL 为 `$ARRAKIS_URL/mcp`，请求头为 `Authorization: Bearer ark_...`。

   本地运行，通过 stdio：`ARRAKIS_TOKEN=ark_... ARRAKIS_BASE_URL=$ARRAKIS_URL arrakis mcp`。

3. **交给它一个任务。** 告诉它机器可以运行多久，智能体会把它作为移除时间传入。例如：“在 H100 上跑我的评测：租一块，用 3 个小时，运行 python eval.py，把 results/ 拷回来，然后终止它。”

## 智能体做不到的事

- 超出令牌的支出上限。
- 租用没有移除时间的机器。
- 租用超过令牌允许的最长时长。
- 创建权限比自己更大的令牌。
- 查看或操作其他账户的机器。
- 给账户充值。只有确认到账的付款才能增加余额。

## 十二个工具

| 工具 | 功能 | 费用 |
|---|---|---|
| `search_gpus` | 列出可用机器，按 GPU 性能、价格和主机商的可靠性排序，最好的排在最前面；可按 GPU、数量、显存、每 GPU 小时价格和国家筛选。它会给出推荐的机器及理由。 | 免费 |
| `get_market_summary` | 各 GPU 系列当前的最低价格和供应量。 | 免费 |
| `get_balance` | 账户余额、运行中机器每小时的费用、余额何时用完，以及令牌的上限。 | 免费 |
| `rent_gpu` | 租用一台机器，时长最多为 `termination_hours`，并返回其 SSH 命令、最坏情况下的费用，以及余额可以支付多少小时。重试会返回同一台机器。 | 按小时价格逐小时计费，直到移除 |
| `list_images` | 机器可以启动的镜像：Arrakis 镜像，以及账户自己的镜像（包括私有镜像）。`rent_gpu` 也接受任意公开镜像。 | 免费 |
| `list_instances` | 账户中正在运行的机器。 | 免费 |
| `get_instance` | 单台机器的状态、SSH 命令、移除时间，以及主机商发出的任何通知。 | 免费 |
| `get_events` | 账户中的机器发生了什么：已就绪、已结束及原因（是否被主机商中断），以及主机商发出的通知。 | 免费 |
| `terminate_instance` | 立即停止机器，计费随之停止。 | 停止计费 |
| `schedule_removal` | 调整机器的移除时间。 | 会改变最高费用 |
| `get_partner_earnings` | 面向合作伙伴：你的合作伙伴码、要分享的链接和消息、你带来的客户、你已获得和可提现的收益，以及合作伙伴计划是否开放。 | 免费 |
| `join_partner_program` | 在账户所有者同意的前提下，为该账户加入合作伙伴计划：获得合作伙伴码、链接和一条可分享的消息。 | 免费 |

## 无人值守时，支出为何依然安全

这些规则内置于 API 中，因此对 MCP、CLI 和普通 HTTP 请求同样有效。

- **支出上限。** 设有上限的令牌按最坏情况（小时价格 × 到移除为止的小时数）计算每次租用，会突破上限的租用将被拒绝。
- **必须设置移除时间。** 设有上限的令牌在没有 `termination_hours` 时无法租用，也不能超过最长租用时长。
- **重试安全。** 相同的 `idempotency_key` 总是返回同一台机器，重试绝不会重复租用。
- **限定权限的令牌。** read、rent、manage 和 billing 彼此独立。令牌无法签发自身不具备的权限。
- **按小时预付。** 租用时先支付第一个小时，之后每个小时开始时再扣费。余额不足时机器会停止，因此失控的智能体也无法让账单越积越多。
- **到期时间。** 智能体令牌可以在你选定的日期到期。

## 当主机商发出通知或收回机器时

Spot 机器随时可能被收回，任何主机商也都可能出故障。Arrakis 会立即通知你的智能体。

- **每个结果都附带提醒。** 每个 MCP 工具结果都会附带过去一天的提醒：主机商发出的移除或维护通知、主机商无响应、机器被主机商中断、余额即将用完。
- **事件流。** `get_events` 和 `GET /v1/events` 会列出每台机器的事件：已就绪、已结束及原因，以及主机商发出的通知。
- **带签名的 webhook。** 在控制台的 Notifications 页面设置一个 URL，你的智能体就会实时收到每个事件，并附带 `Arrakis-Signature` 签名。
- **宕机期间不收费。** 机器的主机商无响应期间，不收取任何小时费用；主机商收回机器后才开始的每个小时，费用都会退还。

## 你的智能体带来客户，你就有收益

任何人都可以加入合作伙伴计划，AI 智能体也不例外。你会获得一个合作伙伴码和一个链接，并从你带来的客户的付款中获得分成。

- **一次调用即可加入。** `join_partner_program` 会在你同意的前提下，为你的智能体所服务的账户加入合作伙伴计划，并返回合作伙伴码、链接和一条可分享的消息。
- **每笔付款都有你的分成。** Arrakis 的新客户使用你的合作伙伴码付款，首笔付款可享受折扣。之后他们支付的所有款项，包括自动充值，你都能从中获得分成。
- **只列出你的客户。** `get_partner_earnings` 会列出通过你的链接带来的客户，以及每位客户支付的金额和为你带来的收益，但绝不显示他们是谁。给链接加上标签，就能看出哪篇帖子有效果。
- **现金或 GPU。** 通过 Stripe 提现到你的银行账户，或将收益转入余额，立即用于支付机器费用。无论在哪里推荐 Arrakis，都要说明你会从推荐中获得收益。

运作方式：[/partners](/zh-cn/partners.html.md)。规则：[合作伙伴条款](/zh-cn/partner-terms.html.md)。面向智能体的分步说明：[合作伙伴技能](/skills/arrakis-partner/SKILL.md)。

## 机器可读的入口点

- [/llms.txt](/zh-cn/llms.txt)：语言模型索引
- [/llms-full.txt](/zh-cn/llms-full.txt)：整站内容合为一个文件
- [/openapi.json](/openapi.json)：OpenAPI 3.1 规范
- [/docs](/zh-cn/docs)：交互式 API 参考
- [/docs/mcp.md](/zh-cn/docs/mcp.md)：MCP 端点和工具
- [/docs/agent-walkthrough.md](/zh-cn/docs/agent-walkthrough.md)：分步演示搜索、租用和停止
- [/partners](/zh-cn/partners.html.md)：合作伙伴计划，面向个人和智能体
- [/skill.md](/skill.md)：在 Arrakis 上租用 GPU，以 Agent Skill 形式提供
- [/skills/arrakis-partner/SKILL.md](/skills/arrakis-partner/SKILL.md)：以 Agent Skill 形式提供的合作伙伴计划
- [/v1/market/summary](/v1/market/summary)：实时市场概览，无需令牌
- [/sitemap.xml](/sitemap.xml)

本站每个页面都有对应的 Markdown 版本：`/` 对应 `/index.html.md`，`/agents` 对应 `/agents.html.md`，`/careers` 对应 `/careers.html.md`。

## 可以这样吩咐

- “找一块至少 48 GB 显存、最便宜的 GPU，租 2 个小时，然后告诉我怎么 SSH 登录。”
- “用 4 块 RTX 4090 运行 train.py 微调，最多 6 个小时，把检查点拷回来，运行结束后停止机器。”
- “看看有没有可用的 H200。有的话，告诉我每 GPU 小时的价格和它所在的国家。”

## 关于智能体和 GPU 的问题

**有没有可以租用 GPU 的 MCP 服务器？** 有。Arrakis 在 https://arrakis.goodailabs.com/mcp 运行远程 MCP 服务器，采用 Streamable HTTP 传输，使用 Bearer 令牌认证。它的工具可以搜索实时 GPU 市场、用任意公开镜像租用设有移除时间的机器、查看余额以及关停机器。

**如何让 Claude Code 租用 GPU？** 在控制台中创建带支出上限的智能体令牌，然后运行 claude mcp add --transport http arrakis https://arrakis.goodailabs.com/mcp --header "Authorization: Bearer ark_..."。之后 Claude Code 就能搜索、租用和关停 GPU，而且花费不会超过上限。

**Cursor 和其他智能体能使用 Arrakis 吗？** 可以。任何能通过 Streamable HTTP 连接远程服务器的 MCP 客户端，都可以用 Bearer 令牌使用 /mcp。只支持本地服务器的客户端可以使用 arrakis mcp，它通过 stdio 提供同样的工具。任何能调用 REST API 的程序都可以使用 /openapi.json 中的端点。

**如何防止 AI 智能体在 GPU 上超支？** 给它一个专用令牌，并设置支出上限和最长租用时长。最坏情况下费用会突破上限的租用都会被 Arrakis 拒绝；该令牌的每次租用都必须设置移除时间；使用相同幂等键的重试绝不会重复租用。

**GPU 运行期间智能体崩溃了怎么办？** 机器仍会在移除时间自动移除，所以智能体崩溃也不会让 GPU 一直计费。每台机器也都显示在控制台中，你可以在那里停止它。

**智能体需要单独的账户吗？** 不需要。智能体使用你创建的令牌，在你的账户下工作。令牌的权限、支出上限和到期时间就是它的全部预算，你可以随时撤销。

**我的 AI 智能体能通过 Arrakis 赚钱吗？** 可以。任何 Arrakis 账户都可以加入合作伙伴计划；在账户所有者同意的前提下，智能体可以用 join_partner_program 工具为其所服务的账户加入。它会获得一个合作伙伴码和一个链接。Arrakis 的新客户使用该合作伙伴码付款，首笔付款可享受折扣；该账户则从这些客户的付款中获得分成，可以通过 Stripe 以现金形式领取，也可以作为租用 GPU 的额度。无论智能体在哪里推荐 Arrakis，都必须说明自己会从推荐中获得收益。