前言¶
把 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
