1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | agent-platform-alert-configuration-google-skills（SKILL.md 自述名称：“Agent Platform Alert Configuration”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | Google（官方 google/skills 仓库，Cloud IX 团队具名提交） |
GitHub API |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-alert-configuration | — |
| 许可证 | Apache License 2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 所属仓库 15,241 / 1,192（整仓库口径——google/skills 是 Google 官方发布的多技能合集，星数不代表单个技能自身热度） |
GitHub API 实测（2026-07-26） |
| 最新版本 | 子目录最近一次提交 2026-07-06 | GitHub commits API 实测 |
| 安装方式 | npx skills add google/skills --skill agent-platform-alert-configuration，或手动复制子目录到对应 agent 的 skills 目录 |
官方 README 实测 |
2. 功能介绍与亮点
该技能让 Agent 能为部署在 Google Cloud Vertex AI / Agent Platform（Reasoning Engines）上运行的 AI Agent，自动生成一整套动态阈值告警配置，替代容易产生噪音的静态阈值告警：
- 可靠性 + 质量双维度覆盖：固定生成 6 条告警策略——延迟异常、错误率快速燃尽（1 小时窗口）、错误率缓慢燃尽（3 天窗口）三条可靠性告警，以及最终响应质量、工具调用质量、幻觉率三条质量告警
- 动态基线而非固定阈值：根据 Agent 的流量模式（稳态 / 季节性 / 突发）自动选择合适的统计算法（Z-score、季节性分解、移动平均等），并用 PromQL 生成随流量自适应的阈值，避免“延迟 > 2 秒”这类固定阈值频繁误报
- 成本前置提示：质量告警依赖 Online Monitor 采集数据，该功能会产生额外的 Google Cloud 计费；技能在配置前必须先检查遥测状态、并显式征得用户对追加费用的确认，不允许静默开通付费资源
- 可执行工具链完整：随附
check_telemetry.py（只读遥测检查）、create_online_monitor.py（Online Monitor 开通）、validate_config.py（Terraform 配置校验，含自我修正循环）等脚本，每个脚本都配有独立单元测试文件；另附 4 篇参考文档（历史流量数据判定、PromQL 查询示例、遥测开通指南等）与多个模拟流量数据样例（稳态/季节性/突发三种模式），工程完整度在同类 Agent Platform 系列技能中较突出 - 两级安全确认协议：只读检查（Tier R）无需确认可直接执行；涉及计费或资源创建的操作（Tier B）必须先向用户说明费用影响并等待明确同意
3. 适用场景
所属分类：元技能与 Agent 增强
适合已在 Google Cloud Agent Platform 上部署生产 Agent、需要为其配置监控告警的团队：不熟悉 PromQL 或 Cloud Monitoring 告警策略语法的开发者，可以用自然语言描述“给这个 Agent 配置告警”，由技能生成符合 Google 官方最佳实践的 Terraform 告警配置，而不必手写查询语句或反复调试静态阈值导致的告警噪音。
4. 跨 Agent 兼容性
google/skills 仓库通过 npx skills 通用安装器（vercel-labs/skills）分发，该安装器 README 的 Supported Agents 表格逐一列出各 agent 的安装路径：
| Agent | 项目路径 | 全局路径 |
|---|---|---|
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
| Codex | .agents/skills/ |
~/.codex/skills/ |
| OpenClaw | skills/ |
~/.openclaw/skills/ |
| Hermes Agent | .hermes/skills/ |
~/.hermes/skills/ |
四个生态均为原生支持——技能本身是标准 SKILL.md + Terraform / gcloud / Python 脚本，不依赖 Claude Code 专属机制，配合上表安装路径即可在任一生态中使用。
5. 推荐理由
把“给 AI Agent 配置一套不产生噪音的监控告警”这件通常需要熟悉 PromQL、Cloud Monitoring API 与统计学基础才能做好的事，变成对话式生成，并内置成本确认与配置校验闭环，降低了 Agent Platform 运维告警配置的门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Google Cloud 团队维护，隶属仓库整体 15,241 stars 的官方技能仓库；该数字属整个合集，不代表本技能自身热度——本子目录目前仅有官方内部提交记录，尚无外部社区 issue 或 PR 参与 |
| 可用性 | 8 | 脚本均配有独立单元测试、附 4 篇参考文档与模拟流量样例，文档与示例完整；但需要用户已有部署在 Agent Platform 上的 Agent、本地安装 Terraform 并完成 gcloud 认证，且开通 Online Monitor 会产生额外云端计费，属于“步骤清晰但需一定配置”档 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
① Shell 命令及权限范围：仅调用 gcloud/terraform 官方 CLI 与随附 Python 脚本，操作范围限定在 Cloud Monitoring 告警策略与 Online Monitor 配置，且明确要求先装 Terraform、按 requirements.txt 装 Python 依赖，无越权操作。
② 联网外发：仅与用户自己 Google Cloud 项目下的 Monitoring / Vertex AI API 通信，用于读取遥测状态与写入告警策略，目标单一透明。
③ 凭据处理：标准 gcloud 本地凭据体系，脚本本身不额外存储或外发密钥。
④ 可疑指令：通读 SKILL.md 全文与脚本清单，未发现隐藏指令、混淆代码或异常外发；两级安全确认协议（只读免确认 / 计费与资源创建需显式征得同意）是主动的风险控制设计。
⑤ 作者信誉：Google 官方仓库，具名 Cloud IX 团队提交，无造假迹象。
⑥ License：Apache License 2.0，明确清晰。
⑦ 最近维护：子目录最近一次代码提交 2026-07-06，仓库整体持续保持推送更新。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| Datadog LLM Observability | 商业 SaaS 可观测性平台，覆盖 LLM/Agent 的基础设施监控、延迟与成本追踪，告警能力成熟且与 Datadog 现有企业监控栈深度集成 | 需要额外订阅并把遥测数据接入 Datadog 独立平台，非 Google Cloud 原生；本技能直接在用户自己的 GCP 项目内用 Terraform 生成告警资源，不产生额外第三方平台依赖 |
| Arize Phoenix | 开源优先（OpenTelemetry 原生）的 LLM/Agent 评测与可观测性工具，强项是把每条 trace 转成回归测试用例，评测驱动能力较深 | 是一个独立部署的评测与追踪平台，需自行接入 OpenTelemetry pipeline 并运维；本技能不提供独立评测框架，而是把 Google 官方 Online Monitor 已产出的质量分数直接转成开箱可用的告警策略 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，GitHub 仓库层面该子目录也暂无外部开发者提交的 issue 或 PR 讨论。
9. 其他补充
该技能是 google/skills 仓库“Agent Platform”系列的一员，同系列还包含技能注册表管理、评估飞轮、Prompt 版本管理、模型注册表管理等技能，均围绕 Google Cloud 上的 Agent 全生命周期管理展开，可按需组合安装。
10. 安装使用方式
- 通过安装器：
npx skills add google/skills --skill agent-platform-alert-configuration，安装器会将技能放入当前 Agent 对应的 skills 目录（见第 4 章路径表） - 手动安装：克隆或下载
google/skills仓库后，将skills/cloud/agent-platform-alert-configuration/整个目录复制到目标 agent 的 skills 目录下 - 安装后：需先本地安装 Terraform 并执行
gcloud auth login完成认证，随附脚本还需pip install -r scripts/requirements.txt装好 Python 依赖；之后无需重启 Agent，即可在对话中触发本技能（如“帮我这个 Reasoning Engine 配置监控告警”）
11. 注意事项
- 仅适用于部署在 Google Cloud Agent Platform（Vertex AI Reasoning Engines）上的 Agent，不用于配置通用 GCP 告警策略
- 开通 Online Monitor 与遥测采集会产生额外 Google Cloud 计费，技能会在执行前提示但费用高低取决于采样比例与实际流量，需用户自行评估
- 依赖本地 Terraform 与 gcloud CLI 完成部署，未提供纯 API/SDK 路径
- 技能强绑定 Google Agent Platform 的资源模型与遥测体系，若团队使用其他云厂商或自建的 Agent 运行时，需要额外适配后才能复用