INTEGRITY Dokumentace

Agentní platby

AI agenti potřebují prostředky a služby programově objevovat, platit za ně a využívat je. Tradiční onboarding vyžaduje vytvoření účtu, platební metodu a API klíč ještě předtím, než agent může za službu zaplatit. Agentní platby umožňují AI agentům nakupovat prostředky a služby přímo prostřednictvím HTTP 402 Payment Required kód odpovědi.

Cloudflare Agents SDK podporuje agentické platby prostřednictvím dvou protokolů postavených na HTTP 402 Payment Required stavový kód: x402 a Machine Payments Protocol (MPP). Oba se řídí stejným základním postupem:

  1. Klient požaduje resource nebo volá nástroj.
  2. Server vrací platební Challenge, který popisuje, co zaplatit, kolik a kam.
  3. Klient provede platbu a požadavek zopakuje s platebním pověřením.
  4. Server ověří platbu (volitelně prostřednictvím facilitátorské služby) a vrátí prostředek spolu s potvrzením.

Není potřeba žádný předem vytvořený servisní účet ani předsdílený API klíč. Výměnu platby zajišťuje Agents programově.

x402 a Machine Payments Protocol

x402

x402 ↗ je platební standard vytvořený společností Coinbase. Využívá on-chain platby ve stablecoinech (USDC na sítích Base, Ethereum, Solana a dalších) a definuje tři HTTP hlavičky: PAYMENT-REQUIRED, PAYMENT-SIGNATURE, a PAYMENT-RESPONSE : k přenosu výzev, přihlašovacích údajů a potvrzenek. Servery mohou ověření a vypořádání přenechat facilitátor služby, takže nepotřebují přímé připojení k blockchainu. Řídí ji Coinbase a Cloudflare, dva ze zakládajících členů x402 Foundation.

Agents SDK poskytuje plnohodnotnou integraci x402:

Machine Payments Protocol

Machine Payments Protocol (MPP) ↗ je otevřený platební protokol. Přidává WWW-Authenticate: Payment a Authorization: Payment hlavičky do HTTP 402 .

MPP podporuje více platebních metod nad rámec blockchainů, včetně karet (přes Stripe) a stablecoinů. mppx SDK podporuje jednorázové, na základě využití účtované i opakující se platby. MPP je zároveň zpětně kompatibilní s x402: klienti MPP mohou využívat existující služby x402 beze změny.

Stavte s agentickými platbami

Obsah HTTP (x402)

Řiďte přístup k rozhraním API, webovým stránkám a souborům pomocí proxy Workeru

Obsah HTTP (MPP)

Řiďte přístup k rozhraním API, webovým stránkám a souborům pomocí Workeru mpp-proxy