配置捆绑包
配置包是代理动态配置的版本化、不可变的快照,包括系统提示、模型 ID、工具描述以及代理在运行时读取的任何其他键值对。Bundle 将代理行为与代码分离,使您无需重新部署代码即可更改代理的响应方式。
重要概念
-
组件由其配置的资源的 ARN(例如,运行时 ARN)进行键控。 AgentCore 每个组件都包含一个带有任意键值对的
configuration对象。 -
版本是不可变的。每次更新都会创建一个具有唯一 UUID 的新版本。版本通过形成链条
parentVersionIds,类似于 git 提交。 -
分支组织版本沿袭(例如
mainline、experiment-1)。 -
捆绑包名称必须以字母开头,可以包含字母、数字和下划线(无连字符)。图案:
[a-zA-Z][a-zA-Z0-9_]{0,99}。
何时使用配置包
-
A/B 测试。 A/B 测试中的每个变体都引用特定的捆绑包版本。网关将捆绑包引用注入到每个请求中。
-
建议。推荐 API 可以从捆绑包中读取当前配置,并将优化的配置写成新的捆绑包版本。
-
回滚。由于版本是不可变的,因此您可以通过引用其版本 ID 来回滚到任何以前的版本。
-
审计跟踪。版本链提供了完整的配置更改历史记录。