能力标签

🔌 MCP 🤖 Agent 🔄 工作流 💻 CLI 🔗 REST API 🧠 Claude ✨ GPT

⚙️

Agent工作流

开源AI工作流：Pup

基于 Rust · 无代码搭建完整 AI 自动化流程

英文名：pup

⭐ 820 Stars 🍴 78 Forks 💻 Rust 📄 Apache-2.0 🏷 AI 7.5分

7.5AI 综合评分

workflowcliclientdatadogobservability

⬇ 下载源码 ZIP ⚙️ 配置说明

✦ AI Skill Hub 推荐

开源AI工作流：Pup 是 AI Skill Hub 本期精选Agent工作流之一。综合评分 7.5 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

开源AI工作流：Pup 是一套完整的 AI Agent 自动化工作流方案。随着 AI 能力的不断提升，基于 Agent 的自动化工作流正在成为提升个人和团队效率的核心方式。区别于传统的 RPA 自动化（模拟鼠标键盘操作），AI Agent 工作流通过理解任务意图、动态规划执行路径，能够处理更复杂的非结构化任务。

开源AI工作流：Pup 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。

在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 7.5 分，是同类 Agent 工作流中的精选推荐。

📋 工具概览

Pup是一个开源的AI工作流，提供了200+命令，支持33+Datadog功能，帮助您更好地管理和观察您的AI系统。

开源AI工作流：Pup 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。

GitHub Stars

⭐ 820

开发语言

Rust

支持平台

Windows / macOS / Linux

维护状态

正常维护，社区驱动

开源协议

Apache-2.0

AI 综合评分

7.5 分

工具类型

Agent工作流

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

Pup是一个开源的AI工作流，提供了200+命令，支持33+Datadog功能，帮助您更好地管理和观察您的AI系统。

📌 核心特色

可视化 Agent 工作流编排，无需编写复杂代码
支持多步骤自动化任务链，实现全流程无人值守
与外部 API、数据库和第三方服务无缝集成
内置错误处理与自动重试机制，保障稳定运行
提供可复用的自动化模板，快速在同类场景部署

🎯 主要使用场景

自动化日常重复性工作，将精力集中于创造性任务
构建数据采集 → 处理 → 输出的完整自动化管线
实现跨平台、跨系统的数据流转和业务协同

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：cargo install（推荐）
cargo install pup

# 方式二：从源码编译
git clone https://github.com/DataDog/pup
cd pup
cargo build --release
# 二进制在 ./target/release/pup

📋 安装步骤说明

访问 GitHub 仓库获取工作流文件
在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
上传工作流文件
按照提示配置必要的环境变量和 API Key
运行测试确认流程正常后投入使用

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 查看帮助
pup --help

# 基本运行
pup [options] <input>

# 详细使用说明请查阅文档
# https://github.com/DataDog/pup

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# pup 配置说明
# 查看配置选项
pup --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export PUP_CONFIG="/path/to/config.yml"

📑 README 深度解析真实文档完整度 82/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

:dog2: Give Your Agent a Puppy: Introducing Pup CLI

Every AI agent needs a loyal companion. Meet Pup — the CLI that gives your agents full access to Datadog's observability platform (because even autonomous agents need good tooling, not just tricks).

Runbook Features

Step types: pup (Datadog commands), shell, http, datadog-workflow, confirm
Variable interpolation: {{VAR_NAME}} in any field, passed via --arg KEY=VALUE
Reusable templates: Store shared step definitions in _templates/ and reference them with template: <name>
HTTP steps: Full method support (GET/POST/PUT/PATCH/DELETE) with body, headers, content_type, and body_file
Failure handling: on_failure: fail|warn|ignore and optional: true per step
Conditional execution: when: on_success|on_failure|always
Polling: poll.interval, poll.timeout, poll.until for long-running operations
Output capture: capture: VAR_NAME stores stdout for use in later steps
Timestamped output: Every step shows start time, elapsed duration, and labeled stdout/stderr

See docs/examples/runbooks/ for ready-to-use examples and docs/EXAMPLES.md for full reference.

Run a runbook, passing required variables

pup runbooks run deploy-service --arg SERVICE=payments --arg VERSION=1.2.3

Installation

Build from Source

git clone https://github.com/DataDog/pup.git && cd pup
cargo build --release
cp target/release/pup /usr/local/bin/pup

Building

```bash

Install the WASI target

rustup target add wasm32-wasip2

Build for WASI

cargo build --target wasm32-wasip2 --no-default-features --features wasi --release ```

Install all skills and agents for the auto-detected platform

pup skills install

Install for a specific platform (positional arg)

pup skills install claude pup skills install cursor pup skills install codex pup skills install opencode pup skills install pi

Install for every supported platform at once

pup skills install all

By default installs go to the user-global directory; --project keeps them local

pup skills install claude --project

Install a specific skill by name

pup skills install claude --name dd-monitors


For Claude Code, skills install to `~/.claude/skills/` (or `.claude/skills/` with `--project`) and agents install to `~/.claude/agents/` (native subagent format). For Cursor, Codex, and opencode, everything installs as `SKILL.md` under that tool's skills directory (e.g. `~/.cursor/skills/`, `~/.codex/skills/`, `~/.config/opencode/skills/`).

Pup ships plugin manifest files for several AI coding assistants:

Build

cargo build --release

Build WASM

rustup target add wasm32-wasip2 cargo build --target wasm32-wasip2 --no-default-features --features wasi

Run without building

cargo run -- monitors list ```

the Named session examples below).

pup auth login --site datadoghq.eu DD_SITE=datadoghq.eu pup monitors list

Usage

Set your Datadog site (optional, defaults to datadoghq.com).

Environment Variables

DD_ACCESS_TOKEN: Bearer token for stateless auth (highest priority)
DD_API_KEY: Datadog API key (optional if using OAuth2 or DD_ACCESS_TOKEN)
DD_APP_KEY: Datadog Application key (optional if using OAuth2 or DD_ACCESS_TOKEN)
DD_SITE: Datadog site (default: datadoghq.com)
DD_AUTO_APPROVE: Auto-approve destructive operations (true/false)
DD_TOKEN_STORAGE: Token storage backend (keychain or file, default: auto-detect)

Environment variable override

FORCE_AGENT_MODE=1 pup monitors list ```

If you are integrating pup into an AI agent workflow, make sure the appropriate environment variable is set so responses are optimized for your agent. Without it, pup defaults to human-friendly output.

Option 1: Bearer token

DD_ACCESS_TOKEN="your-token" DD_SITE="datadoghq.com" wasmtime run target/wasm32-wasip2/release/pup.wasm -- monitors list

Option 2: API keys

DD_API_KEY="your-api-key" DD_APP_KEY="your-app-key" wasmtime run target/wasm32-wasip2/release/pup.wasm -- monitors list ```

The pup auth status command works in WASM and reports which credentials are configured. The login, logout, and refresh subcommands return guidance to use DD_ACCESS_TOKEN.

API Coverage

Pup covers most major Datadog product surfaces. See docs/COMMANDS.md for the canonical command reference, or run pup --help (or pup agent schema for machine-readable output) for the live list of commands as built.

💡 Tip: Use Ctrl/Cmd+F to search for specific APIs. Request features via GitHub Issues.

---

<details> <summary>📊 Core Observability</summary>

API Domain	Status	Pup Commands	Notes
Metrics	✅	`metrics search`, `metrics query`, `metrics list`, `metrics get`	V1 and V2 APIs supported
Logs	✅	`logs search`, `logs list`, `logs aggregate`	V1 and V2 APIs supported
Events	✅	`events list`, `events search`, `events get`	Infrastructure event management
RUM	✅	`rum apps`, `rum sessions`, `rum metrics`, `rum retention-filters`, `rum playlists`, `rum heatmaps`	Apps, sessions, metrics, retention filters, replay playlists, heatmaps
APM Services	✅	`apm services`, `apm entities`, `apm dependencies`, `apm flow-map`	Services stats, operations, resources; entity queries; dependencies; flow visualization
Traces	✅	`traces search`, `traces aggregate`, `traces metrics`	Span search/aggregation and span-based metric definitions
Profiling	⏳	`profiling`	Not supported in pup yet. Use the Datadog MCP server: https://docs.datadoghq.com/bits_ai/mcp_server. Enable with: https://mcp.datadoghq.com/api/unstable/mcp-server/mcp?toolsets=core,profiling
Database Monitoring	✅	`dbm samples search`	DBM query sample search
Session Replay	❌	-	Not yet implemented

</details>

<details> <summary>🔔 Monitoring & Alerting</summary>

API Domain	Status	Pup Commands	Notes
Monitors	✅	`monitors list`, `monitors get`, `monitors delete`, `monitors search`	Full CRUD support with advanced search
Dashboards	✅	`dashboards list`, `dashboards get`, `dashboards delete`, `dashboards url`	Full management capabilities
SLOs	✅	`slos list`, `slos get`, `slos delete`, `slos status`	Full CRUD plus V2 status query
Synthetics	✅	`synthetics tests`, `synthetics locations`, `synthetics suites`	Tests, locations, and V2 suites management
Downtimes	✅	`downtime list`, `downtime get`, `downtime cancel`	Full downtime management
Notebooks	✅	`notebooks list`, `notebooks get`, `notebooks delete`	Investigation notebooks supported
Status Pages	✅	`status-pages pages`, `status-pages components`, `status-pages degradations`	New — Pages, components, and degradation management
Powerpacks	❌	-	Not yet implemented
Workflow Automation	✅	`workflows get`, `workflows create`, `workflows update`, `workflows delete`, `workflows run`, `workflows instances`	Full CRUD plus run and instance management (list, get, cancel)
Local Runbooks	✅	`runbooks list`, `runbooks describe`, `runbooks run`, `runbooks import`, `runbooks validate`	New — YAML-defined multi-step runbooks with pup/shell/http/workflow step types, variable interpolation, and reusable templates

</details>

<details> <summary>🔒 Security & Compliance</summary>

API Domain	Status	Pup Commands	Notes
Security Monitoring	✅	`security rules`, `security signals`, `security findings`, `security content-packs`, `security risk-scores`	Rules, signals, findings, content packs, entity risk scores
Cloud Security	✅	`security findings analyze`, `security findings schema`	DDSQL analytics for misconfigurations, identity risks, and all Cloud Security finding types
Application Security	✅	`security findings analyze`, `security asm-custom-rules`, `security asm-exclusions`	API findings via DDSQL, WAF custom rules and exclusion filters
Static Analysis	✅	`static-analysis ast`, `static-analysis custom-rulesets`, `static-analysis sca`, `static-analysis coverage`	Code security analysis
Audit Logs	✅	`audit-logs list`, `audit-logs search`	Full audit log search and listing
Data Governance	✅	`data-governance scanner-rules list`	Sensitive data scanner rules
CSM Threats	✅	`csm-threats`	Cloud Security Management threat rules and agent rules
Sensitive Data Scanner	✅	`data-governance scanner-rules list`	Listed via Data Governance row above
Agentless Scanning	✅	`agentless-scanning aws list/get/create/update/delete`, `agentless-scanning gcp list`, `agentless-scanning azure list`	Cloud agentless scanning configuration for AWS, GCP, and Azure
Logs Restriction	✅	`logs-restriction list`, `logs-restriction get`, `logs-restriction create`, `logs-restriction update`, `logs-restriction delete`	Log restriction queries for fine-grained log access control
Data Deletion	✅	`data-deletion requests list`, `data-deletion requests create`, `data-deletion requests cancel`	GDPR/compliance data deletion request management

</details>

<details> <summary>☁️ Infrastructure & Cloud</summary>

API Domain	Status	Pup Commands	Notes
Infrastructure	✅	`infrastructure hosts list`, `infrastructure hosts get`	Host inventory management
Tags	✅	`tags list`, `tags get`, `tags add`, `tags update`, `tags delete`	Host tag operations
Network	✅	`network flows list`, `network devices`, `network interfaces`	Network flows, device inventory, interface tags
Cloud (AWS)	✅	`cloud aws list`, `cloud aws cloud-auth persona-mappings`	AWS integration management with persona mapping CRUD
Cloud (GCP)	✅	`cloud gcp list`	GCP integration management
Cloud (Azure)	✅	`cloud azure list`	Azure integration management
Cloud (OCI)	✅	`cloud oci`	Oracle Cloud tenancy configs and products
Containers	✅	`containers list`, `containers images list`	Containers
Processes	✅	`processes list`	Process inventory query

</details>

<details> <summary>🚨 Incident & Operations</summary>

API Domain	Status	Pup Commands	Notes
Incidents	✅	`incidents list`, `incidents get`, `incidents attachments`, `incidents settings`, `incidents handles`, `incidents postmortem-templates`	Incident management with settings, handles, and postmortem templates
On-Call (Teams)	✅	`on-call teams` (CRUD, memberships with roles)	Full team management system with admin/member roles
Case Management	✅	`cases` (create, search, assign, archive, projects, jira, servicenow, move)	Complete case management with Jira/ServiceNow linking
Error Tracking	✅	`error-tracking issues search`, `error-tracking issues get`	Error issue search and details
Service Catalog	✅	`service-catalog list`, `service-catalog get`	Service registry management
Scorecards	✅	`scorecards list`, `scorecards get`	Service quality scores
Fleet Automation	✅	`fleet agents`, `fleet deployments`, `fleet schedules`	Agent management, deployments, schedules (Preview)
HAMR	✅	`hamr connections get`, `hamr connections create`	New — High Availability Multi-Region connections
Investigations	✅	`investigations list`, `investigations get`, `investigations trigger`	Bits AI SRE investigation management
Change Management	✅	`change-management create`, `change-management get`, `change-management update`, `change-management create-branch`, `change-management decisions`	Change request management with decisions and branching
Incident Services/Teams	✅	`incidents services`, `incidents teams`	Service and team CRUD scoped to incident management
Live Debugger	✅	`debugger probes list`, `debugger probes get`, `debugger probes create`, `debugger probes delete`, `debugger probes watch`	Remote log probe management for Live Debugger
Software Catalog	✅	`software-catalog entities list`, `software-catalog entities upsert`, `software-catalog kinds list`, `software-catalog relations list`	Software Catalog entity and kind management (next-gen catalog)

</details>

<details> <summary>🔧 CI/CD & Development</summary>

API Domain	Status	Pup Commands	Notes
CI Visibility	✅	`cicd pipelines list`, `cicd events list`	CI/CD pipeline visibility and events
Test Optimization	✅	`cicd tests`, `cicd flaky-tests`, `test-optimization`	Test events, flaky test management, and Test Optimization API
DORA Metrics	✅	`cicd dora`	DORA deployment patching
Code Coverage	✅	`code-coverage branch-summary`, `code-coverage commit-summary`	Branch and commit-level coverage summaries
Deployment Gates	✅	`deployment-gates gates`, `deployment-gates evaluations`, `deployment-gates rules`	Deployment gate CRUD, evaluation triggers, and rule management

</details>

<details> <summary>👥 Organization & Access</summary>

API Domain	Status	Pup Commands	Notes
Users	✅	`users list`, `users get`, `users roles`, `users seats`	User and role management with seat assignment
Organizations	✅	`organizations get`, `organizations list`	Organization settings management
API Keys	✅	`api-keys list`, `api-keys get`, `api-keys create`, `api-keys delete`	Full API key CRUD
App Keys	✅	`app-keys list`, `app-keys get`, `app-keys create`, `app-keys update`, `app-keys delete`	Full application key CRUD
Service Accounts	✅	-	Managed via users commands
Roles	❌	-	Only list via users
AuthN Mappings	✅	`authn-mappings list`, `authn-mappings get`, `authn-mappings create`, `authn-mappings update`, `authn-mappings delete`	SAML/IdP attribute-to-role authentication mappings

</details>

<details> <summary>⚙️ Platform & Configuration</summary>

API Domain	Status	Pup Commands	Notes
Usage Metering	✅	`usage summary`, `usage hourly`	Usage and billing metrics
Cost Management	✅	`costs datadog projected`, `costs datadog attribution`, `costs datadog by-org`, `costs datadog aws-config`, `costs datadog azure-config`, `costs datadog gcp-config`, `costs ccm custom-costs`, `costs ccm tag-descriptions`, `costs ccm tag-metadata`, `costs ccm tags`, `costs ccm tag-keys`, `costs ccm budgets`, `costs ccm commitments`	Cost attribution, cloud cost configs (AWS/Azure/GCP), and Cloud Cost Management (custom costs, tag descriptions, budgets, commitment programs)
Product Analytics	✅	`product-analytics events send`, `product-analytics query`	Server-side product analytics events and queries
Integrations	✅	`integrations slack`, `integrations pagerduty`, `integrations webhooks`, `integrations jira`, `integrations servicenow`, `integrations google-chat`, `integrations ms-teams`	Third-party integrations including Jira, ServiceNow, Google Chat, and Microsoft Teams
Feature Flags	✅	`feature-flags flags`, `feature-flags environments`, `feature-flags allocations`, `feature-flags exposure`, `feature-flags enable`, `feature-flags disable`	Feature flag management with environment, allocation, and exposure control
Data Streams (Kafka)	✅	`kafka topic-configs`, `kafka broker-configs`, `kafka client-configs`, `kafka read-messages`	Experimental — Kafka cluster inspection via Datadog
Restricted Datasets	✅	`datasets list`, `datasets get`, `datasets create`, `datasets update`, `datasets delete`	Restricted dataset management for data access control
Observability Pipelines	✅	`obs-pipelines list`, `obs-pipelines get`, `obs-pipelines create`, `obs-pipelines update`, `obs-pipelines delete`, `obs-pipelines validate`	Full pipeline CRUD and validation
LLM Observability	✅	`llm-obs projects`, `llm-obs experiments`, `llm-obs datasets`	New — LLM Obs projects, experiments, and dataset management
Reference Tables	✅	`reference-tables list`, `reference-tables get`, `reference-tables create`, `reference-tables batch-query`	New — Reference table management for log enrichment
Miscellaneous	✅	`misc ip-ranges`, `misc status`	IP ranges and status
App Builder	✅	`app-builder list`, `app-builder get`, `app-builder create`, `app-builder update`, `app-builder delete`, `app-builder publish`	Low-code app management with publish/unpublish and batch delete
Key Management	✅	`api-keys`, `app-keys`	API key and application key CRUD (listed in Organization & Access above)
IP Allowlist	❌	-	Not yet implemented

</details>

API Key Authentication (Fallback)

If OAuth2 tokens are not available, Pup automatically falls back to API key authentication.

```bash export DD_API_KEY="your-datadog-api-key" export DD_APP_KEY="your-datadog-application-key" export DD_SITE="datadoghq.com" # Optional, defaults to datadoghq.com