# 面向 AI 代理的 Arrakis

你的 AI 代理可以搜尋市場、租用 GPU、執行任務，然後關停機器。預算由你事先決定，它無法超支。

Arrakis 透過 Streamable HTTP 在與本站相同的地址上提供 MCP 服務，路徑為 `/mcp`，無需安裝任何東西。下文中，`$ARRAKIS_URL` 指本站地址，`ark_...` 指 API 權杖。

## 三步接入

1. **為你的 AI 代理建立權杖。** 在控制台開啟 API & agents，選擇為 AI 代理建立權杖：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. **交給它一個任務。** 告訴它機器可以執行多久，AI 代理會把它作為移除時間傳入。例如：“在 H100 上跑我的評測：租一塊，用 3 個小時，執行 python eval.py，把 results/ 拷回來，然後終止它。”

## AI 代理做不到的事

- 超出權杖的支出上限。
- 租用沒有移除時間的機器。
- 租用超過權杖允許的最長時長。
- 建立許可權比自己更大的權杖。
- 檢視或操作其他帳戶的機器。
- 給帳戶充值。只有確認到帳的付款才能增加餘額。

## 十二個工具

| 工具 | 功能 | 費用 |
|---|---|---|
| `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 彼此獨立。權杖無法簽發自身不具備的許可權。
- **按小時預付。** 租用時先支付第一個小時，之後每個小時開始時再扣費。餘額不足時機器會停止，因此失控的 AI 代理也無法讓帳單越積越多。
- **到期時間。** AI 代理權杖可以在你選定的日期到期。

## 當主機商發出通知或收回機器時

Spot 機器隨時可能被收回，任何主機商也都可能出故障。Arrakis 會立即通知你的 AI 代理。

- **每個結果都附帶提醒。** 每個 MCP 工具結果都會附帶過去一天的提醒：主機商發出的移除或維護通知、主機商無響應、機器被主機商中斷、餘額即將用完。
- **事件流。** `get_events` 和 `GET /v1/events` 會列出每臺機器的事件：已就緒、已結束及原因，以及主機商發出的通知。
- **帶簽名的 webhook。** 在控制台的 Notifications 頁面設定一個 URL，你的 AI 代理就會實時收到每個事件，並附帶 `Arrakis-Signature` 簽名。
- **宕機期間不收費。** 機器的主機商無響應期間，不收取任何小時費用；主機商收回機器後才開始的每個小時，費用都會退還。

## 你的 AI 代理帶來客戶，你就有收益

任何人都可以加入合作伙伴計劃，AI 代理也不例外。你會獲得一個合作伙伴碼和一個連結，並從你帶來的客戶的付款中獲得分成。

- **一次呼叫即可加入。** `join_partner_program` 會在你同意的前提下，為你的 AI 代理所服務的帳戶加入合作伙伴計劃，並返回合作伙伴碼、連結和一條可分享的訊息。
- **每筆付款都有你的分成。** Arrakis 的新客戶使用你的合作伙伴碼付款，首筆付款可享受折扣。之後他們支付的所有款項，包括自動充值，你都能從中獲得分成。
- **只列出你的客戶。** `get_partner_earnings` 會列出透過你的連結帶來的客戶，以及每位客戶支付的金額和為你帶來的收益，但絕不顯示他們是誰。給連結加上標籤，就能看出哪篇帖子有效果。
- **現金或 GPU。** 透過 Stripe 提現到你的銀行帳戶，或將收益轉入餘額，立即用於支付機器費用。無論在哪裡推薦 Arrakis，都要說明你會從推薦中獲得收益。

運作方式：[/partners](/zh-tw/partners.html.md)。規則：[合作伙伴條款](/zh-tw/partner-terms.html.md)。面向 AI 代理的分步說明：[合作伙伴技能](/skills/arrakis-partner/SKILL.md)。

## 機器可讀的入口點

- [/llms.txt](/zh-tw/llms.txt)：語言模型索引
- [/llms-full.txt](/zh-tw/llms-full.txt)：整站內容合為一個檔案
- [/openapi.json](/openapi.json)：OpenAPI 3.1 規範
- [/docs](/zh-tw/docs)：互動式 API 參考
- [/docs/mcp.md](/zh-tw/docs/mcp.md)：MCP 端點和工具
- [/docs/agent-walkthrough.md](/zh-tw/docs/agent-walkthrough.md)：分步演示搜尋、租用和停止
- [/partners](/zh-tw/partners.html.md)：合作伙伴計劃，面向個人和 AI 代理
- [/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 小時的價格和它所在的國家。”

## 關於 AI 代理和 GPU 的問題

**有沒有可以租用 GPU 的 MCP 伺服器？** 有。Arrakis 在 https://arrakis.goodailabs.com/mcp 執行遠端 MCP 伺服器，採用 Streamable HTTP 傳輸，使用 Bearer 權杖認證。它的工具可以搜尋實時 GPU 市場、用任意公開映像租用設有移除時間的機器、檢視餘額以及關停機器。

**如何讓 Claude Code 租用 GPU？** 在控制台中建立帶支出上限的 AI 代理權杖，然後執行 claude mcp add --transport http arrakis https://arrakis.goodailabs.com/mcp --header "Authorization: Bearer ark_..."。之後 Claude Code 就能搜尋、租用和關停 GPU，而且花費不會超過上限。

**Cursor 和其他 AI 代理能使用 Arrakis 嗎？** 可以。任何能透過 Streamable HTTP 連線遠端伺服器的 MCP 客戶端，都可以用 Bearer 權杖使用 /mcp。只支援本地伺服器的客戶端可以使用 arrakis mcp，它透過 stdio 提供同樣的工具。任何能呼叫 REST API 的程式都可以使用 /openapi.json 中的端點。

**如何防止 AI 代理在 GPU 上超支？** 給它一個專用權杖，並設定支出上限和最長租用時長。最壞情況下費用會突破上限的租用都會被 Arrakis 拒絕；該權杖的每次租用都必須設定移除時間；使用相同冪等鍵的重試絕不會重複租用。

**GPU 執行期間 AI 代理崩潰了怎麼辦？** 機器仍會在移除時間自動移除，所以 AI 代理崩潰也不會讓 GPU 一直計費。每臺機器也都顯示在控制台中，你可以在那裡停止它。

**AI 代理需要單獨的帳戶嗎？** 不需要。AI 代理使用你建立的權杖，在你的帳戶下工作。權杖的許可權、支出上限和到期時間就是它的全部預算，你可以隨時撤銷。

**我的 AI 代理能透過 Arrakis 賺錢嗎？** 可以。任何 Arrakis 帳戶都可以加入合作伙伴計劃；在帳戶所有者同意的前提下，AI 代理可以用 join_partner_program 工具為其所服務的帳戶加入。它會獲得一個合作伙伴碼和一個連結。Arrakis 的新客戶使用該合作伙伴碼付款，首筆付款可享受折扣；該帳戶則從這些客戶的付款中獲得分成，可以透過 Stripe 以現金形式領取，也可以作為租用 GPU 的額度。無論 AI 代理在哪裡推薦 Arrakis，都必須說明自己會從推薦中獲得收益。