跳到主要内容

使用案例

OpenInsight 将数据平台中的表、任务、仪表盘、图表和业务知识整理成本地可读的项目目录，让 Agent 可以先读取上下文，再执行查询和诊断。

查询业务数据​

当用户提出一个业务问题时，Agent 可以先定位相关数据集和表，再生成 SQL 查询：

openinsight current
openinsight table find orders
openinsight cluster query "select * from fxxb0507 limit 10"

适合用于：

  • 查询核心指标和明细数据
  • 对齐业务口径、过滤条件和字段含义
  • 将分析过程沉淀到 datasets/ 和 knowledge/

排查数据产出​

当数据未按预期产出时，可以查看调度任务、血缘和运行实例：

openinsight task list
openinsight task instances --task-code <task_code>
openinsight task lineage <task_id> --format table
openinsight table lineage <node_id> --format table
openinsight taskrun list --from 2026-07-09 --to 2026-07-10

适合用于：

  • 追踪上游依赖是否完成
  • 定位失败或延迟的调度任务
  • 判断某个数据集是否受到下游影响

理解仪表盘​

当需要解释 BI 看板口径或复用图表查询时，可以读取仪表盘和图表配置：

openinsight dashboard list
openinsight dashboard get <dashboard_id>
openinsight chart list --dashboard <dashboard_id>
openinsight chart query <chart_id> --dashboard <dashboard_id>

适合用于：

  • 梳理看板中的指标和图表来源
  • 复现图表背后的查询结果
  • 辅助 Agent 回答「这个看板为什么变化」一类问题

更多对象结构和字段契约见 Object Model。