前言¶
把 SmartBI 接进 Agent，通常要自己写脚本：翻接口清单、处理鉴权、拼 MQL 或 SQL、再分别处理报表问数、模型查询、定时任务、消息推送这些互不相干的入口。每次需求变化都要重写一遍。下面介绍的 Skill 把这类操作收敛成一套可被 Agent 调用的技能，按自然语言意图选择对应的 SmartBI 能力。
这是什么¶
Smartbi CLI 套件（坐标 @org-n6d0247v/smartbi-cli-suite）是广州思迈特软件有限公司（思迈特）发布的 SmartBI 通用业务操作技能，属于企业来源（enterprise）技能，当前版本 2.3.0，分类 data-analysis。
它解决的问题是：Agent 缺少对 SmartBI 的结构化操作入口，导致取数、问数和运维管理都要靠临时脚本。技能内部通过 @smartbi/cli 发现并调用当前环境的 SmartBI API，不需要使用者自己维护接口映射。
核心能力¶
按官方简介，这个 Skill 覆盖的操作分四类。
- 连接与取数：连接 SmartBI；查询数据模型或指标模型；通过 MQL 与只读 SQL 直接取数。
- 问数：对已有报表问数；AI 问数与复杂洞察。
- 资产管理：智能体、知识库与知识图谱、数据模型、数据源、资源及权限。
- 调度与通知：定时任务与 ETL、消息推送。
这些能力共用同一个入口，Agent 按用户意图选择，不用为每类操作单独写调用逻辑。取数侧明确支持 MQL 和只读 SQL 两种方式。
安装与启用¶
Skill 基于通用 SKILL.md 格式，在支持该格式的 Agent 环境中按坐标引入：
@org-n6d0247v/smartbi-cli-suite
已抓取的官方资料中没有给出具体的安装命令和配置文件路径，也没有区分 Cursor、Codex CLI、Claude Code 的差异，这部分需要以官方页面为准，本文不推测命令写法。
启用前需要注意一个来自官方标签的硬性条件：requires_api_key=true，即必须先准备好可用的 API Key 才能调用，否则技能无法连上当前环境的 SmartBI。
典型用法¶
已抓取资料中没有提供可复现的命令行示例或对话样例，因此本节只说明调用路径，不给出具体参数。
调用方式是：由 Agent 解析用户意图，技能通过 @smartbi/cli 发现当前环境可用的 SmartBI API，再发起调用。涉及取数时，可以使用 MQL，也可以使用只读 SQL；后者只能做查询，不能写。
适用场景与注意¶
适合已经在用 SmartBI、希望让 Agent 承担取数、报表问数、指标查询和日常运维管理的操作者。技能把智能体、知识库、知识图谱、数据源、定时任务、ETL、消息推送、资源与权限这些分散入口统一到一套调用里，适合需要批量编排这些操作的场景。
需要注意三点。
- 依赖 API Key，部署前要先确认密钥可用，并确认技能调用的账号在 SmartBI 侧有足够的权限。
- 只读 SQL 是受限能力，写入类操作不在已核实的能力列表里。
- 官方页面显示当前下载量 947、安装量 0，属于刚发布不久的技能，实际可用性需要在自己的环境里先验证一遍。
结尾¶
Smartbi CLI 套件的价值在于把 SmartBI 的操作面交给 Agent，而不是让使用者为每类操作维护脚本。它来自思迈特官方，版本 2.3.0，评分 100000。
官方地址：https://api.skillhub.cn/org-n6d0247v/smartbi-cli-suite
