agent-payment-x402

agent-payment-x402 技能概覽

agent-payment-x402 的用途

agent-payment-x402 技能可幫助 AI 代理使用 x402 HTTP 支付流程與 MCP 工具，執行機器對機器的付款。它真正做的不是抽象地「處理付款」；而是讓被編排的代理可以呼叫付費端點、處理 402 Payment Required、檢查政策、從非託管錢包簽署交易，並自動重試。

誰適合安裝這個技能

最適合的情境：正在做代理編排、付費 API 存取、服務對服務自動化，或代理市集的開發者。如果你的代理需要買資料、呼叫計量計費工具、付款給另一個代理，或在不把控制權交給託管支付層的前提下嚴格限制支出，agent-payment-x402 技能就特別有用。

為什麼使用者會選它，而不是一般提示詞

一般提示詞可以描述付款邏輯，但不一定能穩定表達支出政策、收款方控制，或 402 協商模式。agent-payment-x402 技能提供模型更清楚的操作框架：什麼時候付、如何遵守預算，以及非託管錢包的限制如何融入工作流程。

重要的導入考量

這是一個聚焦型技能，不是完整的錢包堆疊。當你已經有 MCP 工具與支援 x402 的服務時，它最有價值。如果你只需要發票產生、人工核准，或一般 SaaS 計費，agent-payment-x402 很可能不是正確的抽象層。

如何使用 agent-payment-x402 技能

安裝情境與優先閱讀內容

先在支援技能的環境中安裝這個技能，接著先閱讀 skills/agent-payment-x402/SKILL.md，因為這個 repo 的實作指引主要寫在那裡，而不是放在輔助檔案中。這個技能沒有額外的 resources/、rules/ 或腳本，所以在把它接到你的 agent-payment-x402 for Agent Orchestration 工作流程之前，必須先確實理解核心文件。

這個技能要運作良好，需要哪些輸入

要把 agent-payment-x402 技能用好，請提供給代理：

• 可能需要付款的服務或端點
• 付款觸發條件，通常是 402 回應
• 帶有每個任務與每個工作階段上限的 SpendingPolicy
• 若付款對象需要限制，請提供收款方 allowlist
• 交易速率限制
• 錢包／帳戶上下文，最好是以非託管 smart-account 假設為前提

薄弱的輸入：Pay for whatever is needed.
強而有力的輸入：If api.example.com returns 402, allow payment only to the listed recipient, cap spend at $2 per task and $15 per session, and abort if a second payment attempt is needed.

把模糊目標變成可用提示詞

一個好的 agent-payment-x402 使用提示詞，應清楚指定任務、預算、交易對手與失敗行為。範例如下：

“Complete the data retrieval task. If the provider responds with 402 Payment Required, use the x402 payment tool. Enforce per-task budget 0.50 USDC, session budget 5 USDC, recipient allowlist [provider address], and max 3 payment attempts per hour. Retry the original request after successful payment. If policy blocks payment, return the reason and the cheapest compliant alternative.”

這樣會更有效，因為它明確告訴模型什麼時候允許付款、哪些工具行為是可接受的，以及付款被拒時該怎麼辦。

實際工作流程與品質建議

建議依照這個順序進行：

1. 先定義商業規則，再交辦任務。
2. 明確提供代理付款邊界。
3. 讓代理先嘗試目標呼叫。
4. 如果發生 402，讓 MCP 付款工具進行協商並重試。
5. 記錄付款決策與結果，方便稽核。

實務建議：

• 預算要跟任務綁定；太寬鬆的總預算會讓工具選擇變得鬆散。
• 當交易對象已知時，一律使用 allowlist。
• 若有多個付費工具會競爭資源，建議把這個技能和安全審查或成本感知編排搭配使用。
• 不要只測成功路徑，也要測拒絕路徑；現實中的失敗多半來自政策細節不足，而不是付款機制本身。

agent-payment-x402 技能常見問答

agent-payment-x402 適合初學者嗎？

部分適合。概念本身不複雜，但 agent-payment-x402 的安裝決策，取決於你是否已經理解 MCP 工具、錢包邊界與 402 流程。初學者可以先閱讀，但若要投入正式環境，通常更適合已經在用明確政策控制代理工具的團隊。

這個技能什麼情況適合、什麼情況不適合？

適合：自動購買 API 呼叫、服務存取，或在風險可控前提下進行 agent-to-agent 結算。不適合：人工結帳流程、消費者支付體驗、廣泛的資金庫管理，或需要人類逐筆核准每一筆交易的系統。這個技能本來就刻意做得很窄。

它和一般付款指令有什麼不同？

一般提示詞通常只停在「需要時就付款」。agent-payment-x402 指南更有用，因為它把付款定位成由 HTTP 語意觸發、受政策約束的工具動作。這個差異在編排場景特別重要，因為超支、收款方錯誤，或反覆重試都可能變成真正的失敗。

需要支援 x402 的生態系嗎？

實務上是的。這個技能預設環境中已有或可實作 x402 協商與 MCP 付款工具。如果你的供應商從不回傳 402，或你的代理無法存取錢包工具，這個技能雖然有參考價值，但無法直接部署。

如何改進 agent-payment-x402 技能

提供更精準的政策輸入

在 agent-payment-x402 的使用中，影響品質最大的槓桿就是政策精準度。請明確指定幣別、支出上限、允許收款方、重試上限，以及什麼情況算同一個任務或同一個工作階段。限制太模糊，代理要嘛付太多，要嘛在工具要求補齊條件時卡住。

預先想好常見失敗模式

常見問題包括：

• 沒有清楚的收款方 allowlist
• 預算只用敘述文字寫，沒有可供機器使用的值
• 付款被拒時沒有備援方案
• 以為所有付費端點在 402 後都會有相同行為
• 長時間編排時忘了設定工作階段級上限

只要出現其中一項，第一次輸出看起來可能沒問題，但實際上仍然不安全，不能直接執行。

先產出草稿，再做一次壓力測試

在模型提出流程之後，請它針對設計做壓力測試：

• “What happens if the service raises price after the first 402?”
• “How do you prevent repeated micro-payments?”
• “Which payments are allowed in this session, exactly?”
• “What event should stop retries?”

這些問題會迫使 agent-payment-x402 技能的輸出更明確，因為它們要求把操作邊界說清楚。

搭配相鄰控制機制一起使用

若想得到更好的正式環境結果，可以把 agent-payment-x402 for Agent Orchestration 與成本感知路由、稽核紀錄、安全審查一起搭配使用。這個技能最強的情境，是付款只是整體執行計畫中的一個受控步驟，而不是單獨存在的能力。