Google Cloud跨项目Agent目录预览:入了管理边界,为什么仍搜不到?

项目已加入边界,不意味着所有资源都汇入中央目录。先核对自动发现或手工登记、请求指向的项目以及location,再判断资源是否遗漏。

虚构中央目录覆盖图:从管理M查询us-central1,纳入成员A自动R1、成员B自动R2和管理M手工R4;成员A手工R3、异地R5及边界外R6不在该次结果中。仅文档预期,未实测。
本站原创文档规则推演。项目与资源均为虚构;示意目录发现范围,不代表真实云账户、产品界面、运行时迁移或调用授权。

先说结论

跨项目管理边界仍为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实测,也不保证实际环境不存在故障或延迟。

虚构输入与文档预期,不是客户资产或线上测试结果
资源所属/登记项目方式与locationM / 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的资源。两份列表不同,可能只是请求范围不同,不能只比较总数便判定谁缺数据。

本节依据: [3] Google Cloud Documentation

边界与标签也要落成一份实际成员清单

官方边界模型允许按标签筛选成员;没有标签过滤时,文件夹或组织边界默认包含其下全部子项目。标签继承还可能把整支资源层级纳入。本站建议在启用前保存实际成员清单,而不是仅记录“已配置prod标签”。

多个boundary若绑定到同一个CapabilityConfig,成员会汇入同一个管理项目目录。需要prod与dev独立可见时,官方文档要求分别配置CapabilityConfig及管理项目;只把boundary或标签命名成prod/dev,并不能据此宣称目录已经隔离。

本站建议的范围核对记录

  • 列明配置关系

    记录管理项目、CapabilityConfig与边界标识、实际成员项目以及核对时间。

  • 保留纳入与排除样本

    至少选一个应纳入资源、一个成员手工资源、一个异地资源及一个边界外资源,分别写出预期。

  • 评估成员变化

    标签或资源层级变化后重新核对成员与可见资源。变化导致范围扩大时,先确认是否符合原先的目录用途。

本节依据: [3] Google Cloud Documentation

出现缺项时,先定位范围,再处理故障

本站建议的排查顺序;不代表产品自带这些诊断字段
观察先核对下一步证据
成员项目能看到,中央看不到自动发现还是手工登记;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

用三次只读对照留下可复核结论

  1. 固定中央查询

    记录M、us-central1、Agent类型、执行身份与过滤条件,按R1至R6分别核对。未知状态保持待确认,不补成不存在。

  2. 到成员范围复核手工样本

    在具备相应授权的前提下,到A的同一location确认R3;若它只应本地可见,这正是预期。确需扩大可见范围时,另行评估登记位置,不为凑齐中央数量重复创建资源。

  3. 单独复核异地与边界外样本

    用匹配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均为虚构,结果是文档规则的教学推演,未访问真实云账户;调用授权和业务结果也未在本文测试。

资料来源与核对说明

文章中的行业定义与技术方法尽量引用官方或标准组织资料;表格、清单和决策框架是基于这些资料形成的编辑性整理,不代表来源机构对本站服务的背书。

  1. 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,与条目日期用途不同,不推测首次发布时间或具体上线时刻。

  2. Set up Agent RegistryGoogle Cloud Documentation

    2026-11-01核验,首次发布日期未标。跨项目管理边界设置明确标为Preview,需要配置相应边界/能力并授予所需目录权限;本文不提供创建资源或授予广泛管理员权限的脚本。

  3. Cross-project boundariesGoogle Cloud Documentation

    2026-11-01核验;页脚Last updated 2026-10-29 UTC,不当首次发布日期。核对同location汇总、手工与自动资源范围、自定义独立资源例外、成员/管理项目、标签继承及多边界合并;request-scoped name与保留原成员runtime归属的说明针对从成员自动发现汇总的资源。六资源表为本站虚构推演,未实测。

把文章方法用于你的真实业务

带上流程、样例和目标,添加企业微信沟通。先确定项目范围与验收方式,再安排实施。

查看企业 AI / FDE 服务 →
相机、麦克风和布光台上的雕塑,表现图片、视频与声音的创作
AI 生成 · 内容创作场景示意

把你正在做的事,
拿来一起聊聊。

还没有完整方案也没关系。选一个方向,带着下面几条信息联系团队,我们先了解问题,再确认下一步。

企业 AI / FDE 项目

先从一段具体流程说起。

  • 我们目前怎样完成这项工作?
  • 哪一步最费时间,或经常出错?
  • 已有的资料、系统和期望结果是什么?
Shopify 建站与经营

有店铺的话,可以一并发来链接。

  • 店铺是准备上线,还是已经在运营?
  • 销售什么商品,面向哪些市场?
  • 希望先解决哪个页面或经营问题?
内容创作与工具使用

说明准备制作的内容,或遇到的操作问题。

  • 想做图片、视频、配音,还是图文?
  • 已有素材、参考风格和使用场景是什么?
  • 如果使用时遇到问题,具体停在哪一步?
扫码添加随心创技术客服企业微信

微信扫码,发来你的问题

可以直接按提纲描述,也可以先发一句话。人工服务会在确认范围后单独报价。

手机上可保存二维码后识别。