GuanCLI 与 GuanMCP 对比
核心区别
GuanCLI 和 GuanMCP 都能让 AI 使用观远 BI 能力，但它们面向的接入方式不同。
- GuanCLI 是命令行工具。它适合运行在本地开发环境、交付环境或受控命令执行环境中，由 AI Agent 或技术人员通过命令完成查询、排查、资源配置和部分资源生成。
- GuanMCP 是面向 AI 平台的能力网关。它把观远 BI 的搜索、元信息读取、指标查询、数据查询和 ChatBI 能力封装为标准 MCP 工具，让企业已有 AI 助手可以在原入口中调用 BI 能力。
简单判断：
- 客户想让已有 AI 助手问到 BI 数据，优先选择 GuanMCP。
- 客户想让 AI 主动分析、排查，或生成和修改 BI 资产，优先选择 GuanCLI。
- 两者可以同时使用：GuanMCP 服务业务问数入口，GuanCLI 服务分析、交付和运维自动化。
适用场景对比
| 判断项 | GuanCLI | GuanMCP |
|---|---|---|
| 主要定位 | 给 AI Agent 或技术团队使用的 BI 工具箱 | 接入企业 AI 助手的 BI 能力网关 |
| 使用入口 | 终端、脚本、本地 Agent、交付环境 | 飞书 Aily、Decidex、企业自研 AI 助手等平台 |
| 典型用户 | AI 工程师、实施、运维、解决方案团队 | 一线业务人员、企业 AI 平台用户 |
| 接入方式 | 执行本地命令 | 通过 MCP Tool 或 HTTP 调用 |
| 参数表达 | 命令参数、脚本参数、Agent 自行组织 | Schema 化参数，由平台校验和编排 |
| 常见任务 | 查资源、查数据、排查问题、操作表单、生成看板、修改 ETL | 搜索资产、读取元信息、查询指标、ChatBI 问数、发起洞察 |
| 是否适合资源写入 | 适合部分资源创建、修改和发布 | 不作为资源创建、修改、保存和发布入口 |
| 部署依赖 | 需要可执行 CLI 的本地或服务端环境 | 需要 MCP Server 或 HTTP 服务接入 AI 平台 |
能力边界
GuanCLI 更适合做什么
GuanCLI 适合需要“动手处理 BI 资产”的场景：
- 查询 BI 资源、数据集、页面、卡片和任务状态
- 预览数据、排查数据链路和定位异常
- 配合 Skill 让 Agent 调用 BI API
- 操作表单填报数据
- 调用 ChatBI 问数
- 配合 GuanVis 生成仪表板
- 修改或调试 ETL、页面等资源
当任务需要在交付、实施或运维环境中自动化执行，GuanCLI 通常更直接。
GuanMCP 更适合做什么
GuanMCP 适合把 BI 能力注册到企业 AI 平台：
- 让业务人员在已有 AI 助手中查询 BI 数据
- 搜索卡片、仪表板、数据集和 ETL 资产
- 读取数据集字段、卡片来源和仪表板结构
- 查询指标口径、指标数据和指标树归因结果
- 调用 ChatBI 同步问数和异步洞察
- 按当前用户权限返回 BI 结果
GuanMCP 当前聚焦只读查询和分析能力。它不创建、编辑、保存或发布 BI 资源，也不绕过 GuanBI 权限。
怎么选
| 客户需求 | 推荐方案 | 原因 |
|---|---|---|
| 在飞书 Aily 或企业 AI 助手里直接问经营数据 | GuanMCP | AI 助手可通过标准工具调用 BI 能力，用户不需要换入口 |
| 让 AI 帮实施人员排查数据集、页面、ETL 或任务问题 | GuanCLI | 本地命令和 Skill 更适合受控排查流程 |
| 让 AI 自动生成看板初稿 | GuanCLI + GuanVis | 需要读取数据集结构并发布页面，属于资源生成场景 |
| 企业已有统一 AI 平台，希望把 BI 作为一个工具接入 | GuanMCP | MCP 提供 Schema 化工具，便于平台编排 |
| 客户没有 AI 助手，只想先让 AI 工具访问 BI | GuanCLI | CLI 更容易从本地环境开始验证 |
| 客户已有 BI 资产，也已有 AI 助手，希望业务人员低成本问数 | GuanMCP | 复用已有 BI 数据、指标、页面和权限 |
| 需要批量管理、迁移或修改 BI 资产 | GuanCLI 或 BI 产品界面 | GuanMCP 不作为资源管理入口 |
推荐组合
在成熟环境中，GuanCLI 和 GuanMCP 可以共同使用。
GuanMCP 面向业务侧，把观远 BI 的可信数据和分析能力接入已有 AI 助手。业务人员继续在原工作入口提问，答案来自 BI，权限仍按 BI 原规则生效。
GuanCLI 面向建设侧，帮助实施、运维和技术团队完成分析、排查、生成和配置工作。它适合在测试环境、交付环境和受控自动化流程中使用。