agent-platform-endpoint-management
Manages Agent Platform serving endpoints. Use when you need to create, list, describe, update, or delete serving endpoints for model deployment on Agent Platform. Also use when troubleshooting endpoint permission, quota, or resource busy errors. Don't use for deploying models to endpoints or for running model evaluations.
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- agent-platform-endpoint-management
- metadata
- { "category": "AiAndMachineLearning" }
- description
- Manages Agent Platform serving endpoints. Use when you need to create, list, describe, update, or delete serving endpoints for model deployment on Agent Platform. Also use when troubleshooting endpoint permission, quota, or resource busy errors. Don't use for deploying models to endpoints or for running model evaluations.
02 资源文件 2
- 参考文档metadata.json571 B
- 参考文档verification.json1.3 KB
03 SKILL.md 正文
Agent Platform Endpoint Management
Overview
This skill provides procedural knowledge for managing Agent Platform Endpoints. Endpoints are logical serving hosts that provide a stable URL for online predictions. You must create an endpoint before you can deploy a model to it.
Safety & Confirmation Tiers (CRITICAL)
Before executing any commands on behalf of the user, you MUST adhere to the following safety tiers based on the action requested:
- Tier R: Read-only (
list,describe,get)- No confirmation needed. Execute immediately to gather information.
- Tier M: Mutating & Reversible (
create,update)- Requires interactive confirmation with 'Yes'/'No' options. The
confirmation prompt MUST contain the exact, literal command string
with all required flags (e.g.
--region=us-central1,--display-name="...") — natural-language paraphrases are NOT sufficient. - Same-turn restriction: NEVER execute the command in the same turn as presenting the confirmation prompt. Stop and wait for the user's reply; only execute after explicit 'Yes' / approval.
- Requires interactive confirmation with 'Yes'/'No' options. The
confirmation prompt MUST contain the exact, literal command string
with all required flags (e.g.
- Tier D: Destructive & Irreversible (
delete)- Requires explicit typed confirmation (e.g. "I confirm" or "Yes,
delete it"). Ask for confirmation IMMEDIATELY — before any pre-flight
checks (don't
describefirst, don't check if the endpoint is empty first). - Same-turn restriction: NEVER execute in the same turn as asking for typed confirmation. Wait for the user to reply in a new turn.
- Requires explicit typed confirmation (e.g. "I confirm" or "Yes,
delete it"). Ask for confirmation IMMEDIATELY — before any pre-flight
checks (don't
Phase 0: Environment Setup
CRITICAL: Before running any commands, you MUST ensure the environment is correctly initialized by following these steps:
-
Google Cloud Authentication: Authenticate with your Google Cloud credentials and configure active Application Default Credentials (ADC) for Agent Platform access:
gcloud auth login gcloud auth application-default login -
Set Project: Configure the active project for subsequent commands:
gcloud config set project $PROJECT_ID -
Region: Always specify
--region=$LOCATION_IDon each command below. Do NOT useglobal. Ask the user to specify the region if not provided.
1. Listing Endpoints (Tier R)
Use this command to discover existing endpoints in a specific region and retrieve their IDs. No confirmation is required.
gcloud ai endpoints list \
--region=$LOCATION_ID
[!IMPORTANT] Always specify the
--region. Do NOT use 'global'. Ask the user to specify if not provided.
2. Describing an Endpoint (Tier R)
Retrieve the full metadata for a specific endpoint. No confirmation is required.
gcloud ai endpoints describe $ENDPOINT_ID \
--region=$LOCATION_ID
3. Creating an Endpoint (Tier M)
Create a new endpoint resource. The parent resource is the location. Action requires an inline confirmation card before proceeding.
gcloud ai endpoints create \
--region=$LOCATION_ID \
--display-name="my-endpoint"
[!IMPORTANT] You MUST seek interactive confirmation first. Your confirmation prompt MUST show the literal command string. For example:
gcloud ai endpoints create --region=$LOCATION_ID --display-name="my-endpoint"Or the exact flags. Do not execute this command in the same turn as proposing the confirmation.
4. Updating an Endpoint (Tier M)
Update endpoint metadata such as display name or labels. Action requires an inline confirmation card before proceeding.
gcloud ai endpoints update $ENDPOINT_ID \
--region=$LOCATION_ID \
--display-name="new-display-name"
Check if the endpoint exists first by either listing or describing the endpoint.
[!IMPORTANT] You MUST seek interactive confirmation first. Your confirmation prompt MUST show the literal command string. For example:
gcloud ai endpoints update $ENDPOINT_ID --region=$LOCATION_ID --display-name="new-display-name"Or the exact flags. CRITICAL: You are strictly prohibited from executing this command in the same turn as asking for confirmation. When you ask for confirmation, you MUST stop immediately and wait for the user to reply.
5. Deleting an Endpoint (Tier D)
Permanently delete an endpoint resource. Action requires explicit typed confirmation before proceeding.
gcloud ai endpoints delete $ENDPOINT_ID \
--region=$LOCATION_ID
[!WARNING] All models must be undeployed from the endpoint before it can be deleted. Do not run
describeuntil AFTER you have received typed confirmation to delete.
6. Traffic Splitting (Tier M)
You can manage traffic split between different models deployed on the same endpoint during an update. Action requires an inline confirmation card before proceeding.
# Example: Deploying a model with a specific traffic split is usually done
# via 'gcloud ai endpoints deploy-model'.
Refer to the agent-platform-deploy skill for instructions on deploying and
undeploying models.
Troubleshooting
- 403 Permission Denied: Ensure
aiplatform.adminorownerrole is assigned. - Quota Exceeded: Verify the region's endpoint quota in the Cloud Console.
- Resource Busy: If a deletion fails, check if models are still being undeployed.
04 同仓库更多 Skills
zkrouter
Self-hosted OpenAI-compatible LLM router — smart tier-based routing, ZK-stamped routing decisions, mode overrides, free OpenRouter at install via the Birth bot. Save 60-80% on inference costs by routing to the cheapest capable model across 12+ OpenRouter models.
zk
For custom ZK Solana programs and privacy-preserving applications to prevent double spending. Guide to integrate rent-free nullifier PDAs for double-spend prevention.
zk-omni-messaging
Zero-knowledge omnichain messaging between Robinhood Chain and Solana using CheshireZkOmniMessenger (msgType 4) with nullifier anti-replay and the zk-omni-relayer service.
zerion-wallet-data
Use when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs. Provides interpreted on-chain data across 40+ EVM chains and Solana via x402 pay-per-request or API key — no raw RPC decoding needed.
youtube-clipper
YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
yield-optimization
Multi-chain yield optimization via yield.xyz (StakeKit). Discover 2,988+ yield opportunities across 75+ blockchains, build deposit/withdrawal transactions with shell scripts, and sign them with a MoonPay wallet. Use when the user wants to earn yield, find the best lending or staking rate, enter/exit a position, or check portfolio balances.