# AgentCore 支払いの主な概念
## 主要なペルソナ
AgentCore の支払いを操作するペルソナは、組織によって異なります。以下は、組織全体で見られる一般的なペルソナです。
1. **エージェント開発者**: エージェント開発者は、マイクロトランザクション支払いを実行して有料 APIs、MCP サーバー、ウェブコンテンツにアクセスする AI エージェントを構築します。支出ガードレールの設定、支払いアクティビティのモニタリング、ウォレット認証情報ポリシーの管理などの管理タスクを処理します。1 回限りのコントロールプレーンのセットアップ ( PaymentManagers と PaymentConnectors の作成) を実行し、エージェントコードを AgentCore 支払い SDK またはデータプレーン APIs と統合して、自動支払い実行を有効にします。
1. **エンドユーザー**: エンドユーザーはエージェントとやり取りして、特定の目標を達成します。これらは、暗号ベースの安定コインまたはクレジットカード (地理的制限による可用性の制限）、デビットカード、Apple Pay、Google Pay、ACH などの従来の支払い方法を通じてエージェント残高を補充できます。これにより、エージェントは支出許可、設定可能な支出制限、資金の使用方法に関する完全な透明性により、エージェントに代わってトランザクションを実行できます。
1. **事業者**: 事業者とは、API プロバイダー、コンテンツプロバイダー、サービスオペレーターであり、pay-per-use制モデルを通じてサービスを収益化します。料金を設定し、x402 支払いを受け入れ、支払い確認時にリクエストされたコンテンツまたはサービスを配信します。
## 主要なコンセプト
### PaymentManager
PaymentManager は、AI エージェントの支払いオペレーションを調整するために AWS アカウントで作成する最上位のリソースです。各 PaymentManager には、名前、エージェントがデータプレーン (`AWS_IAM` または `CUSTOM_JWT`) に対して認証する方法を制御するオーソライザー設定、およびサービスが実行時に引き受ける IAM ロールがあります。PaymentManager を作成すると、AgentCore 支払いは対応するワークロード ID を AgentCore Identity にプロビジョニングします。各 PaymentManager には一意の識別子と ARN があり、1 つ以上の PaymentConnectors を子リソースとして管理します。
PaymentManagersの整理方法は、ニーズによって異なります。たとえば、異なるエージェントアプリケーション、異なる環境 (本番稼働、ステージング、開発）、または組織内の異なるチームごとに PaymentManagers を分離します。
### PaymentConnector
PaymentConnector は PaymentManager を外部の支払いプロバイダーと統合します。各コネクタは AgentCore Identity に保存されている認証情報プロバイダーを参照し、API キーやウォレットシークレットなどの機密認証情報が Payments API に直接渡されないようにします。認証情報は AgentCore Identity を介して AWS Secrets Manager に保存され、ARN によって参照されます。PaymentConnector は 1 つの PaymentManager に属し、1 つの PaymentManager には複数のコネクタ (Coinbase の場合は 1 つ、Stripe の場合は 1 つなど) を含めることができます。AgentCore 支払いでは、次のコネクタタイプがサポートされています。
1. ** [CoinbaseCDP](https://docs.cdp.coinbase.com/wallets/non-custodial-wallets/overview) ** — 暗号化ウォレットオペレーションのために Coinbase 開発者プラットフォームに接続します。
1. ** [StripePrivy](https://docs.privy.io/wallets/overview/embedded) ** — プライベートウォレットインフラストラクチャを使用して Stripe に接続します。
### PaymentSession
PaymentSession は、単一のエージェントインタラクションの支出を追跡するスコープ付き支払いコンテキストです。各セッションには設定可能な有効期限があり、オプションで支払い制限を適用する使用制限 (`maxSpendAmount`、`currency`) を含めることができます。セッションの有効期限が切れるか、支払い制限に達すると、そのセッション内の追加の支払いリクエストは拒否されます。控除後に支払い署名が失敗した場合、金額は自動的にロールバックされます。
### PaymentInstrument
PaymentInstrument は、エージェントがユーザーに代わってマーチャントの支払いに使用する埋め込み暗号ウォレットを表します。各機器は特定のブロックチェーンネットワークに関連付けられ、、`INITIATED`、`ACTIVE`、`FAILED`または のいずれかのステータスになります`DELETED`。チェーン間で同じウォレットアドレスを使用できないため、デベロッパーはサポートされているネットワーク (Ethereum や Solana など) ごとに個別の計測器を維持します。サポートされている計測タイプは のみです`EMBEDDED_CRYPTO_WALLET`。
### PaymentCredentialProvider
PaymentCredentialProvider は、暗号化通貨の支払いプロトコル用に設計された AgentCore Identity の特殊な認証情報プロバイダーです。ベンダー固有の認証情報 (Coinbase CDP API キーとウォレットシークレット、または Privy アプリケーションの認証情報と認可キーなど) を AWS Secrets Manager に安全に保存します。実行時に、支払いサービスは AgentCore Identity `GetResourcePaymentToken` データプレーン API を介して認証トークンを取得します。各 PaymentConnector は PaymentCredentialProvider との 1:1 マッピングを維持します。
### x402 プロトコル
x402 プロトコルは、HTTP 402 ステータスコードをプログラムによる直接支払いに再利用するオープンな HTTP ネイティブ支払い標準です。エージェントが有料リソースをリクエストすると、マーチャントは金額、受取人、アセット、ネットワークを指定する支払いペイロード`402 Payment Required`を含む HTTP で応答します。エージェントは支払いに署名し、`X-PAYMENT`ヘッダーの署名付き証明を使用してリクエストを再試行します。マーチャントは支払いを確認し、コンテンツを配信します。
### マイクロトランザクション
マイクロトランザクションは、個々の API コール、ツール呼び出し、またはコンテンツアクセスに対する少額 (多くの場合、セント単位) の支払いです。従来の支払いシステムではトランザクションコストが最小限であるため、0.01 USD 未満の支払いでは非効率的です。AgentCore 支払いは、暗号通貨と安定コインを使用して、費用対効果の高いマイクロペイメントを可能にします。