google-agents-cli-publish

作者： google

This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini Enterprise", "publish to Gemini Enterprise", or needs guidance on the agents-cli publish gemini-enterprise command. Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, and troubleshooting. Part of the Google ADK (Agent Development Kit) skills suite. Do NOT use for deployment (use...

npx skills add https://github.com/google/agents-cli --skill google-agents-cli-publish
下載 ZIPGitHub

Gemini Enterprise Registration

Requires: A deployed agent. For Agent Runtime, deployment_metadata.json (created by agents-cli deploy) enables auto-detection. For Cloud Run or GKE, provide the agent card URL and flags directly.

Prerequisites

  1. Agent must be deployed — the agent must be running and reachable
  2. Gemini Enterprise app must exist — Create one in Google Cloud Console → Gemini Enterprise → Apps before registering
  3. deployment_metadata.json (Agent Runtime only) — Created automatically by agents-cli deploy; contains the agent runtime ID, deployment target, and A2A flag

Required Permissions for A2A on Cloud Run

  • roles/run.servicesInvoker granted to the Discovery Engine service account (service-<PROJECT_NUMBER>@gcp-sa-discoveryengine.iam.gserviceaccount.com) on the Cloud Run service.

Registration Modes

ADK Registration (default)

For standard ADK agents deployed to Agent Runtime. The agent is registered directly via its reasoning engine resource name.

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 Registration

For agents using the Agent-to-Agent protocol. Requires an agent card URL — the command fetches the card and registers it.

# 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

Programmatic Mode (CI/CD)

The command is non-interactive by default — pass all required values via flags or environment variables. This makes it safe for CI/CD pipelines.

Via flags

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

Via environment variables

Every flag has an env var alternative:

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 Mode (--interactive)

Pass --interactive (or -i) to be guided through any missing values with interactive prompts. The command will list available Gemini Enterprise apps, offer to auto-detect the agent runtime ID from metadata, and prompt for display name and description.

agents-cli publish gemini-enterprise --interactive

Complete Flag Reference

FlagEnv VarDescription
--agent-runtime-idAGENT_RUNTIME_IDAgent Runtime resource name (auto-detected from deployment_metadata.json)
--gemini-enterprise-app-idID or GEMINI_ENTERPRISE_APP_IDGemini Enterprise app full resource name
--display-nameGEMINI_DISPLAY_NAMEDisplay name in Gemini Enterprise
--descriptionGEMINI_DESCRIPTIONAgent description
--tool-descriptionGEMINI_TOOL_DESCRIPTIONTool description (ADK mode only, defaults to description)
--registration-typeREGISTRATION_TYPEadk or a2a (auto-detected from metadata if not set)
--agent-card-urlAGENT_CARD_URLAgent card URL for A2A registration
--deployment-targetDEPLOYMENT_TARGETagent_runtime, cloud_run, or gke (affects A2A auth method)
--project-idGOOGLE_CLOUD_PROJECTGCP project ID for billing
--project-numberPROJECT_NUMBERGCP project number (used for Gemini Enterprise lookup)
--authorization-idGEMINI_AUTHORIZATION_IDOAuth authorization resource name
--metadata-file—Path to deployment metadata (default: deployment_metadata.json)
--interactive / -i—Enable interactive prompts

Auto-Detection from Metadata

When deployment_metadata.json exists, the command automatically:

  • Reads the agent runtime ID (remote_agent_runtime_id)
  • Detects the registration type (is_a2a flag)
  • Constructs the agent card URL for A2A agents on Agent Runtime
  • Determines the deployment target for authentication

This means that for the simplest case (ADK agent on Agent Runtime), you only need to provide the Gemini Enterprise app ID:

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

SDK Compatibility

Agent Runtime deployments may encounter "Session not found" errors with google-cloud-aiplatform versions <= 1.128.0. In interactive mode (--interactive), the command checks the SDK version from uv.lock and offers to upgrade. In programmatic mode, ensure your SDK is up to date before registering.

Troubleshooting

IssueSolution
"Session not found" after registrationSDK version issue — upgrade google-cloud-aiplatform (see SDK Compatibility above), redeploy, then re-register
--registration-type is requiredNon-interactive mode needs --registration-type when no deployment_metadata.json exists
"Gemini Enterprise App ID is required"Provide --gemini-enterprise-app-id or set the ID / GEMINI_ENTERPRISE_APP_ID env var
"Agent already registered"The command automatically updates the existing registration — this is not an error
HTTP 403 on registrationCheck that your account has Discovery Engine Editor permissions on the Gemini Enterprise project
"Could not fetch agent card"Verify the agent is running and the URL is correct; for Cloud Run, ensure gcloud auth login is done

Related Skills

  • /google-agents-cli-deploy — Deployment targets, CI/CD pipelines, and production workflows
  • /google-agents-cli-workflow — Development workflow, coding guidelines, and operational rules
  • /google-agents-cli-scaffold — Project creation and enhancement with agents-cli scaffold create / scaffold enhance

來自 google 的更多技能

google-agents-cli-adk-code
google
當使用者想要「撰寫代理程式碼」、「使用 ADK 建置代理程式」、「新增工具」、「建立回呼」、「定義代理程式」、「使用狀態管理」，或需要 ADK（代理程式開發套件）Python API 模式與程式碼範例時，應使用此技能。屬於 Google ADK 技能套件的一部分。提供代理程式類型、工具定義、編排模式、回呼與狀態管理的快速參考。請勿用於建立新專案（請使用 google-agents-cli-scaffold）或部署...
developmentapicode-review
google-agents-cli-eval
google
當使用者想要「執行評估」、「評估我的 ADK 代理」、「撰寫評估資料集」、「分析評估失敗原因」、「比較評估結果」、「優化代理」，或需要 Agent Platform 評估方法論與品質飛輪的指引時，應使用此技能。涵蓋評估指標、資料集結構、LLM 作為評審的評分方式，以及常見的失敗原因。請勿用於 API 程式碼模式（請使用 google-agents-cli-adk-code）、部署（請使用 google-agents-cli-deploy）或專案架構生成（請使用...
developmenttestingdata-analysis
google-agents-cli-workflow
google
此技能應在使用者想要「開發代理」、「使用 ADK 建置代理」、「在本機執行代理」、「除錯代理程式碼」、「測試代理」、「部署代理」、「發布代理」、「監控代理」，或需要 ADK（代理開發套件）開發生命週期與編碼指南時使用。為建置 ADK 代理的進入點。始終啟用 — 提供完整工作流程（建立框架、建置、評估、部署、發布、監控）、程式碼保留規則、模型選擇指引，以及...
developmentdevopstesting
google-agents-cli-deploy
google
當使用者想要「部署代理程式」、「部署我的ADK代理程式」、「設定CI/CD」、「設定機密」、「疑難排解部署」，或需要關於Agent Runtime、Cloud Run或GKE部署目標的指引時，應使用此技能。涵蓋部署工作流程、服務帳戶、回滾及生產基礎架構。屬於Google ADK（代理程式開發套件）技能套件的一部分。請勿用於API程式碼模式（請使用google-agents-cli-adk-code）、評估（請使用google-agents-cli-eval）或...
developmentdevops
google-agents-cli-scaffold
google
This skill should be used when the user wants to "create an agent project", "start a new ADK project", "build me a new agent", "add CI/CD to my project", "add deployment", "enhance my project", or "upgrade my project". Part of the Google ADK (Agent Development Kit) skills suite. Covers `agents-cli scaffold create`, `scaffold enhance`, and `scaffold upgrade` commands, template options, deployment targets, and the prototype-first workflow. Do NOT use for writing agent code (use...
developmentdevops
google-agents-cli-observability
google
此技能應在使用者想要「設定追蹤」、「監控我的 ADK 代理程式」、「設定記錄」、「加入可觀測性」、「偵錯正式環境流量」，或需要關於監控已部署 ADK（代理程式開發套件）代理程式的指引時使用。涵蓋 Cloud Trace、提示-回應記錄、BigQuery 代理程式分析、第三方整合（AgentOps、Phoenix、MLflow 等）以及疑難排解。屬於 Google ADK（代理程式開發套件）技能套件的一部分。請勿用於部署設定（請使用...
developmentdevopsapi