google-agents-cli-publish

原文：🇺🇸 英文

已翻译

当用户想要“发布Agent”、“发布我的ADK Agent”、“向Gemini Enterprise注册Agent”、“发布到Gemini Enterprise”，或需要agents-cli publish gemini-enterprise命令的使用指导时，应使用本Skill。内容涵盖ADK与A2A注册模式、程序化与交互式用法、参数参考、从部署元数据自动检测以及故障排查。本Skill属于Google ADK（Agent开发工具包）Skill套件。请勿用于部署（请使用google-agents-cli-deploy）。

106.7k次下载

来源google/agents-cli

添加于2026-04-22

NPX安装

npx skill4agent add google/agents-cli google-agents-cli-publish

SKILL.md 内容（中文）

查看翻译对照 →

Gemini Enterprise 注册

要求： 已部署的Agent。对于Agent Runtime，
deployment_metadata.json
（由
agents-cli deploy
创建）支持自动检测。对于Cloud Run或GKE，请直接提供Agent卡片URL和参数。

前提条件

Agent必须已部署 —— Agent必须处于运行状态且可访问
Gemini Enterprise应用必须已存在 —— 注册前请在Google Cloud控制台 → Gemini Enterprise → 应用中创建一个应用
deployment_metadata.json
（仅适用于Agent Runtime）—— 由
```
agents-cli deploy
```
自动创建；包含Agent Runtime ID、部署目标和A2A参数

A2A在Cloud Run上的必要权限

需为Discovery Engine服务账号（

service-<PROJECT_NUMBER>@gcp-sa-discoveryengine.iam.gserviceaccount.com

）授予Cloud Run服务的**

roles/run.servicesInvoker

**角色。

注册模式

ADK注册（默认）

适用于部署到Agent Runtime的标准ADK Agent。Agent将通过其推理引擎资源名称直接注册。

bash

agents-cli publish gemini-enterprise \
  --agent-runtime-id projects/123456/locations/us-east1/reasoningEngines/789 \
  --gemini-enterprise-app-id projects/123456/locations/global/collections/default_collection/engines/my-app \
  --display-name "My Agent" \
  --description "Handles customer queries" \
  --tool-description "Answers questions about products"

A2A注册

适用于使用Agent-to-Agent协议的Agent。需要Agent卡片URL —— 命令将获取该卡片并完成注册。

bash

# A2A on Cloud Run
agents-cli publish gemini-enterprise \
  --registration-type a2a \
  --agent-card-url https://my-service-abc123.us-east1.run.app/a2a/app/.well-known/agent-card.json \
  --gemini-enterprise-app-id projects/123456/locations/global/collections/default_collection/engines/my-app \
  --display-name "My A2A Agent"

# A2A on Agent Runtime (card URL is auto-constructed from metadata)
agents-cli publish gemini-enterprise \
  --registration-type a2a \
  --gemini-enterprise-app-id projects/123456/locations/global/collections/default_collection/engines/my-app

程序化模式（CI/CD）

命令默认是非交互式的 —— 通过参数或环境变量传递所有必填值。这使其可安全用于CI/CD流水线。

通过参数

bash

agents-cli publish gemini-enterprise \
  --agent-runtime-id "$AGENT_RUNTIME_ID" \
  --gemini-enterprise-app-id "$GEMINI_ENTERPRISE_APP_ID" \
  --display-name "Production Agent" \
  --registration-type adk

通过环境变量

每个参数都有对应的环境变量替代方案：

bash

export AGENT_RUNTIME_ID="projects/123456/locations/us-east1/reasoningEngines/789"
export GEMINI_ENTERPRISE_APP_ID="projects/123456/locations/global/collections/default_collection/engines/my-app"
export GEMINI_DISPLAY_NAME="Production Agent"
export GEMINI_DESCRIPTION="Handles customer queries"

agents-cli publish gemini-enterprise

交互式模式（

--interactive

）

传递

--interactive

（或

-i

）参数，将通过交互式提示引导您补充任何缺失的值。命令会列出可用的Gemini Enterprise应用，提供从元数据自动检测Agent Runtime ID的选项，并提示输入显示名称和描述。

bash

agents-cli publish gemini-enterprise --interactive

完整参数参考

参数	环境变量	描述
`--agent-runtime-id`	`AGENT_RUNTIME_ID`	Agent Runtime资源名称（从 `deployment_metadata.json` 自动检测）
`--gemini-enterprise-app-id`	`ID` 或 `GEMINI_ENTERPRISE_APP_ID`	Gemini Enterprise应用完整资源名称
`--display-name`	`GEMINI_DISPLAY_NAME`	在Gemini Enterprise中的显示名称
`--description`	`GEMINI_DESCRIPTION`	Agent描述
`--tool-description`	`GEMINI_TOOL_DESCRIPTION`	工具描述（仅ADK模式，默认与描述相同）
`--registration-type`	`REGISTRATION_TYPE`	`adk` 或 `a2a` （若未设置则从元数据自动检测）
`--agent-card-url`	`AGENT_CARD_URL`	A2A注册用的Agent卡片URL
`--deployment-target`	`DEPLOYMENT_TARGET`	`agent_runtime` , `cloud_run` , or `gke` （影响A2A认证方式）
`--project-id`	`GOOGLE_CLOUD_PROJECT`	用于计费的GCP项目ID
`--project-number`	`PROJECT_NUMBER`	GCP项目编号（用于Gemini Enterprise查找）
`--authorization-id`	`GEMINI_AUTHORIZATION_ID`	OAuth授权资源名称
`--metadata-file`	—	部署元数据文件路径（默认： `deployment_metadata.json` ）
`--interactive` / `-i`	—	启用交互式提示

从元数据自动检测

当

deployment_metadata.json

存在时，命令会自动：

读取Agent Runtime ID（
```
remote_agent_runtime_id
```
）
检测注册类型（
```
is_a2a
```
参数）
为Agent Runtime上的A2A Agent构建Agent卡片URL
确定用于认证的部署目标

这意味着在最简单的场景（部署到Agent Runtime的ADK Agent）下，您只需提供Gemini Enterprise应用ID即可：

bash

agents-cli publish gemini-enterprise \
  --gemini-enterprise-app-id projects/123456/locations/global/collections/default_collection/engines/my-app

SDK兼容性

当

google-cloud-aiplatform

版本 <= 1.128.0时，Agent Runtime部署可能会遇到“Session not found”错误。在交互式模式（

--interactive

）下，命令会从

uv.lock

检查SDK版本，并提供升级选项。在程序化模式下，请确保注册前SDK已更新至最新版本。

故障排查

问题	解决方案
注册后出现“Session not found”	SDK版本问题 —— 升级 `google-cloud-aiplatform` （参见上述SDK兼容性部分），重新部署后再重新注册
需要 `--registration-type` 参数	当不存在 `deployment_metadata.json` 时，非交互式模式需要指定 `--registration-type`
“Gemini Enterprise应用ID是必填项”	提供 `--gemini-enterprise-app-id` 参数或设置 `ID` / `GEMINI_ENTERPRISE_APP_ID` 环境变量
“Agent已注册”	命令会自动更新现有注册 —— 这不是错误
注册时出现HTTP 403错误	检查您的账号是否在Gemini Enterprise项目中拥有Discovery Engine Editor权限
“无法获取Agent卡片”	确认Agent正在运行且URL正确；对于Cloud Run，请确保已完成 `gcloud auth login`

google-agents-cli-publish

NPX安装

标签

SKILL.md 内容（中文）

Gemini Enterprise 注册

前提条件

A2A在Cloud Run上的必要权限

注册模式

ADK注册（默认）

A2A注册

程序化模式（CI/CD）

通过参数

通过环境变量

交互式模式（
`--interactive`
）

完整参数参考

从元数据自动检测

SDK兼容性

故障排查

相关Skill

google-agents-cli-publish

NPX安装

标签

SKILL.md 内容（中文）

Gemini Enterprise 注册

前提条件

A2A在Cloud Run上的必要权限

注册模式

ADK注册（默认）

A2A注册

程序化模式（CI/CD）

通过参数

通过环境变量

交互式模式（--interactive）

完整参数参考

从元数据自动检测

SDK兼容性

故障排查

相关Skill

交互式模式（
`--interactive`
）