Agent 憑證
註冊 Agent 錢包、簽發 API Key、設定消費上限、撤銷——分步圖文。
Linkex 上的 Agent 是「自帶錢包」加一把專屬 API Key。Linkex 只在建立時驗證一次錢包所有權，之後僅儲存公開地址——私鑰永不觸及平台。錢包是 Agent 的身分；Key 是它的認證憑證。
建立 Agent
開啟 Agents 頁面
前往 控制台 → Agents。Agent 管理需要錢包驗證過的工作階段——如有提示，請先連接並驗證你的帳戶錢包（SIWE）。點擊 Create Agent。
證明錢包所有權
連接將要成為 Agent 的錢包，簽署一次性所有權證明：
- EVM——EIP-712 typed-data 簽名。Domain 名稱
linkexai-agent-ownership，主類型AgentOwnership { agent, nonce, issuedAt }。 - Solana——對規範訊息
linkexai-agent-ownership\nagent: <address>\nnonce: <nonce>\nissuedAt: <unix>的 ed25519 簽名。
Nonce 一次性有效，時間戳必須新鮮（5 分鐘內），截獲的簽名無法重放。
保存 API Key——僅顯示一次
成功後 Linkex 簽發 Agent 的 API Key（sk-...）並僅顯示一次。請立即下載備份 JSON 或複製 Key；之後無法再取回（遺失需撤銷後重新註冊）。
程式化建立使用相同的兩個端點——先 POST /api/user/self/agents/siwe/nonce 再 POST /api/user/self/agents；見 API 參考。
消費上限
每個 Agent 有三個可選的美元上限，在 Agent 透過 x402 自主充值時強制執行（超限結算失敗，回傳 SPEND_CAP_EXCEEDED）：
| 上限 | 含義 |
|---|---|
per_call_cap_usd | 單筆充值最大美元金額 |
daily_cap_usd | 每日最大美元金額 |
total_cap_usd | 累計最大美元金額 |
0 表示不設限。當前消費計數（spent_today_usd、spent_total_usd）可在 Agents 頁面與 GET /api/user/self/agents 查看。
使用 Agent Key
Agent Key 可用於普通 Key 的所有場景：
# 推理
curl https://linkex.ai/v1/chat/completions -H "Authorization: Bearer sk-AGENT_KEY" ...
# 查詢餘額（共享帳戶餘額）
curl https://linkex.ai/api/user/self/balance -H "Authorization: Bearer sk-AGENT_KEY"
# 建立充值訂單——自動綁定此 Agent，上限強制執行
curl -X POST https://linkex.ai/api/user/topup/x402/orders \
-H "Authorization: Bearer sk-AGENT_KEY" -d '{"amount_usd": 5}'使用 Agent Key 認證時，x402 訂單強制綁定該 Agent 的錢包——請求體中的 agent_wallet_id 會被忽略。這使得上限無法被 Agent 一側繞過。
撤銷
在 Agents 頁面點擊 Revoke（或 DELETE /api/user/self/agents/{agent_id}）。單一交易內完成 Key 停用與錢包解綁。撤銷是冪等的；同一錢包之後可重新註冊——會獲得全新的 Key。
限制
- 每帳戶最多 50 個 Agent。
- EVM 地址以小寫儲存；Solana 地址為大小寫敏感的 base58。
- 同一錢包地址同時只能註冊為一個 Agent（撤銷後可重新註冊）。