Konsep inti untuk AgentCore pembayaran
Persona kunci
Persona yang berinteraksi dengan AgentCore pembayaran dapat bervariasi dari satu organisasi ke organisasi lainnya. Berikut ini adalah persona umum yang ditemukan di seluruh organisasi.
-
Pengembang agen: Pengembang agen membangun agen AI yang melakukan pembayaran transaksi mikro untuk mengakses API berbayar, server MCP, dan konten web. Mereka menangani tugas-tugas administratif seperti mengonfigurasi pagar pembatas pengeluaran, memantau aktivitas pembayaran, dan mengelola kebijakan kredensi dompet. Mereka melakukan pengaturan pesawat kontrol satu kali (membuat PaymentManagers dan PaymentConnectors) dan mengintegrasikan kode agen mereka dengan SDK AgentCore pembayaran atau API pesawat data untuk mengaktifkan eksekusi pembayaran otonom.
-
Pengguna akhir: Pengguna akhir berinteraksi dengan agen untuk mencapai tujuan tertentu. Mereka dapat mengisi saldo agen melalui stablecoin berbasis kripto atau metode pembayaran tradisional seperti Kartu kredit (ketersediaan terbatas karena batasan geografis), kartu Debit, Apple Pay, Google Pay, atau ACH sehingga agen dapat melakukan transaksi atas nama mereka, dengan izin pengeluaran, batas pengeluaran yang dapat dikonfigurasi, dan transparansi penuh tentang bagaimana dana mereka digunakan.
-
Merchant: Merchant adalah penyedia API, penyedia konten, dan operator layanan yang memonetisasi penawaran mereka melalui model bayar per penggunaan. Mereka menetapkan harga, menerima pembayaran x402, dan mengirimkan konten atau layanan yang diminta setelah konfirmasi pembayaran.
Konsep Utama
PaymentManager
A PaymentManager adalah sumber daya tingkat atas yang Anda buat di AWS akun Anda untuk mengoordinasikan operasi pembayaran untuk agen AI Anda. Masing-masing PaymentManager memiliki nama, konfigurasi otorisasi yang mengontrol cara agen mengautentikasi ke bidang data (AWS_IAMatauCUSTOM_JWT), dan peran IAM yang diasumsikan layanan saat runtime. Saat Anda membuat PaymentManager, AgentCore pembayaran memberikan identitas beban kerja yang sesuai di AgentCore Identity. Masing-masing PaymentManager memiliki pengenal unik dan ARN, dan mengelola satu atau PaymentConnectors lebih sebagai sumber daya anak.
Bagaimana Anda mengatur PaymentManagers tergantung pada kebutuhan Anda. Misalnya, pisahkan PaymentManagers untuk aplikasi agen yang berbeda, lingkungan yang berbeda (produksi, pementasan, pengembangan), atau tim yang berbeda dalam organisasi Anda.
PaymentConnector
A PaymentConnector mengintegrasikan Anda PaymentManager dengan penyedia pembayaran eksternal. Setiap konektor mereferensikan penyedia kredensi yang disimpan di AgentCore Identity, memastikan bahwa kredensi sensitif seperti kunci API dan rahasia dompet tidak pernah diteruskan langsung ke API Pembayaran. Kredensi disimpan di AWS Secrets Manager melalui AgentCore Identity dan direferensikan oleh ARN. A PaymentConnector milik persis satu PaymentManager, dan satu PaymentManager dapat memiliki beberapa konektor (misalnya, satu untuk Coinbase dan satu lagi untuk Stripe). AgentCore pembayaran mendukung jenis konektor berikut:
-
CoinBaseCDP
— Terhubung ke Platform Pengembang Coinbase untuk operasi dompet kripto. -
StripePrivy
— Terhubung ke Stripe dengan infrastruktur dompet Privy.
PaymentSession
A PaymentSession adalah konteks pembayaran terbatas yang melacak pengeluaran untuk interaksi agen tunggal. Setiap sesi memiliki durasi kedaluwarsa yang dapat dikonfigurasi dan secara opsional dapat menyertakan batas pengeluaran (maxSpendAmount,currency) yang memberlakukan batas pembayaran. Ketika sesi berakhir atau batas pembayaran tercapai, permintaan pembayaran lebih lanjut dalam sesi tersebut ditolak. Jika penandatanganan pembayaran gagal setelah dikurangi, jumlahnya akan dikembalikan secara otomatis.
PaymentInstrument
A PaymentInstrument mewakili dompet kripto tertanam yang digunakan agen untuk membayar pedagang atas nama pengguna. Setiap instrumen dikaitkan dengan jaringan blockchain tertentu dan memiliki salah satu status berikut:INITIATED,, ACTIVEFAILED, atauDELETED. Karena alamat dompet yang sama tidak dapat digunakan di seluruh rantai, pengembang memelihara instrumen terpisah untuk setiap jaringan yang didukung (misalnya, Ethereum dan Solana). Satu-satunya jenis instrumen yang didukung adalahEMBEDDED_CRYPTO_WALLET.
PaymentCredentialProvider
A PaymentCredentialProvider adalah penyedia kredensi khusus di AgentCore Identity yang dirancang untuk protokol pembayaran cryptocurrency. Ini dengan aman menyimpan kredensi khusus vendor (seperti kunci API CDP Coinbase dan rahasia dompet, atau kredensi aplikasi Privy dan kunci otorisasi) di Secrets Manager. AWS Saat runtime, layanan Pembayaran mengambil token otentikasi melalui API bidang GetResourcePaymentToken data AgentCore Identity. Masing-masing PaymentConnector mempertahankan pemetaan 1:1 dengan a. PaymentCredentialProvider
protokol x402
Protokol x402 adalah standar HTTP-native pembayaran terbuka yang menggunakan kembali kode status HTTP 402 untuk pembayaran langsung dan terprogram. Saat agen meminta sumber daya berbayar, merchant merespons dengan HTTP 402 Payment Required termasuk payload pembayaran yang menentukan jumlah, penerima, aset, dan jaringan. Agen menandatangani pembayaran dan mencoba kembali permintaan dengan bukti yang ditandatangani di X-PAYMENT header. Pedagang memverifikasi pembayaran dan mengirimkan konten.
Transaksi Mikro
Transaksi mikro adalah pembayaran bernilai kecil (seringkali dalam sen) untuk panggilan API individu, pemanggilan alat, atau akses konten. Sistem pembayaran tradisional memiliki biaya transaksi minimum, membuatnya tidak efisien untuk pembayaran di bawah $0,01. AgentCore pembayaran menggunakan cryptocurrency dan stablecoin untuk memungkinkan pembayaran mikro yang hemat biaya.
