---
name: umengcli-inspection
description: 友盟投放巡检技能，支持查询投放进展、监控投放状态等操作
metadata:
  requires:
    bins: ["umeng-cli"]
  cliHelp: "umeng-cli umengcli-inspection --help"
---

# 友盟投放巡检技能

> `umeng-cli` 是友盟提供的命令行程序，所有操作通过执行 `umeng-cli` 命令完成。

管理友盟平台的投放巡检，包括查询投放进展、监控投放状态等操作。

## 操作

### 1. 查询投放进展

查询当前账户的投放进展信息：

**调用示例：**

```bash
umeng-cli umengcli-inspection query_delivery_progress
```

**参数说明：**

- 无需额外参数，自动使用当前登录账户

**返回格式：**

```json
{
  "code": 200,
  "msg": "success",
  "status": true,
  "data": {
    "currentConsumption": "5000.00",
    "totalBudget": "10000",
    "targetAchievementRate": "50.00%",
    "estimatedMinDailyConsumption": "8550",
    "estimatedMaxDailyConsumption": "10450",
    "todayConversionPrice": "25.50",
    "yesterdayConversionPrice": "28.00",
    "updateTime": 1710806400
  }
}
```

**返回字段说明：**

| 字段 | 类型 | 说明 |
|------|------|------|
| `code` | integer | 状态码，200表示成功 |
| `msg` | string | 返回信息 |
| `status` | boolean | 操作状态 |
| `data.currentConsumption` | string | 当前消耗金额 |
| `data.totalBudget` | string | 总预算 |
| `data.targetAchievementRate` | string | 目标达成率 |
| `data.estimatedMinDailyConsumption` | string | 预估最小日消耗 |
| `data.estimatedMaxDailyConsumption` | string | 预估最大日消耗 |
| `data.todayConversionPrice` | string | 今日转化单价 |
| `data.yesterdayConversionPrice` | string | 昨日转化单价 |
| `data.updateTime` | integer | 更新时间戳 |

---

## 典型工作流

### 工作流 1：查询投放进展

用户问："帮我查一下投放进展？"

1. 调用 `query_delivery_progress` 获取投放进展
2. 展示关键指标：当前消耗、总预算、目标达成率

**示例：**

```bash
umeng-cli umengcli-inspection query_delivery_progress
```

---

## 注意事项

- ⚠️ **无需参数**：该接口无需额外参数，自动使用当前登录账户
- ⚠️ **金额字段**：返回的金额字段是字符串类型，需要转换后进行计算
- ⚠️ **时间戳**：`updateTime` 是 Unix 时间戳（秒）

---

## 快速参考

### 接口说明

| 接口 | 用途 | 输入 | 返回 |
|------|------|------|------|
| `query_delivery_progress` | 查询投放进展 | 无需参数 | 投放进展信息 |

### 参数格式

```bash
# 正确 ✅
umeng-cli umengcli-inspection query_delivery_progress

# 也可以使用默认空参数
umeng-cli umengcli-inspection query_delivery_progress '{}'
```

### 通用 call 调用方式

也可以使用 `call` 命令直接传入 schema 调用，无需预注册命令：

```bash
umeng-cli call '{
  "name": "query_delivery_progress",
  "description": "查询投放进展",
  "inputSchema": {"type": "object", "properties": {}},
  "api": {
    "method": "POST",
    "baseUrl": "https://appwin.umeng.com",
    "endpoint": "/hsf/fagent/inspection/queryDeliveryProgress",
    "headers": {"content-type": "application/json", "accept": "application/json"},
    "timeout": 30,
    "requireAuth": true
  }
}' '{}'
```
