Gemini Enterprise DevEx 项目通过端到端开发流程测试发现并修复部署阻力,本轮重点改进前置条件、扩展配置安全和策略执行说明。更新后的文档与标准代码示例覆盖 Agent Gateway 和 Semantic Governance 配置。
在 Google Cloud,我们相信,构建企业级 AI 解决方案,除了强大的模型,还需要一个能让所有开发者顺畅完成端到端开发的平台。这正是 Gemini Enterprise 开发者体验(DevEx)计划的核心使命。
这项持续推进的计划,致力于完全站在开发者的视角,对我们自己的工具进行压力测试。方法直接而有效:在每轮 sprint 中,团队都会走完一组固定的开发者工作流,全程不使用内部凭据,也不走任何捷径。我们记录开发者可能遇到的每一处阻碍,并直接与工程团队合作,快速推动系统性改进。发现阻碍只是闭环的一半,迅速消除阻碍才是另一半。对你而言,这意味着更直观、可靠、安全的开发体验,各个构建组件都能正常协同工作。
治理是企业级 AI 的基石,因为它能让 Agent 的运行更安全、更可预测,也更符合合规要求。为了创造最大价值,DevEx 团队在本轮 sprint 中聚焦治理,并梳理了 Gemini Enterprise 上一条核心的端到端治理路径。我们的测试严格按照依赖顺序,覆盖以下工作流:
工作流 1 | 为 Agent 配置受治理的身份: 每个 Agent 都会获得唯一、专属的身份,该身份会被自动创建和撤销,并按照最小权限原则,仅获得访问所需资源的权限。
工作流 2 | 注册 Agent,纳入治理: Agent 会在 Agent Registry 中注册并编入目录,以便被发现,并能在网关访问策略中被引用。
工作流 3 | 将 Agent 绑定到网关: Agent 流量通过 Agent Gateway 路由,让所有交互都经过一个默认拒绝的统一策略执行点。
工作流 4 | 应用策略与内容安全防护: 执行访问策略,例如确定性的 IAM/IAP 策略和使用自然语言编写的 Semantic Governance 规则,并在入站和出站流量上启用 Model Armor。
工作流 5 | 发起请求并验证策略执行: 能够通过受治理的 Agent 发送真实请求,并进行端到端确认:已获授权的操作能够成功,未经授权的操作会被阻止,每一次决策都记录在可审计的轨迹中。
通过本轮 sprint 的用户旅程测试,我们发现并解决了 Agent 治理产品在文档和集成方面的阻碍。已解决的主要问题包括:
明确治理配置的前置条件(工作流 3 和 4): 为了让配置过程更顺畅,我们更新了《Troubleshooting Agent Gateway》指南,明确指出启用 Identity-Aware Proxy API 是硬性要求。这消除了配置过程中具有误导性的 "denial" 错误。
默认安全的扩展配置(工作流 4): 我们重构了《Monitoring Content Security》中 Model Armor 扩展的代码示例,使其采用默认安全的 fail-closed 方式,也就是在失败时拒绝放行,并补充了安全性与延迟之间的取舍指南。
不中断调用的网关绑定(工作流 3): 为了防止 Agent Gateway 的默认拒绝机制阻断 Agent 对平台内部接口的调用,我们重新组织了《Deploying Agent Gateway》中的工作流,让必要的 Google 托管平台 API 自动获得放行。
打通 Semantic Governance 的端到端网络(工作流 4): 我们在《Configuring Semantic Governance》文档中,增加了配置 Private Service Connect(PSC)端点和私有 Cloud DNS 区域的分步指南,让开发者更容易正确设置通往治理引擎的流量路由。
确保安全策略语法能够编译通过(工作流 4): 我们审核并统一了《IAM Policy Overview》中 IAM Common Expression Language(CEL)的属性引用,确保所有参数都使用准确的 api.getAttribute() 格式,让自定义策略的编译过程更加顺畅。
让策略执行机制更可预测(工作流 2 和 5): 我们在《Agent Registry Concepts》和《Automatic Registration》指南中,明确解释了绑定时(bind time)与运行时(runtime)策略求值在架构上的区别,帮助开发者更有把握地配置和测试安全规则。
用现成查询简化监控(工作流 5): 为了方便管理员验证策略,我们在《Monitoring Agent Gateways》和《Monitoring Content Security》指南中,公布了准确的日志流名称,以及可以直接复制粘贴使用的 Logs Explorer 查询。
工单关闭,并不意味着我们的工作结束。作为 DevEx 闭环的一部分,我们确保阻碍的记录过程紧密贴合开发者实际使用产品的方式,并对每一项修复进行严格的再次验证,确保平台确实能让你顺畅完成端到端操作。如果你在使用产品时遇到阻碍,希望获得支持或报告问题,可以进一步了解我们提供的各种渠道。
我们会持续走完这些用户旅程,找出隐藏的陷阱,解决拖慢你开发进度的阻碍。通过不断迭代,我们希望持续推动 Gemini Enterprise,让它变得更顺畅、更安全,让开发过程不再处处受阻。今天就试试 Gemini Enterprise Agent Platform 上的治理功能,亲自体验这些改进,也请关注下一轮 sprint 的更新!
我们特别感谢以下贡献者为这项计划付出的努力:Richa Thapa Magar、Sammy Krieger、Benazir Fateh、Elliot Yamaguchi、Eliza Kuzamenko、Evelyn Camacho Sobero、Ambreen Kazi、Bobby Power、Su-Lyn Rosenberry、Shubham Saboo、Dave Eliott 和 Donna Schut。