INTEGRITY Документация

Агентные платежи

ИИ-агентам нужно программно обнаруживать ресурсы и сервисы, оплачивать и использовать их. При традиционном подключении сначала требуется создать аккаунт, привязать способ оплаты и получить API-ключ, и только потом агент может оплатить услугу. Агентские платежи позволяют ИИ-агентам покупать ресурсы и сервисы напрямую через HTTP 402 Payment Required код ответа.

Cloudflare Agents SDK поддерживает агентные платежи через два протокола, построенных на основе HTTP 402 Payment Required код состояния: x402 и Machine Payments Protocol (MPP). Оба следуют одному и тому же базовому процессу:

  1. Клиент запрашивает ресурс или вызывает инструмент.
  2. Сервер возвращает платёжный Challenge, который описывает, что нужно оплатить, сколько и куда.
  3. Клиент совершает платёж и повторяет запрос с платёжными реквизитами.
  4. Сервер проверяет платёж (опционально через facilitator-сервис) и возвращает ресурс вместе с квитанцией.

Заранее созданная учётная запись службы или заранее переданный API-ключ не требуются. Обмен платежами выполняет Agents программно.

x402 и Machine Payments Protocol

x402

x402 ↗ это платёжный стандарт, созданный Coinbase. Он использует ончейн-платежи стейблкоинами (USDC в сетях Base, Ethereum, Solana и других) и определяет три HTTP-заголовка: PAYMENT-REQUIRED, PAYMENT-SIGNATURE, а также PAYMENT-RESPONSE : чтобы передавать challenge, учётные данные и квитанции. Серверы могут переложить проверку и расчёт на фасилитатор сервис, чтобы им не требовалось прямое подключение к блокчейну. Управление осуществляют Coinbase и Cloudflare, два из основателей x402 Foundation.

Agents SDK обеспечивает полноценную интеграцию с x402:

Machine Payments Protocol

Machine Payments Protocol (MPP) ↗ это открытый платёжный протокол. Он добавляет WWW-Authenticate: Payment и Authorization: Payment заголовки в HTTP 402 ответах.

Помимо блокчейнов, MPP поддерживает и другие способы оплаты, включая карты (через Stripe) и стейблкоины. mppx SDK поддерживает разовые, основанные на использовании и регулярные платежи. MPP также обратно совместим с x402: клиенты MPP могут использовать существующие сервисы x402 без изменений.

Создавайте с агентными платежами

HTTP-контент (x402)

Ограничивайте доступ к API, веб-страницам и файлам через прокси Worker

HTTP-контент (MPP)

Ограничивайте доступ к API, веб-страницам и файлам с помощью Worker mpp-proxy