View a markdown version of this page

配置捆绑包 - Amazon Bedrock AgentCore

配置捆绑包

配置包是代理动态配置的版本化、不可变的快照,包括系统提示、模型 ID、工具描述以及代理在运行时读取的任何其他键值对。Bundle 将代理行为与代码分离,使您无需重新部署代码即可更改代理的响应方式。

重要概念

  • 组件由其配置的资源的 ARN(例如,运行时 ARN)进行键控。 AgentCore 每个组件都包含一个带有任意键值对的configuration对象。

  • 版本是不可变的。每次更新都会创建一个具有唯一 UUID 的新版本。版本通过形成链条parentVersionIds,类似于 git 提交。

  • 分支组织版本沿袭(例如mainlineexperiment-1)。

  • 捆绑包名称必须以字母开头,可以包含字母、数字和下划线(无连字符)。图案:[a-zA-Z][a-zA-Z0-9_]{0,99}

何时使用配置包

  • A/B 测试。 A/B 测试中的每个变体都引用特定的捆绑包版本。网关将捆绑包引用注入到每个请求中。

  • 建议。推荐 API 可以从捆绑包中读取当前配置,并将优化的配置写成新的捆绑包版本。

  • 回滚。由于版本是不可变的,因此您可以通过引用其版本 ID 来回滚到任何以前的版本。

  • 审计跟踪。版本链提供了完整的配置更改历史记录。