agents-build

docs(payments)：记录 WorkloadIdentity 名称小写化导致的 IAM 不匹配 + CloudTrail 调试回退 (#338) Co-authored-by: Khusbu Mishra

docs(payments)：Coinbase Marketplace 订阅、连接器状态以及 authorizationUrl 打开指南 (#320) - Marketplace 订阅（Coinbase 全局）：为何必需、合并账单 + SubscriptionRequiredException (403) 说明，以及订阅步骤（登录 AWS Console -> View purchase options -> 审阅条款 -> Subscribe）。 - 部署时遇到 SubscriptionRequiredException 的 Step 4 恢复：CLI 在同一个 CloudFormation 堆栈中同时预置 manager+connector，因此失败会回滚并删除 PaymentManager；通过 GetPaymentManager 重新检查，如果出现 ResourceNotFoundException，则从 Step 3a -> 3b -> deploy 重新开始。 - 连接器状态处理：在轮询循环和调试条目中，除 READY / AUTHENTICATION_EXPIRED / AUTHENTICATION_FAILED 外，新增 PROVISIONING（瞬态）和 AWS_MARKETPLACE_SUBSCRIPTION_REQUIRED（终态 -> 订阅后重新创建）。 - authorizationUrl 处理：更正为 AgentCore CLI 目前不会自动打开该 URL。由 agent 驱动：在开发者机器上通过操作系统打开器打开（open/xdg-open/start = 导航，而非 fetch）；无头/远程/CI -> 为开发者打印 URL。切勿 curl/HEAD/WebFetch/预览它（open != fetch）。 Co-authored-by: Khusbu Mishra

docs(agents-build)：记录 Tempo/MPP 网络、资金和调试 (#317) payments.md 的 MPP 部分涵盖了线上协议，但 Supported Networks 表和资金步骤仅针对 x402（Base Sepolia + Circle）。 接入“add MPP payments”的 Agents 被指向了错误的网络/资产 来为 Tempo 端点提供资金。 基于 AgentCore Payments ProcessPayment 4XX/5XX 运行手册新增： - MPP 网络/提供商/资金小节：Tempo 主网 (eip155:4217) 和 Moderato 测试网 (eip155:42431)，仅限 StripePrivy（Coinbase 无法 支付 Tempo），从 MPP 402 自动检测，规范稳定币 pathUSD - 通过 Tempo faucet 为 Tempo Moderato 提供资金的 Step 7 分支 - MPP 调试行：MPP_ACCESS_NOT_ALLOWLISTED、MPP_EVM_NON_CANONICAL_USDC、 TEMPO_INSUFFICIENT_BALANCE/memo、Coinbase-Tempo-unsupported - 澄清说明：x402 Chains 表不包含 Tempo（仅 MPP） Co-authored-by: Raju Ansari

fix(aws-agents)：更正 payments 参考中的 payment manager 名称规则 (#312) payments 参考中曾说明 payment manager 名称允许下划线。实际不允许：manager 名称必须仅包含字母数字。 Co-authored-by: Tushar Kapoor

docs(payments)：将 skill-onboarding 标签设为强制 (#297) 强化 Step 3a，使 agent 在部署前必须始终将 agentcore:onboarding-source 标签添加到 agentcore.json，并 添加匹配的 Quality criteria 项，以便通过 此 skill 预置的资源能够可靠地归因于它。

docs(payments)：Privy 委托上游 PR (#287) * payments：扩展 Stripe Privy 委托，加入前端设置演练 现有 Step 7 告诉 Privy 用户“使用 Privy 前端 SDK” 并附有链接，但没有可操作的说明。与 Coinbase（简单的 redirectUrl）不同，Privy 委托需要一个运行中的 Next.js 应用， 配置好环境变量，并使用 addSessionSigners 流程。 将 Step 7 中的 Stripe Privy 条目扩展为编码 agent 可自动化的 子步骤（7a-7e），并添加常见前端设置失败的调试条目。 * docs(payments)：复用 AgentCore Privy 凭据并允许本地源 处理关于 Stripe Privy 委托演练的评审反馈： - 7b 现在从 agentcore/.env.local 映射三个 Privy 值 （STRIPE_PRIVY_APP_ID / _APP_SECRET / _AUTHORIZATION_ID），而不是 将开发者送回仪表板。前端的变量名保持不变，因为 src/lib/env.ts 按字面读取 NEXT_PUBLIC_PRIVY_*； 仅来源列发生变化。 - 新增 7d：在 Configuration > App settings > Domains > Allowed origins 下添加开发服务器的源。Privy 会与浏览器源进行比较， 因此该值为 http://localhost:3000，不带尾部斜杠且 显式包含端口。委托和验证移至 7e/7f。 - Step 3b 不再声称没有内容复用提供商密钥； agent 仍不得读取 agentcore/.env.local，因此复制 是开发者步骤。 - 调试：新增允许源失败模式，环境变量条目 指向 agentcore/.env.local 键。 * docs(payments)：按后缀匹配连接器凭据，单行绝对路径复制 处理关于 #2 的三条评审意见： - CLI 写入的是带命名空间的键，而不是裸 STRIPE_PRIVY_*： AGENTCORE_CREDENTIAL___STRIPE_PRIVY_，其中 manager 和 connector 名称按项目选择。7b 现在告诉 skill 按 _STRIPE_PRIVY_ 后缀匹配，并添加一个 grep 列出实际键名（仅名称，不含值）。Step 3b 和 两个调试条目也如此说明。 - 映射片段为一行，而不是带 shell 函数的多行块， 并且直接写入 .env.local，因此不再需要 cp .env.example， 也不会出现重复键。 - 两个路径均为绝对路径；不假设 agent 项目为 cwd。 - 对于 grep 找不到任何内容的情况，现在明确提供仪表板回退， 并添加 cut -d= -f1 检查以捕获部分映射。 --------- Co-authored-by: Madeleine Charity Co-authored-by: Esteban Chirinos Co-authored-by: Aidan Daly

docs(payments)：添加 Coinbase QuickCreate 连接器流程 (#269) 在 agents-build payments skill 参考中记录 Coinbase QuickCreate 连接器流程。QuickCreate（'agentcore add payment-connector --provider CoinbaseCDP --provision-mode QUICK_CREATE'）通过 Coinbase 授权，并让 AgentCore Payments 预置和存储凭据提供商，因此无需输入或存储 API 密钥或钱包密钥。已添加为推荐的 Coinbase 路径；手动输入密钥仍是替代方案，也是 Stripe (Privy) 的唯一路径。 - Step 3b 重构为两种凭据模式（QuickCreate 与 Manual）；执行模型、Step 2、Step 4（部署触发浏览器授权）、Security Considerations 和 Quality criteria 相应更新。 - authorizationUrl 有效期为 10 分钟且单次使用：直接在浏览器中打开一次，不要让 Slack/聊天展开它或让 agent 获取它；添加了匹配的 Debugging 条目。 - 轮询 GetPaymentConnector 直到状态为终态（READY / AUTHENTICATION_EXPIRED / AUTHENTICATION_FAILED）。READY = 可使用，无需操作；AUTHENTICATION_EXPIRED/AUTHENTICATION_FAILED = 替换连接器（通过 QuickCreate 删除 + 重新创建以获得新的 authorizationUrl）。 - 在 AgentCore CLI 上使用 --provision-mode QUICK_CREATE，与公开入门文档一致。 Co-authored-by: Khusbu Mishra

docs(agents-build)：使支付凭据步骤与 AWS 先决条件一致 (#256) 更新 Step 3b 凭据获取说明，以匹配 AgentCore Payments 先决条件文档中的确切提供商控制台位置： - Coinbase：在 portal.cdp.coinbase.com/api-keys/secret 生成 API 密钥； Wallet Secret 和 Delegated signing 位于 Project > Wallets > Non-custodial Wallet > Security（之前是过时的 Embedded Wallets 路径） - Privy：App ID/Secret 位于 App settings > Basics > API Keys；Authorization ID 和 Private Key 位于 Wallet Infrastructure > Keys and quorums 同时删除过时的 wallet-auth: 前缀剥离步骤（不再需要）。

feat(agents-build)：记录 MPP 支付与 x402 并存 (#228) * feat(agents-build)：记录 MPP 支付与 x402 并存 扩展 payments 参考和 skill 触发器，以覆盖 MPP（Machine Payments Protocol），作为 AgentCore Payments 除 x402 之外支持的第二种协议。两者都通过相同的 ProcessPayment API 和相同的 manager/connector/instrument/session 资源；不预先选择协议。 payments.md： - 在引言和 When-to-use 中注明协议无关支持 - 添加“MPP (Machine Payments Protocol)”部分：线上差异表 （WWW-Authenticate: Payment challenge / Authorization: Payment credential / Payment-Receipt）、带 mpp 分支的 MPP ProcessPayment 请求/响应契约 （version、逐字 wwwAuthenticateHeaders、buyerPaysGasFees）、 基于实际的说明，以及端到端流程图 - 添加 MPP 调试条目（gas-fee ValidationException、格式错误/ 多 header ValidationException、重试后 fresh-402、403 SubscriptionRequiredException）和两个质量准则 SKILL.md： - 添加 MPP 触发器，并将 MPP 关键词路由到 payments 参考 契约基于 AmazonBedrockAgentCorePaymentsDataPlaneModel Smithy 模型，并针对 bedrock_agentcore payments SDK 的 MPP 路径验证（逐字 header 转发、paymentType=MPP、返回 Authorization: Payment credential）。 * refactor(agents-build)：将 x402_payment_tool.py 重命名为 process_payment_tool.py 该工具现在同时处理 x402 和 MPP（它将 402 转发给 SDK 的 generate_payment_header，后者将 WWW-Authenticate: Payment 路由到 MPP ProcessPayment 路径），因此协议中立的名称更清晰。更新 模块 docstring 和 payments.md 中的所有引用（文件路径、markdown 链接和 import 语句）。导出的 x402_fetch 函数名保持不变，以避免 接线片段中的变动。 * fix(agents-build)：将 SKILL.md 描述裁剪到 1024 字符限制以下 最近的 MPP 支付触发器将 agents-build 描述推到 1124 字符，超过规范的 1024 限制。移除冗余的 近似重复支付触发器；现在为 990 字符。 --------- Co-authored-by: Raju Ansari

docs(agents-build)：记录 x402 upto 方案 + Permit2 授权额度 (#244) 在 payments skill 中添加简短的“The upto scheme and Permit2 allowance”部分。设置/接线步骤与方案无关（agent 透传商家声明的任意 x402 方案）；本节解释 upto 方案（计量 / 按推理付费）及其一个附加项 — permit2_allowance_limit， 它授予钱包的 Permit2 授权额度，以便 ProcessPayment 可以提交 一次性链上 approve。涵盖 uint256 最大值无限制值、 仅 upto / gas / 仅首次使用的注意事项，以及 SDK 版本依赖，另加 一行指向通用 x402_fetch 工具的说明。 仅文档 — 无工具或环境变量变更。依赖 bedrock-agentcore-sdk-python-private PR #165（添加 permit2_allowance_limit）。 公开文档在草稿 CR-295342407 中。

fix(agents-build)：将支付触发器聚焦于构建时用例 (#217) * fix(agents-build)：将支付触发器聚焦于构建时用例 将运行时支付触发器替换为构建时等价项，并添加 指向 agents-pay 的反向指针以用于运行时支付场景。 移除的触发器：'pay for x402 content'、'402 Payment Required'、 'microtransactions'、'paid API or tool'。 新增的触发器：'add payments capability to my agent'、'wire payments plugin'、'payments middleware for my agent'。 新增：'Not for THIS agent paying for x402 content at runtime — use agents-pay.' * fix(agents-build)：添加上下文相关的 x402 触发器 * fix(agents-build)：使描述符合插件限制

feat：支持 Agent Plugins v1.0.0 (#214) * feat：支持 Agent Plugins v1.0.0 添加根 plugin.json 和 mcp.json，将 aws-core hooks 移至 com.anthropic.claude-code 命名空间下，在规范源中修复 skill frontmatter， 并添加接入 mise run validate 的一致性验证器。 Frontmatter 编辑在 skills/ 中进行，并通过 tools/sync-plugin-skills.py 传播到插件副本， 因此 lint:skill-parity 保持通过。 * fix：通过 manifest 指针恢复 Codex hook 加载

feat(aws-agents)：更新 AgentCore Payments Skill 以纳入 LangGraph 和 Strands … (#170) * 更新 AgentCore Payments Skill 以纳入 LangGraph 和 Strands 插件/中间件集成。 更新 payments skill，以澄清集成选项并简化 Strands 和 LangGraph 框架的说明。 * fix(skill) - 移除不准确的 instrument 创建说明 澄清使用 LangGraph 且 auto_session=True 的说明，明确不要使用 --budget 标志。之前关于 "--no-session" 标志的说明是错误的。 * fix(skill) - 更新 payments skill 中的 LangGraph 代码示例 更新 LangGraph 代码示例，更明确地说明 config 中的 auto_session --------- Co-authored-by: Tejas Kashinath

feat(aws-agents)：为 skill 引导的支付项目打上 agentcore:onboarding-source 标签 (#162) /payments skill 通过 agentcore CLI 预置控制平面资源，而 CLI 只会打上通用的 agentcore:created-by=agentcore-cli 项目标签。这使得通过此 skill 引导的资源 与直接使用 CLI 无法区分。 在 'agentcore add payment-manager' 之后添加一个步骤，指示 agent 将 agentcore:onboarding-source=agent-toolkit-skill 添加到项目的 tags 中的 agentcore.json。项目标签会在 部署时流向预置资源，使 AgentCore Payments 服务能够在下游将引导归因于 该 skill（而非裸 CLI）。 Co-authored-by: Joseph Vidal Co-authored-by: Tejas Kashinath

feat(aws-agents)：添加 AgentCore Payments skill 参考 (#118) * feat(aws-agents)：添加 AgentCore Payments skill 参考 向 agents-build skill 添加 CLI 优先的 AgentCore Payments 参考： 通过 agentcore CLI 管理控制平面资源（manager、connector）， 通过 SDK 管理数据平面（instrument、session），以及一个框架无关的 x402_fetch 本地工具，用于结算 402 响应，并在支付后瞬态 402 时重试最多 X402_MAX_PAYMENT_ATTEMPTS 次。 - 包含详细的提供商凭据步骤（Coinbase CDP、Stripe Privy） - 用于架构查询的 Case D - 全面的调试、安全、网络和流程文档 - 修复 wizard 与 flags 的 CLI 行为说明 * fix(aws-agents)：调整 payments 触发器以避免路由回归 跨六个模型（Claude Sonnet/Opus/Haiku、Nova Pro、 Llama 3.3）的路由评估显示，初始 payments 触发器使 Claude 模型上的两个边界提示发生偏移：一个 memory-bug 提示漂移到 agents-debug， 而 "What is AgentCore?" 开始弃权。 移除边缘性的 "add payments" 触发器和第 1 行能力 词；保留四个支付触发短语以及路由表行。 现在路由在 6 个模型中的 5 个上与 main 相比保持中性（Haiku 在一个通用 问题上 -1），而 payments 提示仍路由到 agents-build。 * fix(aws-agents)：处理关于 payments skill 的评审反馈 - 修复损坏的 Step 4 代码块；将 wizard 说明移至 Step 3b - 将 CLI 版本门槛提高到 >= 0.20.0（payment 命令为预览版） - 使用 SDK generate_payment_header 而不是手写的 v1/v2 证明 - 在重试之间复用一个幂等令牌以防止重复扣费 - 将连接器 wizard 更正为无标志命令 - 重新排序 Step 3b，使凭据先决条件位于命令之前

feat：添加 aws-agents 插件 (#20) * feat：添加 aws-agents 插件 * 重命名 skill 前缀