View a markdown version of this page

配置包 - 亚马逊基岩 AgentCore

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

配置包

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

重要概念

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

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

  • 分支组织版本谱系(例如,mainline,experiment-1)。

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

何时使用配置包

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

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

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

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