📌 google-agents-cli-observability 是什么？

Agent 运行起来像黑盒，出了问题难定位。google-agents-cli-observability 是官方技能，让 AI 帮你给 Agent 加可观测性。

它记录 Agent 每一步的输入输出、日志、指标，让 Agent 的行为"看得见"，出问题能复现、能定位。

🧩 核心功能

运行追踪：记录 Agent 每一步的输入输出。

日志：记录关键日志。

指标：统计调用、耗时、成功率。

调试：复现和定位问题。

👍 优点

问题可定位：不再是黑盒。

行为可追踪：每步都有记录。

有指标：用量和成功率清楚。

⚠️ 不足与局限

观测配置有成本。

日志要防敏感数据。

数据多了要清理。

🙋 适合谁用

AI 应用开发者：调试 Agent。

团队：监控 Agent 运行。

🛠️ 第一次安装

前提：电脑装了 Node.js（18+），有支持 Skill 的 AI 工具（如 Claude Code）。打开终端执行：

bash
npx skills add google/agents-cli --skill google-agents-cli-observability

CLI 会自动检测你装的 AI 助手，确认安装位置后即可使用。

✍️ 上手：几个真实例子

场景一：加追踪

提示词
帮我给这个 Agent 加运行追踪和关键指标监控。

场景二：排查

提示词
Agent 回答错了，帮我从追踪记录里定位问题。

🎯 典型应用场景

调试：定位 Agent 问题。

监控：观察运行状态。

追踪：复现问题。

⚖️ 和类似方案对比

和"黑盒跑 Agent"相比，observability 的价值是"看得见"——Agent 每一步怎么推理、调了什么工具、输出了什么，都有记录。这是把 Agent 当正经产品来维护的必要基础设施。

💡 常见问题 FAQ

问：追踪会拖慢吗？
有轻微开销，通常可接受。

问：要防什么？
别把用户隐私、密钥记进日志。

问：数据存多久？
按需求配置，定期清理。

问：能告警吗？
能，异常可以触发告警。

🤖 适合哪些 AI 工具

Google 官方 Skill，Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。