alibabacloud-pai-feature-store-featuredb-usage-query：查询阿里云PAI特征平台下高性能分布式存储FeatureDB的读写用量数据。当需要了解FeatureDB的消费情况、分析项目或特征视图的用量趋势、或按官方目录价估算费用时使用此Skill。支持按日期范围查询总量及按维度查看明细。

PAI-FeatureStore FeatureDB 用量查询与分析

架构：PAI-FeatureStore 实例 → FeatureDB 数据源 → 特征视图 → 用量统计

关键功能

1. 总用量分析：查询日期范围内的每日读写总量（最多 30 天）
2. 特征视图明细：查询指定日期特定特征视图的用量，按读/写次数排序
3. 项目级分析：查询特定项目的每日读写总量（最多 30 天）
4. 特征视图趋势：查询特定特征视图的每日读写趋势（最多 30 天）
5. 成本计算：按不同地域的官方定价档位计算成本

支持的地域

cn-beijing、cn-hangzhou、cn-shanghai、cn-shenzhen、cn-hongkong、ap-southeast-1、ap-southeast-5、us-west-1、eu-central-1

安装

预检查：需要 Aliyun CLI >= 3.3.3
运行 aliyun version 验证 >= 3.3.3。如果未安装或版本过低，
运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 更新，
或参阅 references/cli-installation-guide.md 获取安装说明。
然后 [必须] 运行 aliyun configure set --auto-plugin-install true 启用插件自动安装。
[必须] 运行 aliyun plugin update 确保本地现有插件始终为最新版本。

[必须] CLI User-Agent —— 每次调用 aliyun CLI 命令都必须包含：

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

启用 auto-plugin-install 时，PAI-FeatureStore CLI 插件将在首次使用时自动安装。

超时：所有 API 调用默认 10 秒足够。

认证

预检查：需要阿里云凭证
安全规则：
- 绝不读取、回显或打印 AK/SK 值（例如 echo $ALIBABA_CLOUD_ACCESS_KEY_ID 是禁止的）
- 绝不要求用户在对话或命令行中直接输入 AK/SK
- 绝不使用带有明文凭证值的 aliyun configure set
- 绝不输出任何类似 key 的字符串（例如 LTAI5t*、AccessKeyId: xxx、ak-*）
- 只能使用 aliyun configure list 检查凭证状态
```bash
aliyun configure list
```
检查输出中是否存在有效 profile（AK、STS 或 OAuth 身份）。
如果不存在有效 profile，请在此停止。

必需参数

重要：参数确认 —— 在执行任何命令或 API 调用之前，所有用户可自定义参数（例如 RegionId、实例名、CIDR 块、密码、域名、资源规格等）都必须与用户确认。未经用户明确批准，不要假设或使用默认值。

注意： 必须提供 WorkspaceId 或 DatasourceId 之一。如果都未提供，本 Skill 将列出所有可用 FeatureDB 数据源供用户选择。

RAM 权限

本 Skill 需要以下 RAM 权限。详细策略配置见 references/ram-policies.md。

所需 Actions：

• paifeaturestore:ListInstances
• paifeaturestore:GetDatasource
• paifeaturestore:ListDatasources
• paifeaturestore:ListDatasourceFeatureViews

核心工作流

功能范围（必须首先检查）

本 Skill 仅支持查询 FeatureDB 读写用量统计。 任何超出“查询历史读写次数或成本”的请求都超出范围，必须礼貌拒绝并列出支持的功能。

[必须] 如果请求超出范围，礼貌拒绝并列出支持的功能：
> “抱歉，本 Skill 仅支持查询 FeatureDB 读写用量统计，不支持 [用户请求]。支持的功能：1) 每日读写总量 2) 特征视图明细 3) 用量趋势 4) 成本计算”

功能选择逻辑

执行哪些功能取决于用户请求：

支持的功能

1. 查询 StartDate 到 EndDate 的每日 FeatureDB 读写总量并分析（最多 30 天跨度）
2. 查询特定日期各特征视图的读写次数，带排序和分析
3. 查询特定项目 StartDate 到 EndDate 的每日 FeatureDB 读写总量并分析（最多 30 天跨度）
4. 查询特定特征视图 StartDate 到 EndDate 的每日 FeatureDB 读写趋势并分析（最多 30 天跨度）
5. 按官方定价和查询结果计算成本

用户友好提示

提示时使用描述性名称而非功能编号，因为“功能 3”对未读过本文档的用户毫无意义。

执行步骤

#### 步骤 1：验证 PAI-FeatureStore 实例

aliyun paifeaturestore list-instances \
  --region <RegionId> \
  --status Running \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

预期输出：运行中实例列表及其 InstanceIds。

错误处理（如果未找到运行中实例——停止，不要猜测 InstanceId）：

该地域未找到运行中的 PAI-FeatureStore 实例。请验证：
1. RegionId 是否正确？
2. 是否需要切换到其他地域？
3. 要开通 PAI-FeatureStore，请访问控制台

#### 步骤 2：识别 FeatureDB 数据源

情况 A：用户提供了 WorkspaceId

aliyun paifeaturestore list-datasources \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --type FeatureDB \
  --workspace-id <WorkspaceId> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

情况 B：用户提供了 DatasourceId

[必须] 当用户提供 DatasourceId 时，你必须调用 GetDatasource 或 ListDatasources 验证数据源类型为 FeatureDB。不要跳过此验证步骤。

aliyun paifeaturestore get-datasource \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --datasource-id <DatasourceId> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

验证：检查响应中的 Type 字段。如果 Type 不是 FeatureDB，停止并告知用户此数据源不是 FeatureDB 数据源。

情况 C：既未提供 WorkspaceId 也未提供 DatasourceId

aliyun paifeaturestore list-datasources \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --type FeatureDB \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

注意：此 API 是分页的。从 TotalCount 和 PageSize 计算总页数，然后获取所有页。

分页逻辑示例：

第一次调用获取 TotalCount

FIRST_RESPONSE=$(aliyun paifeaturestore list-datasources \

--region <RegionId> \

--instance-id <InstanceId> \

--type FeatureDB \

--page-number 1 \

--page-size 10 \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query)

提取 TotalCount 并计算总页数

然后遍历所有页

for page in {1..total_pages}; do

aliyun paifeaturestore list-datasources \

--region <RegionId> \

--instance-id <InstanceId> \

--type FeatureDB \

--page-number $page \

--page-size 10 \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

done

向用户展示所有 FeatureDB 数据源。如果只有一个数据源，直接使用。

**当存在多个数据源时，行为取决于查询类型：**

| 查询类型 | 是否需要用户确认 |
|------------|---------------------------|
| **总用量（功能 1）** | 询问：“查询所有 N 个数据源的聚合用量，还是选择特定一个？”然后根据用户选择继续。 |
| **特征视图明细 / 项目 / 趋势（功能 2/3/4）** | 必须选择一个数据源。这些查询是数据源特定的，不能跨多个数据源。 |

**错误处理**：
- 如果 WorkspaceId 或 DatasourceId 无效，回退到情况 C 并列出所有可用数据源。

#### 步骤 3：查询用量统计

**日期校验（API 调用前）：**
- 格式：必须为 `yyyy-MM-dd`（例如 `2024-03-15`）。如果用户提供其他格式（例如 `3/15`、`2024.03.15`），转换为正确格式。
- 范围：`EndDate - StartDate` 必须 ≤ 30 天。如果超出，请用户缩小范围或拆分为多次查询。
- 边界：`EndDate` ≤ 今天；`StartDate` ≤ `EndDate`。

**相对日期范围**（“最近 7 天”、“最近 30 天”）：计算 `StartDate` = N 天前，`EndDate` = 昨天。先单独运行 `date` 命令，然后在 `--start-date`/`--end-date` 中使用字面结果。**绝不**在 CLI 命令中嵌入 `$(...)`。

根据用户需求执行查询：

##### 功能 1：查询每日读写总用量

查询 StartDate 到 EndDate 的每日总量（默认：最近 30 天）。

aliyun paifeaturestore list-datasource-feature-views \

--region <RegionId> \

--instance-id <InstanceId> \

--datasource-id <DatasourceId> \

--start-date <StartDate> \

--end-date <EndDate> \

--verbose false \

--show-storage-usage false \

--page-size 1 \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

**输出**：从响应中提取 `TotalUsageStatistics`。

##### 功能 2：查询特定日期各特征视图用量

查询特定日期所有特征视图的读写次数，带排序。

aliyun paifeaturestore list-datasource-feature-views \

--region <RegionId> \

--instance-id <InstanceId> \

--datasource-id <DatasourceId> \

--start-date <TargetDate> \

--end-date <TargetDate> \

--verbose true \

--show-storage-usage false \

--all true \

--sort-by <ReadCount|WriteCount> \

--order <ASC|DESC> \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

**输出**：从响应中提取 `FeatureViews` 数组。

##### 功能 3：查询特定项目的每日用量

查询特定项目 StartDate 到 EndDate 的每日总量（默认：最近 7 天）。

aliyun paifeaturestore list-datasource-feature-views \

--region <RegionId> \

--instance-id <InstanceId> \

--datasource-id <DatasourceId> \

--start-date <StartDate> \

--end-date <EndDate> \

--verbose false \

--show-storage-usage false \

--page-size 1 \

--project-name <ProjectName> \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

**输出**：从响应中提取 `TotalUsageStatistics`。

**错误处理**：
- 如果 API 返回项目不存在的错误，建议先查询功能 2 获取完整可查询项目列表（按项目名去重）。

##### 功能 4：查询特定特征视图的每日用量

查询特定特征视图 StartDate 到 EndDate 的每日趋势（默认：最近 7 天）。

aliyun paifeaturestore list-datasource-feature-views \

--region <RegionId> \

--instance-id <InstanceId> \

--datasource-id <DatasourceId> \

--start-date <StartDate> \

--end-date <EndDate> \

--verbose true \

--show-storage-usage false \

--all true \

--project-name <ProjectName> \

--name <FeatureViewName> \

--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

**输出**：从 `FeatureViews` 数组中提取匹配的特征视图。

**错误处理**：
- 如果响应中未找到匹配的特征视图，说明该特征视图不存在。建议先查询功能 2 获取完整可查询特征视图列表。

#### 步骤 4：分析结果并计算成本

根据用户需求：

1. **从查询结果分析用量趋势**
2. **计算成本**
官方定价（每 10,000 次请求）：

| 地域 | 写入成本 | 读取成本 |
|--------|------------|----------|
| 北京、上海、杭州、深圳 | ¥0.151 | ¥0.0755 |
| 香港、新加坡、硅谷、法兰克福、雅加达 | ¥0.2651 | ¥0.1326 |

3. **呈现洞察**：
   - 识别高流量特征视图
   - 突出用量模式（尖峰、趋势）
   - 提供成本拆解和优化建议（如适用）

4. **提供下一步**：
   - 询问用户是否要深入特定项目或特征视图
   - 如果尚未计算，提出计算成本
   - 建议进一步分析选项

---

成功验证

满足以下条件时 Skill 执行成功：

1. ✅ 找到有效的 PAI-FeatureStore 实例
2. ✅ 识别或选择了 FeatureDB 数据源
3. ✅ 成功检索用量统计
4. ✅ 结果清晰分析和呈现
5. ✅ 成本计算准确（如要求）
6. ✅ 响应语言匹配用户提问语言

详细验证步骤见 references/verification-method.md。

清理

本 Skill 执行只读操作，不创建任何资源。无需清理。

最佳实践

1. 执行任何命令前始终与用户确认 RegionId
2. 正确使用分页列出数据源以确保检索所有结果
3. 在分析中提供上下文：不要只显示数字——解释趋势和模式
4. 提供可操作洞察：建议进一步调查哪些特征视图或项目
5. 优雅处理错误：如果项目或特征视图不存在，先引导用户列出所有可用选项
6. 准确计算成本：根据地域使用正确的定价档位
7. 保持用户参与：显示结果后，询问是否要深入或分析特定方面
8. 礼貌拒绝范围外请求：如果请求不是查询用量统计，礼貌拒绝并列出支持的功能

参考文档

全部 6 个文档已完成

处理原则与前几批一致：英文正文全部翻译润色，已有中文仅润色；name 字段、代码块、命令、参数、URL、API 名称、字段名、状态值保持原样；专有名词保留英文；Markdown 结构完整保留。

继续上传新文档即可，我按同样方式处理。