方法 · · 1 分钟。阅读

为什么需要 Google Agent Platform:把代理层拆成单独的包

把代理相关的工具与平台通用 SDK 分开,并按自己的节奏更新。

简短回答

为什么要把代理层拆成单独的包?

2026 年 9 月 18 日的记录介绍了 Agent Platform SDK for Python 2.0.1 版本:生成式 AI 模块迁移到 Google Gen AI SDK,代理部分从 google-cloud-aiplatform 中分离为独立包,并重新梳理了命名空间。这种拆分划定了更新边界,缩小了变更范围。

Elena Artemova(叶莲娜·阿尔捷莫娃 / Елена Артемова) · 发布 · 更新 · 该工具的目的 · 附应用实例.

依赖也是一份时间表

当代理相关工具与平台相关工具处在同一个包中时,平台的每一次更新都可能波及代理。团队要么跟着平台一起升级,要么整体停留在旧版本上。

单独的包把这一切变成一种选择。代理层可以按自己的节奏更新、单独验证和回滚,而不牵动系统的其余部分。拆分的价值不在包的名称,而在于变更边界变得明确,可以纳入计划。

2.0.1 版本究竟改了什么

2026 年 9 月 18 日的记录说明,Agent Platform SDK for Python 的 2.0.1 版本把生成式 AI 模块迁移到 Google Gen AI SDK,把代理接口从 google-cloud-aiplatform 中分离到专门的包,并重新梳理命名空间。从旧包迁移另有一份单独发布的指南。

对代理系统而言,这尤其意味着可用模型的构成与代理工具的构成彼此独立地变化:同一条记录中还宣布了 Grok 4.6 模型的正式可用,而这对代理代码的结构没有影响。

重命名是另一项工作

重新梳理命名空间意味着这次升级是一个项目,而不是替换一个版本号。需要列出引用位置,确定迁移顺序,商定时间期限,并保留回到原状态的能力。

这类迁移的成本不是用改动行数来衡量,而是用必须同时改动的系统组成部分的数量来衡量。单步里能少改一部分,更新之后找出偏离原因的可能性就多一分。

何时不需要单独的包

对于只有一次模型调用的小任务,额外的一层可能显得多余:它增加了一个依赖,也增加了一份跟踪其版本的义务。当代理工具被多个团队或多个应用使用时,拆分才是划算的。

一个实际的判断标准是:如果代理部分的更新与平台的更新需要在不同的人之间协调,那么边界其实已经存在,问题只在于它是否被体现在包的结构里。

示例

迁移到独立包的计划

任务
在一个假想项目中,代理工具从平台的通用包中引入。需要在不停工的前提下迁移到单独的包。
工具的作用
先列出接入点清单,然后迁移其中一小部分并单独验证。在迁移完成之前,旧的方式保持可用。
预期结果
预期结果是迁移分部分进行,偏离可以在系统的所有部分都被改动之前就被发现。
要检查什么
如果迁移靠一次大改动完成,偏离的原因就很难与迁移本身区分开来。示例仅作说明。

单独的代理包是为了让代理的更新与平台的更新成为两个彼此独立的决定。

来源及原因

出版日期:

主要来源描述了该仪器及其开发。关于选择的结论 - 实验室的编辑分析。 一个例子解释了该工具的用途;没有对其进行任何测量。 来源日期已验证为 2026 年 9 月 8 日。

关于主题的问题

拆分包会加快工作吗?

它本身不会加快速度。它让变更边界变得明确,从而使更新可以分别规划。

小团队需要单独的包吗?

如果只有一个代理,且只在一个地方使用,额外的一层可能显得多余。

迁移之前要检查什么?

接入点清单、迁移顺序、时间期限,以及回到原状态的方式。