agent-platform-troubleshooting
包含平台已知问题与恢复步骤,便于运维快速定位与修复错误。
诊断可能需访问敏感日志和管理权限
提供针对 Gemini Agent 平台(网关、注册表、IAP 等)的故障排查流程与参考资料。
定位 Google Cloud 上 Gemini Agent 平台(Agent Gateway、Registry、IAP) 的权限或运行错误,常见于 agent 返回 403、Runtime 返回 500 或 gateway/IAP 日志报权限失败。遇到 agent 请求被拒或平台组件异常时用,按步骤帮你判断是身份、策略、注册表还是 Model Armor 出问题。排查时必须只参考本技能包内 references/ 目录的文档并按手册流程操作。
▸ 展开 SKILL.md 英文原文
Troubleshoots Google Cloud Gemini Enterprise Agent Platform issues (Agent Gateway, Registry, Identity, Policies, Model Armor, Identity-Aware Proxy (IAP)). Use when agent requests fail with 403 (especially unauthorized egress), Agent Runtime queries return 500, or gateway/IAP logs show permission errors. Don't use for general Google Cloud Identity and Access Management (IAM) debugging or networking issues unrelated to the Agent Platform stack.
帮我安装这个 skill:https://raw.githubusercontent.com/google/skills/main/skills/cloud/agent-platform-troubleshooting/SKILL.mdcurl -fsSL "https://raw.githubusercontent.com/google/skills/main/skills/cloud/agent-platform-troubleshooting/SKILL.md"# Agent Platform Troubleshooting > [!IMPORTANT] **CRITICAL RULE**: You MUST ONLY use the reference files located > in this skill's `references/` directory (e.g., `references/field-manual.md`, > `references/known-issues.md`, `references/agent-registry.md`). Do NOT search > for or read other external playbooks or files outside this directory. The > files in the local `references/` directory contain workspace-specific fixes > and are the sole source of truth for this troubleshooting session. Diagnose issues across the Google Cloud Gemini Enterprise Agent Platform: Agent Gateway, Agent Registry (Agents / MCP Servers / Endpoints), Agent Identity, Policies, IAP-delegated authorization, and servi