先说结论
跨项目管理边界仍为Preview,加入项目不保证全部资源跨项目可见。管理项目汇总同location的自动发现资源;成员项目手工Service/Binding及自定义Skill等不自动汇总。global不等于全地域,发布记录还列有global搜索混入us/eu的已知问题。先核对注册方式、查询项目和location;目录可见性也不能代替实际调用授权验收。
读完你会得到
- 中央目录的覆盖范围取决于成员关系、注册方式、location和请求项目。
- 手工资源建在哪个项目,会影响边界内的可见范围。
- 不同boundary共用同一管理配置,可能合并可见范围。
- 六个资源的结果只是文档规则推演,未在真实云账户执行。
一个团队可能在自己的项目里看到Agent,平台团队却在中央目录里找不到它。此时先检查目录覆盖范围,避免把正常的项目范围误报成同步故障,或把一份有限结果当成全公司资产清单。
10月30日条目新增了什么
Google Cloud的Agent Registry发布记录在2026年10月30日条目列出跨项目management boundaries,状态为Preview。它让一个管理项目集中发现、搜索和治理多个成员项目中的Agent、MCP服务器及工具。本文于2026年11月1日核验。
Agent Registry主服务此前已列为GA,不能据此把这项跨项目能力也写成GA。准备使用预览功能时,仍需核对当前可用性与支持条件。本文适合维护多项目Agent目录的平台工程师、FDE及系统负责人,不是创建真实云资源的操作脚本。
本节依据: [1] Google Cloud Documentation [2] Google Cloud Documentation
把“中央可见”拆成三项条件
| 条件 | 文档规则 | 检查时保留什么 |
|---|---|---|
| 请求项目 | 管理项目可作跨项目汇总;直接查询成员项目仍是单项目范围。 | 请求指向哪个project,是否确为该边界的管理项目。 |
| location | 汇总发生在相同location。global不包含单区域或多区域;us/eu也不汇总其下单区域。 | 请求location,以及资源实际所在的location。 |
| 资源如何进入目录 | 成员项目自动发现的Agent/MCP资源可以汇总;成员项目手工Service/Binding不汇总。需要边界可见的手工资源应在管理项目登记。 | 自动发现还是手工登记、资源类型、登记项目。 |
自定义独立Skill、SkillRevision、Publisher和AiApplication也保留项目范围,不随成员项目聚合;Google管理的独立skills另有可发现规则。不要将“支持跨项目Agent目录”理解为复制所有类型的资源。
做目录清点时,先按相应资源类型读取集合并核对稳定标识,避免只用一句自然语言搜索估计资产总数。官方搜索说明指出,Endpoint不支持search查询,应使用相应列表与过滤方式。
本节依据: [3] Google Cloud Documentation [4] Google Cloud Documentation
六个虚构Agent:同一次查询应覆盖哪些
假设管理项目为M,A与B已加入同一有效管理边界,C在边界外。所列自动发现流程和手工登记均已完成;执行身份具备所需目录读取权限,读取过程成功且集合已完整取回。
下面从M查询us-central1的Agent集合。手工Agent指相应的手工Service登记;本表不把Skill、Endpoint或Binding混进同一个Agent集合。预期结果按文档规则推演,未在Google Cloud实测,也不保证实际环境不存在故障或延迟。
| 资源 | 所属/登记项目 | 方式与location | M / us-central1预期 |
|---|---|---|---|
| R1 | 成员A | 自动发现Agent,us-central1 | 纳入 |
| R2 | 成员B | 自动发现Agent,us-central1 | 纳入 |
| R3 | 成员A | 手工Agent Service,us-central1 | 不纳入:手工登记保留本项目范围 |
| R4 | 管理M | 手工Agent Service,us-central1 | 纳入 |
| R5 | 成员B | 自动发现Agent,europe-west1 | 不纳入:location不同 |
| R6 | 边界外C | 自动发现Agent,us-central1 | 不纳入:不属于该边界 |
按这些假设,中央结果应覆盖R1、R2、R4。R3没出现在中央结果,并不能单独证明它没有登记;先到成员A的对应范围核对。R5则应在匹配其location的查询中检查,不能靠把location改成global来代替。
若改为直接查询成员A的us-central1范围,预期可见R1、R3,不再汇入B或M的资源。两份列表不同,可能只是请求范围不同,不能只比较总数便判定谁缺数据。
边界与标签也要落成一份实际成员清单
官方边界模型允许按标签筛选成员;没有标签过滤时,文件夹或组织边界默认包含其下全部子项目。标签继承还可能把整支资源层级纳入。本站建议在启用前保存实际成员清单,而不是仅记录“已配置prod标签”。
多个boundary若绑定到同一个CapabilityConfig,成员会汇入同一个管理项目目录。需要prod与dev独立可见时,官方文档要求分别配置CapabilityConfig及管理项目;只把boundary或标签命名成prod/dev,并不能据此宣称目录已经隔离。
本站建议的范围核对记录
- 列明配置关系
记录管理项目、CapabilityConfig与边界标识、实际成员项目以及核对时间。
- 保留纳入与排除样本
至少选一个应纳入资源、一个成员手工资源、一个异地资源及一个边界外资源,分别写出预期。
- 评估成员变化
标签或资源层级变化后重新核对成员与可见资源。变化导致范围扩大时,先确认是否符合原先的目录用途。
出现缺项时,先定位范围,再处理故障
| 观察 | 先核对 | 下一步证据 |
|---|---|---|
| 成员项目能看到,中央看不到 | 自动发现还是手工登记;location是否一致。 | 资源类型、登记项目、两次请求的project/location。 |
| 查询global后出现意外跨地域结果 | 实际资源location,以及已知搜索问题。 | 原请求与返回资源标识,不把异常混入当新功能。 |
| prod目录出现dev资源 | 两边是否共用CapabilityConfig/管理项目,标签是否继承。 | 真实成员清单及配置关联。 |
| 返回名字像是管理项目的资源 | 请求范围与底层runtime reference。 | 用稳定标识和运行时归属核对,避免误报迁移。 |
| 请求失败或集合未完整读取 | 错误、访问范围、查询是否完成。 | 标记为未完成,不发布“未发现任何Agent”的结论。 |
发布记录仍列着一项已有known issue:global的SearchAgents/SearchMcpServers结果可能错误混入us/eu资源。因此,“global只对应global”是范围设计,实际搜索异常应按记录排查,不能据一次混入认定全地域汇总已经受支持。
对从成员项目自动发现并汇总的资源,从管理项目查询时,返回的resource name使用管理项目;组件ID不变,registry identifier和runtime reference仍保留原成员项目归属。看到name前缀改变,不能单独作为运行时搬迁证据。
本节依据: [1] Google Cloud Documentation [3] Google Cloud Documentation
用三次只读对照留下可复核结论
- 固定中央查询
记录M、us-central1、Agent类型、执行身份与过滤条件,按R1至R6分别核对。未知状态保持待确认,不补成不存在。
- 到成员范围复核手工样本
在具备相应授权的前提下,到A的同一location确认R3;若它只应本地可见,这正是预期。确需扩大可见范围时,另行评估登记位置,不为凑齐中央数量重复创建资源。
- 单独复核异地与边界外样本
用匹配location的受控查询确认R5,并检查R6未被误纳入当前边界。目录发现通过后,实际调用仍按独立的身份、目的地和业务权限流程验收。
本文给出的是教学对照方法。实际执行时应补上请求时间、结果、错误及负责人,让另一位同事能够解释每个“纳入”“排除”和“未知”,而不是只留下一个中央资源总数。
先把一类资源清楚地纳入目录
可以先选择一个location和一种资源类型,清楚列出自动发现、手工登记与不纳入的样本,再扩大项目范围。团队讨论的重点是中央目录服务谁、应覆盖哪些资源,以及哪些信息应保留在成员项目。
AI随心创的企业AI / FDE服务涉及需求诊断、系统集成与交付。需要讨论多项目Agent目录时,可准备脱敏的项目关系、登记方式、location、缺项样本和预期使用者,用于约定集成范围与验收。本文不代表Google Cloud合作资质或客户实施成果。
继续阅读:多部门扩展的配置与独立放行,用于划分复用与隔离范围;发现后怎样绑定实际调用端点与凭证,用于另行验收调用边界。团队分工见企业AI与FDE实施导航。
服务沟通:企业AI / FDE服务。来源核验与更正方式见编辑政策。
常见问题
项目入了管理边界,所有手工资源都会自动出现在中央吗?
不会。成员项目手工Service/Binding及自定义独立Skill等保留项目范围;需要边界可见的手工Service资源应按官方设计在管理项目登记。还要核对location与实际资源类型。
把location设为global,可以当全公司全地域清单吗?
不可以。global不汇总单区域或多区域,而且发布记录仍列有global搜索混入us/eu的已知问题。应按实际location、项目和类型分别核对,再判断覆盖范围。
本文表里的三条中央结果已经在线测过了吗?
没有。R1至R6、项目M/A/B/C均为虚构,结果是文档规则的教学推演,未访问真实云账户;调用授权和业务结果也未在本文测试。
资料来源与核对说明
文章中的行业定义与技术方法尽量引用官方或标准组织资料;表格、清单和决策框架是基于这些资料形成的编辑性整理,不代表来源机构对本站服务的背书。
- Agent Registry release notes — October 30, 2026Google Cloud Documentation
2026-11-01核验。10月30日Feature条目标注跨项目management boundaries Preview;主服务6月18日GA不能扩大至该预览。仍列4月22日global搜索可能混入us/eu的已知问题。页脚Last updated为2026-10-29 UTC,与条目日期用途不同,不推测首次发布时间或具体上线时刻。
- Set up Agent RegistryGoogle Cloud Documentation
2026-11-01核验,首次发布日期未标。跨项目管理边界设置明确标为Preview,需要配置相应边界/能力并授予所需目录权限;本文不提供创建资源或授予广泛管理员权限的脚本。
- Cross-project boundariesGoogle Cloud Documentation
2026-11-01核验;页脚Last updated 2026-10-29 UTC,不当首次发布日期。核对同location汇总、手工与自动资源范围、自定义独立资源例外、成员/管理项目、标签继承及多边界合并;request-scoped name与保留原成员runtime归属的说明针对从成员自动发现汇总的资源。六资源表为本站虚构推演,未实测。
- Search for agents, tools, and skillsGoogle Cloud Documentation
2026-11-01核验;首次发布日期未标,页脚Last updated 2026-10-29 UTC。核对管理/成员项目请求范围、同location聚合、成员手工Service/Binding不聚合及Endpoint需list而非search。未执行云账户请求。
带上流程、样例和目标,添加企业微信沟通。先确定项目范围与验收方式,再安排实施。


