数据分析

该分类包含 23 条以 system.analysis. 开头的 Runtime 系统命令。

1. 列出数据集

完整命令：system.analysis.dataset.list

列出分析数据集。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis dataset list \
  [--keyword value] [--cursor value] [--limit n] [--json]

参数：

keyword（可选）— Dataset name/description filter
cursor（可选）— Opaque nextCursor returned by the previous request
limit（可选）— Maximum items from 1 to 100

2. 获取数据集

完整命令：system.analysis.dataset.get

获取分析数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis dataset get --dataset-id <uuid> [--json]

参数：

datasetId（必填）— Discovered persistent dataset UUID

3. 查询数据集

完整命令：system.analysis.dataset.query

查询分析数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis dataset query \
  --dataset-id <uuid> (--query-json json|--query-file path) [--json]

参数：

datasetId（必填）— Discovered persistent dataset UUID
chartId（可选）— Optional discovered chart UUID for chart-aware execution
mode（可选）— aggregate (default) or detail
detailFields（可选）— Required non-empty dataset field keys when mode=detail
dimensions（可选）— Up to 12 discovered DIMENSION field keys
measures（可选）— Up to 12 discovered MEASURE field keys
metricSpecs（可选）— Explicit aggregate metrics; non-count functions require fieldKey
limit（可选）— Returned rows/categories from 1 to 100
timeGrain（可选）— day, week, month, quarter, or year
condition（可选）— A field/operator rule or recursive and/or group using dataset field keys
baseRecordTimeField（可选）— updatedAt or createdAt
pagination（可选）— Detail-query cursor page: opaque cursor, forward/backward direction, and one-to-five-page jump
bindingScript（可选）— Published Studio script binding for numeric computed measures

4. 创建数据集

完整命令：system.analysis.dataset.create

创建分析数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system analysis dataset create \
  (--definition-json json|--definition-file path) [--json]

参数：

name（必填）— Dataset name
description（可选）— Nullable description. Optional only on create
sourceConfig（必填）— Complete base form, joins, and computed-field configuration
fields（必填）— Complete persisted field snapshot

5. 更新数据集

完整命令：system.analysis.dataset.update

更新分析数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system analysis dataset update \
  --dataset-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：

datasetId（必填）— Existing editable dataset UUID
name（必填）— Dataset name
description（必填）— Nullable description. Optional only on create
sourceConfig（必填）— Complete base form, joins, and computed-field configuration
fields（必填）— Complete persisted field snapshot

6. 删除数据集

完整命令：system.analysis.dataset.delete

删除分析数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system analysis dataset delete \
  --dataset-id <uuid> [--delete-charts] [--json]

参数：

datasetId（必填）— Existing deletable dataset UUID
deleteCharts（可选）— Also delete dependent charts; otherwise dependencies reject deletion

7. 创建会话数据集

完整命令：system.analysis.session-dataset.create

从发现到的业务表单字段创建会话级数据集，供对话中的分析与图表交付使用；不会在可视化目录里保存条目。 · 风险：会话写入

sl system analysis session-dataset create \
  --thread-id <uuid> [--app-code value] \
  (--definition-json json|--definition-file path) [--json]

参数：

name（必填）— Conversation-scoped dataset name
sourceConfig（必填）— Complete base form and left-join graph
fields（必填）— One to 80 physical or expression-computed fields

8. 列出会话数据集

完整命令：system.analysis.session-dataset.list

列出分析会话数据集。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis session-dataset list \
  --thread-id <uuid> [--app-code value] [--json]

参数：无（除 --json 等通用选项外）。

9. 获取会话数据集

完整命令：system.analysis.session-dataset.get

获取分析会话数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis session-dataset get \
  --thread-id <uuid> --session-dataset-id <uuid> [--app-code value] \
  [--json]

参数：

sessionDatasetId（必填）— Session dataset UUID from this conversation

10. 查询会话数据集

完整命令：system.analysis.session-dataset.query

查询分析会话数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis session-dataset query \
  --thread-id <uuid> --session-dataset-id <uuid> [--app-code value] \
  (--query-json json|--query-file path) [--json]

参数：

sessionDatasetId（必填）— Session dataset UUID from this conversation
mode（可选）— aggregate (default) or detail
detailFields（可选）— Required non-empty dataset field keys when mode=detail
dimensions（可选）— Up to 12 discovered DIMENSION field keys
measures（可选）— Up to 12 discovered MEASURE field keys
metricSpecs（可选）— Explicit aggregate metrics; non-count functions require fieldKey
limit（可选）— Returned rows/categories from 1 to 100
timeGrain（可选）— day, week, month, quarter, or year
condition（可选）— A field/operator rule or recursive and/or group using dataset field keys
baseRecordTimeField（可选）— updatedAt or createdAt

11. 按会话删除会话数据集

完整命令：system.analysis.session-dataset.delete-for-thread

按会话删除分析会话数据集资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：会话写入

sl system analysis session-dataset delete-for-thread \
  --thread-id <uuid> [--app-code value] [--json]

参数：无（除 --json 等通用选项外）。

12. 创建会话报表

完整命令：system.analysis.session-report.create

用会话数据集在当前对话中渲染并交付交互式系统图表卡片，完成默认的对话可视化交付。 · 风险：会话写入

sl system analysis session-report create \
  --thread-id <uuid> [--app-code value] \
  (--definition-json json|--definition-file path) [--json]

参数：无（除 --json 等通用选项外）。

13. 发布会话报表

完整命令：system.analysis.session-report.publish

发布分析会话报表资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system analysis session-report publish \
  --thread-id <uuid> --message-id value --report-id <uuid> --name value \
  [--parent-id <uuid>] [--app-code value] [--json]

参数：无（除 --json 等通用选项外）。

14. 获取会话报表发布记录

完整命令：system.analysis.session-report.publication.get

获取分析会话报表发布记录资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis session-report publication get \
  --thread-id <uuid> --message-id value --report-id <uuid> \
  [--app-code value] [--json]

参数：无（除 --json 等通用选项外）。

15. 列出图表

完整命令：system.analysis.chart.list

列出分析图表。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis chart list \
  [--chart-type value] [--keyword value] [--cursor value] [--limit n] \
  [--json]

参数：

chartType（可选）— Exact chart type filter from chartConfiguration.enums.chartType
keyword（可选）— Case-insensitive chart-name/description filter
cursor（可选）— Opaque nextCursor returned by the previous request
limit（可选）— Maximum items from 1 to 100; defaults to 20

16. 获取图表

完整命令：system.analysis.chart.get

获取分析图表资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis chart get --chart-id <uuid> [--json]

参数：

chartId（必填）— Existing chart/dashboard UUID returned by chart list

17. 创建图表

完整命令：system.analysis.chart.create

仅在明确要求时把图表持久化到可视化目录；该命令不会在对话中交付图表卡片。 · 风险：写入

sl system analysis chart create \
  (--definition-json json|--definition-file path) [--json]

参数：

datasetId（必填）— Existing dataset UUID for charts; null for dashboards
parentId（必填）— Existing folder UUID or null for root
name（必填）— Displayed chart/dashboard name
description（必填）— Nullable management and tooltip description
chartType（必填）— Chart/dashboard renderer from chartConfiguration.enums.chartType
dataConfig（必填）— Complete data, permission, filter, or dashboard config described by chartConfiguration
visualConfig（必填）— Either {} or the complete visual config described by chartConfiguration
thumbnailUrl（必填）— Nullable preview image URL/data URL

18. 更新图表

完整命令：system.analysis.chart.update

更新分析图表资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system analysis chart update \
  --chart-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：

chartId（必填）— Existing editable chart/dashboard UUID
datasetId（必填）— Existing dataset UUID for charts; null for dashboards
parentId（必填）— Existing folder UUID or null for root
name（必填）— Displayed chart/dashboard name
description（必填）— Nullable management and tooltip description
chartType（必填）— Chart/dashboard renderer from chartConfiguration.enums.chartType
dataConfig（必填）— Complete data, permission, filter, or dashboard config described by chartConfiguration
visualConfig（必填）— Either {} or the complete visual config described by chartConfiguration
thumbnailUrl（必填）— Nullable preview image URL/data URL

19. 删除图表

完整命令：system.analysis.chart.delete

删除分析图表资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system analysis chart delete --chart-id <uuid> [--json]

参数：

chartId（必填）— Existing deletable chart/dashboard UUID

20. 列出文件夹

完整命令：system.analysis.folder.list

列出分析文件夹。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system analysis folder list \
  [--keyword value] [--cursor value] [--limit n] [--json]

参数：

keyword（可选）— Case-insensitive folder-name filter
cursor（可选）— Opaque nextCursor returned by the previous request
limit（可选）— Maximum items from 1 to 100; defaults to 20

21. 创建文件夹

完整命令：system.analysis.folder.create

创建分析文件夹资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system analysis folder create \
  --name value [--parent-id <uuid>] [--json]

参数：

name（必填）— Folder name, trimmed and limited to 100 characters
parentId（可选）— Existing parent-folder UUID; omit or use null to create at root

22. 删除文件夹

完整命令：system.analysis.folder.delete

删除分析文件夹资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system analysis folder delete \
  --folder-id <uuid> \
  (--delete-charts|--target-parent-id <uuid>|--move-to-root) [--json]

参数：

folderId（必填）— Folder-tree root UUID to delete
deleteCharts（必填）— true deletes charts in this folder tree; false moves them before deleting the tree
targetParentId（可选）— Required when deleteCharts=false. Use an existing folder UUID to move charts there, or null to move them to root

23. 查询已保存报表或图表

完整命令：system.analysis.chart.query

按报表保存的字段、筛选、聚合、时间粒度和绑定脚本读取租户当前数据。需要报表查看和来源数据读取权限。支持报表和单个图表，不支持仪表板。 · 风险：读取

sl system analysis chart query --chart-id <uuid> [--json]

chartId（必填）：从 /visualization/view/<uuid> 链接或 system.analysis.chart.list 获取的 UUID。
返回 queryResult 和 limits。当 limits.truncated 为 true 时，分析需要说明条数或分类上限。
自动化配置：可视化 → 智能体执行（填写分析指令）→ 消息（群聊）。自动化智能体和群聊智能体均需启用此命令，才可查询报表。群聊中引用报表链接时，平台先校验智能体已启用此命令，再按本次提问者的报表及来源数据权限读取，分析结果作为普通文本发送到群聊。

1. 列出数据集​

2. 获取数据集​

3. 查询数据集​

4. 创建数据集​

5. 更新数据集​

6. 删除数据集​

7. 创建会话数据集​

8. 列出会话数据集​

9. 获取会话数据集​

10. 查询会话数据集​

11. 按会话删除会话数据集​

12. 创建会话报表​

13. 发布会话报表​

14. 获取会话报表发布记录​

15. 列出图表​

16. 获取图表​

17. 创建图表​

18. 更新图表​

19. 删除图表​

20. 列出文件夹​

21. 创建文件夹​

22. 删除文件夹​

23. 查询已保存报表或图表​

1. 列出数据集

2. 获取数据集

3. 查询数据集

4. 创建数据集

5. 更新数据集

6. 删除数据集

7. 创建会话数据集

8. 列出会话数据集

9. 获取会话数据集

10. 查询会话数据集

11. 按会话删除会话数据集

12. 创建会话报表

13. 发布会话报表

14. 获取会话报表发布记录

15. 列出图表

16. 获取图表

17. 创建图表

18. 更新图表

19. 删除图表

20. 列出文件夹

21. 创建文件夹

22. 删除文件夹

23. 查询已保存报表或图表