View a markdown version of this page

AgentCore 付款疑难解答 - Amazon Bedrock AgentCore
验证错误权限错误未找到资源错误冲突错误服务配额错误节流错误付款处理错误服务器错误数

AgentCore 付款疑难解答

本节提供使用 AWS Amazon Bedrock AgentCore 付款时常见错误的解决方案。

验证错误

创建或更新付款资源时，该服务会返回ValidationException。下表列出了常见的验证错误及其解决方法。

错误消息 解决方案

roleArn must contain a valid account ID

roleArn必须是有效的 IAM 角色 ARN，账户编号为 12 位。验证格式：arn:aws:iam::<accountId>:role/<roleName>。

roleArn must belong to your account

中的账户 ID roleArn 必须与来电者的账户相匹配。 Cross-account 不支持角色。

Invalid role ARN: {roleArn}

roleArn无法解析。验证 ARN 格式。

credentialProviderConfigurations list cannot be empty

创建或更新支付连接器时，请至少提供一个凭证提供商配置。

credentialProviderArn is required but not found in the request

每个凭证提供商配置都必须包含。credentialProviderArn首先使用创建凭证提供程序创建一个。

Connector type '{type}' does not match the provided credentialProviderConfiguration

凭证提供程序配置变体必须与连接器类型相匹配。例如，CoinbaseCDP连接器需要coinbaseCDP配置，而不是stripePrivy。

还强制执行字段命名限制：

  • 付款经理姓名必须以字母开头，并且仅包含字母数字字符（最多 48 个字符）。

  • 支付连接器名称遵循相同的规则，但也允许使用下划线。

  • 描述允许使用字母数字字符和空格（最多 4096 个字符）。

权限错误

错误消息 解决方案

Access denied due to account security restrictions. Contact AWS Support for assistance.

您的账户已被限制。请联系 S AWS upport 以解决问题。

Access denied for {CREATE|UPDATE} due to account security restrictions. Contact AWS Support for assistance.

您的账户处于访问受限状态。允许读取和列出操作，但在限制得到解决之前，创建和更新操作将受到限制。

IAM Sigv4 授权失败

确保主叫方具有适当的bedrock-agentcore:权限。该服务使用带有签名名称的 Sigv4 bedrock-agentcore 签名。

PassRole 失败

提供时roleArn，调用者必须拥有该角色的iam:PassRole权限。角色的信任策略必须允许bedrock-agentcore.amazonaws.com作为服务主体。

未找到资源错误

错误消息 解决方案

Payment manager not found: {managerId}

指定的付款管理器不存在。致电验证身份ListPaymentManagers。

Payment connector not found: connectorId={connectorId}, managerId={managerId}

指定的连接器在给定的管理器下不存在。使用验证两个 ID ListPaymentConnectors。

期间未找到资源 CreatePaymentConnector

父付款管理器不存在。首先创建付款管理器。

冲突错误

ConflictException当两个请求同时修改同一个资源时，或者在创建已存在的资源时，该服务会返回。重试请求。创建和更新操作clientToken支持安全重试。

服务配额错误

"{limitType} limit exceeded for account {accountId}"当您达到账户的付款管理器或连接器的最大数量时，该服务就会返回。删除未使用的资源或联系 S AWS upport 申请提高限制。

节流错误

"Rate exceeded"当请求速率超过允许的限制时，服务就会返回。在重试逻辑中使用抖动实现指数退避。如果您一直达到极限，请联系 Supp AWS ort。

付款处理错误

如果外部支付提供商拒绝签名请求，则该服务将返回AccessDeniedException或ValidationException。下表列出了常见错误及其解决方法。

错误消息 解决方案

Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.

您尚未授予允许您的代理人代表您签署交易的委托权限，或者您之前已撤销该权限。要解决这个问题，请执行以下操作：

  1. 从CreatePaymentInstrument或GetPaymentInstrument响应正文 (paymentInstrumentDetails.redirectUrl) 中检索 WalletHub URL。

  2. 将用户重定向到 WalletHub。

  3. 登录并向代理授予签名权限。

有关处理委托拨款流程的前端实现的更多信息，请参阅网站上的 Coinbase AgentCore 模板。 GitHub 有关为钱包注资的更多信息，请参阅为钱包注资。

Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.

您的 Coinbase 开发者平台项目未配置委托签名。要解决这个问题，请执行以下操作：

  1. 在 Coinbase 网站上登录 Coinbase 开发者平台。

  2. 导航到项目的策略设置。

  3. 启用 “委托签名” 开关。

您必须先完成此步骤，您的代理才能代表用户签署交易。

Privy credentials are invalid. Please verify the credential configuration.

您的凭证提供商的 Privy 钱包授权密钥无效或已过期。要解决这个问题，请执行以下操作：

  1. 登录 Privy 网站上的 Privy 控制面板。

  2. 导航到应用程序的设置并验证授权密钥是否处于活动状态。

  3. 使用当前密钥更新 Ident AgentCore ity 中的凭证提供者。为此，请在 Secrets Manager 中调用UpdatePaymentConnector或更新 AWS 密钥。

有关凭据配置的更多信息，请参阅网站上的 Privy AgentCore SDK。 GitHub

服务器错误数

服务因内部错误"Something went wrong in processing your request"而返回。稍等片刻后重试请求。如果错误仍然存在，请使用x-amzn-requestid响应标头中的请求 ID 与 Support 联系 AWS 。