管理 SDK
在受信任的營運者 TypeScript 服務中使用 StableOps Agent Payments 管理 SDK，建立和查詢付款 Agent、錢包、不可變支出策略、預算、多人審批與付款記錄，並瞭解管理金鑰範圍、請求對映和安全的自動化設定方式。
@stableops/agent-payments-api-sdk 是 Agent Payments 的專用管理用戶端。它應執行在受信任的營運者伺服器端，不能放入 Agent 執行時或瀏覽器程式碼。
安裝
pnpm add @stableops/agent-payments-api-sdk建立管理用戶端
管理 API Key 同時限定組織、環境和產品許可權：
import { StableOpsAgentPayments } from '@stableops/agent-payments-api-sdk'
const apiKey = process.env.STABLEOPS_API_KEY?.trim()
if (!apiKey) throw new Error('缺少 STABLEOPS_API_KEY')
const management = new StableOpsAgentPayments({
apiKey,
})ak_sandbox_... 或 ak_live_... 格式的受限 Agent Key。可用資源
| 資源 | 主要操作 |
|---|---|
management.agents | 建立、查詢、更新、暫停或恢復 Agent，管理 Agent Key 和不可變策略版本 |
management.wallets | 建立錢包登記質詢、登記錢包、查詢錢包，以及繫結或解綁 Agent 的預設錢包 |
management.budgets | 在平台上限內查詢或更新組織與 Agent 的日預算 |
management.approvals | 查詢審批記錄 |
management.payments | 篩選或匯出付款記錄，以及查詢狀態遷移記錄和結算回執 |
金額欄位分為兩類，不能混用：
- 支出策略和預算中的
automaticPaymentThresholdAtomic、perPaymentLimitAtomic、agentDailyLimitAtomic、limitAtomic等欄位統一使用 6 位 USDC 預算單位，因此1000000始終表示 1 USDC。 - 支付、審批和回執中的
maxAmountAtomic使用該網路 USDC 的鏈上資產最小單位，必須結合返回的assetDecimals解釋。Base 和其它 6 位資產設定用1000000表示 1 USDC。
如果收費服務要求使用 BNB Smart Chain，請先確認它接受對應資產，並完成 Permit2 授權。在該網路支付 1 USDC 時，x402 報價和 maxAmountAtomic 是 1000000000000000000，但策略單筆限額和日預算仍寫 1000000。StableOps 會向上取整計算預算佔用，避免極小金額不計入預算。
策略版本建立後不可修改。需要調整規則時，應建立新版本並顯式啟用。完整網路位數見介紹中的支援範圍。
篩選與匯出付款使用記錄
付款查詢可以按付款狀態、資源狀態、Agent、來源、時間範圍，以及隨支付意圖固化的業務上下文篩選：
const page = await management.payments.listPage({
status: 'settled',
resourceStatus: 'response_received',
workflowId: 'research-weekly',
toolName: 'market-data',
purposeCode: 'RESEARCH_DATA',
costCenter: 'research',
createdFrom: '2026-08-01T00:00:00.000Z',
createdTo: '2026-08-31T23:59:59.999Z',
limit: 50,
})
const csv = await management.payments.exportCsv({
workflowId: 'research-weekly',
createdFrom: '2026-08-01T00:00:00.000Z',
createdTo: '2026-08-31T23:59:59.999Z',
})CSV 匯出使用同一組篩選條件，單次最多包含 10,000 條記錄。StableOps 會為呼叫方可控上下文欄位中的電子表格公式字元增加安全字首，但匯出檔案仍應按敏感財務記錄管理。
Agent Key 只顯示一次
const credential = await management.agents.createKey('agent_...', {
name: 'production-runtime',
})
if (!credential.secret) throw new Error('沒有返回一次性 Agent Key')
console.log(`STABLEOPS_AGENT_KEY=${credential.secret}`) // 僅在安全的首次設定環境中輸出。API 不會再次返回明文。金鑰丟失或洩露時，應撤銷舊 Key 並簽發新 Key。
在控制台作出審批決定
管理 API Key 可以讀取審批佇列。批准和拒絕屬於高風險操作，仍應在 StableOps 控制台完成。管理 SDK 不接受控制台訪問令牌，也不提供批准和拒絕方法。
完整的錢包登記、策略設定和支付流程見快速開始。
這篇文件怎麼樣？
最後更新