先说清楚在哪找不到
‘找不到我的 Agent’信息还不完整：是 Gemini 应用里没有、全局 Agent Registry 没记录，还是其他 Agent 的发现流程没有结果？记录预期目标、项目、位置、账号和已部署端点。在一个项目部署成功，不能证明已经注册到另一个应用或项目。
不要把凭据、私有端点和账号标识放进公开排错记录。知道端点网址，不等于有权公开它，也不能为了让测试成功就扩大访问权限。
- 写明 Agent 应该出现的产品或应用。
- 对照部署与注册的项目和位置。
- 使用有权检查相关资源的账号。
区分四项工作
选择能回答当前缺失阶段问题的最小角色。代码参考不是部署，注册成功也不能证明服务回答正确。一次装齐四个 Skill，不会赋予云权限，也不会自动连接所有阶段。
| 问题 | Skill | 预期产物或状态 |
|---|---|---|
| Agent 应该怎么实现？ | google-agents-cli-adk-code | 代码与 API 模式参考 |
| 服务在哪里运行？ | google-agents-cli-deploy | 已部署服务与部署元数据 |
| 使用方如何发现它？ | google-agents-cli-publish | 已有端点的注册记录 |
| 生命周期下一步做什么？ | google-agents-cli-workflow | 包含评估与批准的阶段计划 |
重部署前，检查已有部署证据
检查真实部署状态、预期服务及已有部署元数据。仅凭本地命令超时，不能判断远程任务失败。启动第二次部署前先核对现有任务；重复执行可能改变状态或产生费用，却没有解决注册缺口。
核对版本的 Publish 流程要求 Agent 已部署且可访问。Agent Runtime 可以使用部署元数据，其他目标需要相应端点信息。可访问不代表无需认证或必须公开，应保留服务原定的访问控制。
检查注册模式和传输方式
在核对版本中，Agent Runtime 上的 ADK 应用默认使用原生 ADK 注册；Cloud Run 和 GKE 使用 A2A 注册。其他框架与运行目标组合，应采用文档对应模式，不能只因复制的命令用了某个模式就照搬。
对于 Gemini 应用，检查准确应用、服务元数据和所需权限；核对流程不支持在该应用中注册实时语音 Agent。另一方面，Agent Registry 目录管理 Agent 与 MCP 服务，其中有记录不等于已注册到 Gemini 应用。创建另一条记录前，先确认正在检查哪种记录。
一次做一个获批准的修改，验证对应结果
示意验收计划，并非实际执行的修复：先证明预期服务存在，再指出缺少哪条注册记录；针对准确目标批准一次修改，最后用获授权的预期用户检查是否能发现。Agent 行为需要另测，能看到不代表任务质量或安全性合格。
缺少权限时，向资源所有者申请完成任务所需的最小访问。不要为了清除错误而关闭认证、授予宽泛角色或删除注册。部署或测试可能收费时，先检查云资源和模型费用。
- 写入前记录已有资源标识。
- 批准准确注册或 IAM 修改及目标。
- 为改动的记录保留回滚或纠正路径。
- 分别检查发现、访问与行为。
来源与证据边界
本文分析 google/agents-cli 固定提交 d445570c61fd446487ea6623c5635b23aded237f，核对日期 2026-10-19。下方记录提供说明文件路径和哈希。产品界面、当前 CLI 参数和服务权限可能变化；操作真实账号前应核对当前官方文档。
我们没有登录 Google Cloud、部署 Agent、修改 IAM、注册或删除端点，也没有复现这一场景。不声称测得解决率或关键词搜索量；清单属于原创编辑建议，不是客户案例。