:dog2: 为你的 AI Agent 配备一只小狗：Pup CLI 介绍

注意：本项目目前处于预览（Preview）阶段，我们正在对交互逻辑进行微调并修复潜在 Bug。欢迎提交 Issue 或 PR。感谢你的早期关注！

每个 AI Agent 都需要一个忠实的伙伴。来认识一下 Pup —— 这个 CLI 工具能让你的 Agent 全面访问 Datadog 的可观测性平台（因为即便是自主 Agent 也需要好的工具，而不仅仅是把戏）。

什么是 Pup？

Pup 是一个功能全面、专为 AI Agent 设计的 CLI，涵盖了 57 个 Datadog 产品域，提供超过 325 个指令。我们释放了 Datadog API 的全部潜能，让你的 Agent 可以获取指标、追踪错误并定位问题，而无需在错误的 API 树上“乱吠”。

AI Agent 是基础设施管理领域增长最快的接口。Vercel 和 AWS 等公司正竞相使其平台支持 Agent 访问，但我们处于领先地位。Pup 凭借 100% 的 API 文档覆盖率，让 Datadog 成为 AI 原生工作流的首选，而竞争对手还在学习基础指令。

为什么你的 Agent 会爱上它

• :paw_prints: 训练有素：支持指令自发现（无需反复查阅文档）
• :guide_dog: 服从指令：输出结构化的 JSON/YAML，易于解析
• :service_dog: 严加管束：支持 OAuth2 + PKCE 授权访问（不再需要长期有效的密钥，避免安全风险）
• :dog: 精通各项技能：监控、日志、指标、RUM、安全等应有尽有！

试用一下（也欢迎人类使用！）

# 为你的 Agent 配置凭据（相当于居家训练）
pup auth login

# 现在它们可以像好狗狗一样获取数据了
pup monitors list --tags="team:api-platform"         # 获取监控器
pup logs search --query="status:error" --from="1h"   # 搜寻错误
pup metrics query --query="avg:system.cpu.user{*}"   # 追踪指标趋势

:dog: TL;DR：我们构建了一个全面的 CLI，让 AI Agent 能像专业人士一样使用 Datadog。给你的 Agent 配一只 Pup 吧。它们经过居家训练、忠诚可靠，并且掌握的技巧远超你的想象。

附言：制作此 CLI 的过程中没有真正的狗狗受到伤害。只有大量的 Rust 代码和 API 端点。

API 覆盖范围

Pup 实现了 85+ 个可用 Datadog API 中的 54 个（覆盖率 63%），跨越 58 个指令组，拥有 325+ 个子指令。

详细指令参考请参见 docs/COMMANDS.md。

💡 提示：使用 Ctrl/Cmd+F 搜索特定 API。通过 GitHub Issues 请求新功能。

---

📊 核心可观测性 (5/9 已实现)

API 领域	状态	Pup 指令	备注
Metrics	✅	metrics search, metrics query, metrics list, metrics get	支持 V1 和 V2 API
Logs	✅	logs search, logs list, logs aggregate	支持 V1 和 V2 API
Events	✅	events list, events search, events get	基础设施事件管理
RUM	✅	rum apps, rum sessions, rum metrics, rum retention-filters, rum playlists, rum heatmaps	应用、会话、指标、保留过滤器、重播播放列表、热力图
APM Services	✅	apm services, apm entities, apm dependencies, apm flow-map	服务统计、操作、资源；实体查询；依赖关系；流程可视化
Traces	❌	-	尚未实现
Profiling	❌	-	尚未实现
Session Replay	❌	-	尚未实现
Spans Metrics	❌	-	尚未实现

🔔 监控与告警 (8/10 已实现)

API 领域	状态	Pup 指令	备注
Monitors	✅	monitors list, monitors get, monitors delete, monitors search	支持完整 CRUD 及高级搜索
Dashboards	✅	dashboards list, dashboards get, dashboards delete, dashboards url	完整的管理功能
SLOs	✅	slos list, slos get, slos delete, slos status	支持完整 CRUD 及 V2 状态查询
Synthetics	✅	synthetics tests, synthetics locations, synthetics suites	测试、位置及 V2 套件管理
Downtimes	✅	downtime list, downtime get, downtime cancel	完整的停机时间管理
Notebooks	✅	notebooks list, notebooks get, notebooks delete	支持调查笔记
Status Pages	✅	status-pages pages, status-pages components, status-pages degradations	新增 — 页面、组件及退化管理
Dashboard Lists	❌	-	尚未实现
Powerpacks	❌	-	尚未实现
Workflow Automation	✅	workflows get, workflows create, workflows update, workflows delete, workflows run, workflows instances	完整的 CR