Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Crea uno strumento di pagamento
Uno strumento di pagamento rappresenta un portafoglio crittografico incorporato che un agente utilizza per pagare i commercianti per conto di un utente. Ogni strumento è associato a una rete blockchain specifica. Il valore della ETHEREUM rete copre la rete principale di Ethereum e tutte le reti EVM-compatible Layer 2 supportate (Base, Arbitrum e altre). Per lo schema completo di richiesta e risposta, consulta l'API CreatePaymentInstrument Reference.
Puoi automatizzare i passaggi in questa pagina con l'abilità AgentCore Payments nel toolkit per AWS agenti. L'abilità fa parte del plug-in aws-agents e consente a un agente di codifica AI di creare il Payment Manager, il connettore, il fornitore di credenziali, lo strumento di pagamento e la sessione utilizzando la agentcore CLI e aggiungere uno strumento di elaborazione dei pagamenti all'agente. Per i dettagli, consulta il quickstart e il toolkit per gli agenti attivi. AWS GitHub
Esempio
- AgentCore SDK
-
from bedrock_agentcore.payments import PaymentManager
manager = PaymentManager(
payment_manager_arn=mgr["paymentManagerArn"],
region_name="us-west-2"
)
# Create payment instrument (Ethereum)
instrument = manager.create_payment_instrument(
user_id="test-user-123",
payment_connector_id=PAYMENT_CONNECTOR_ID,
payment_instrument_type="EMBEDDED_CRYPTO_WALLET",
payment_instrument_details={"embeddedCryptoWallet": {"network": "ETHEREUM",
"linkedAccounts": [{
"email": {
"emailAddress": "myemail@example.com"
}
}]
}},
)
Per una catena compatibile con Solana, usa enum SOLANA per l'input di rete.
- AWS CLI
-
aws bedrock-agentcore create-payment-instrument \
--payment-manager-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager" \
--payment-connector-id "my-connector-id" \
--user-id "test-user-123" \
--payment-instrument-type "EMBEDDED_CRYPTO_WALLET" \
--payment-instrument-details '{
"embeddedCryptoWallet": {
"network": "ETHEREUM",
"linkedAccounts": [{"email": {"emailAddress": "myemail@example.com"}}]
}
}' \
--client-token "$(uuidgen)" \
--region us-west-2
Per la catena compatibile con Solana, usa. "network": "SOLANA"
- AWS SDK
-
import boto3
import uuid
dp_client = boto3.client("bedrock-agentcore", region_name="us-west-2",
endpoint_url="https://bedrock-agentcore.us-west-2.amazonaws.com")
# Create payment instrument (Ethereum)
instrument = dp_client.create_payment_instrument(
userId="test-user-123",
paymentManagerArn=PAYMENT_MANAGER_ARN,
paymentConnectorId=PAYMENT_CONNECTOR_ID,
paymentInstrumentType="EMBEDDED_CRYPTO_WALLET",
paymentInstrumentDetails={
"embeddedCryptoWallet": {
"network": "ETHEREUM",
"linkedAccounts": [{
"email": {
"emailAddress": "myemail@example.com"
}
}]
},
},
clientToken=str(uuid.uuid4()),
)
Per la catena compatibile con Solana, usa enum SOLANA per l'ingresso di rete.
Una volta creato lo strumento di pagamento, l'utente finale deve finanziare lo strumento e concedere le autorizzazioni di firma prima che l'agente possa elaborare i pagamenti. Per istruzioni dettagliate, consulta Finanziare il portafoglio e concedere le autorizzazioni all'agente.
Ottieni uno strumento di pagamento
Esempio
- AgentCore SDK
-
instrument = manager.get_payment_instrument(
user_id="test-user-123",
payment_instrument_id="payment-instrument-abc123"
)
print(f"Status: {instrument['status']}")
- AWS CLI
-
aws bedrock-agentcore get-payment-instrument \
--payment-manager-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager" \
--payment-instrument-id "payment-instrument-abc123" \
--user-id "test-user-123" \
--region us-west-2
- AWS SDK
-
response = dp_client.get_payment_instrument(
paymentManagerArn=PAYMENT_MANAGER_ARN,
paymentInstrumentId="payment-instrument-abc123"
)
print(f"Status: {response['status']}, Network: {response['paymentInstrumentDetails']['embeddedCryptoWallet']['network']}")
Elenca gli strumenti di pagamento
Esempio
- AgentCore SDK
-
instruments = manager.list_payment_instruments(
user_id="test-user-123"
)
for inst in instruments['paymentInstruments']:
print(f"{inst['paymentInstrumentId']} - {inst['status']}")
- AWS CLI
-
aws bedrock-agentcore list-payment-instruments \
--payment-manager-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager" \
--user-id "test-user-123" \
--region us-west-2
- AWS SDK
-
response = dp_client.list_payment_instruments(
paymentManagerArn=PAYMENT_MANAGER_ARN,
userId="test-user-123"
)
for inst in response['paymentInstruments']:
print(f"{inst['paymentInstrumentId']} - {inst['status']}")
Controlla il saldo dello strumento
Esempio
- AgentCore SDK
-
balance = manager.get_payment_instrument_balance(
user_id="test-user-123",
payment_instrument_id="payment-instrument-abc123"
)
print(f"Balance: {balance['amount']} {balance['currency']}")
- AWS CLI
-
aws bedrock-agentcore get-payment-instrument-balance \
--payment-manager-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager" \
--payment-instrument-id "payment-instrument-abc123" \
--region us-west-2
- AWS SDK
-
response = dp_client.get_payment_instrument_balance(
paymentManagerArn=PAYMENT_MANAGER_ARN,
paymentInstrumentId="payment-instrument-abc123"
)
print(f"Balance: {response['amount']} {response['currency']}")
Eliminare uno strumento di pagamento
Esempio
- AgentCore SDK
-
manager.delete_payment_instrument(
user_id="test-user-123",
payment_instrument_id="payment-instrument-abc123"
)
- AWS CLI
-
aws bedrock-agentcore delete-payment-instrument \
--payment-manager-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager" \
--payment-instrument-id "payment-instrument-abc123" \
--region us-west-2
- AWS SDK
-
dp_client.delete_payment_instrument(
paymentManagerArn=PAYMENT_MANAGER_ARN,
paymentInstrumentId="payment-instrument-abc123"
)
