智能体 · 智析

签发 Agent 密钥
前往巨人肩膀工作空间设置，在 Agent API Key 中点击「签发密钥」，复制明文密钥（仅显示一次）。智析 MCP 仅依赖该密钥完成鉴权，无需再配后端地址。
密钥格式一般为 bigapp_...，请妥善保存明文密钥。
配置 MCP
将 BIGAPP_API_KEY 换成你的密钥后写入 MCP 配置；推荐用 npx 拉取 zhixi-mcp，无需本地构建。后端地址由包内构建默认值决定，一般不必填 BIGAPP_API_BASE。需 Node.js 18+。
已有 MCP 选，首次用，后粘贴到 .cursor/mcp.json 或 Cursor Settings → MCP。
```
{
  "mcpServers": {
    "zhixi": {
      "command": "npx",
      "args": [
        "-y",
        "zhixi-mcp"
      ],
      "env": {
        "BIGAPP_API_KEY": "粘贴你在工作空间签发的密钥"
      }
    }
  }
}
```

验证并开始使用

重载 MCP 后，可先用连通性提示词确认可用，再走通建看板或分析链路。

连通性测试

请调用智析 MCP 工具 whoami，测试智析是否已连通。

【必须执行】
1. 使用 MCP 工具 whoami（不要猜测或模拟返回）
2. 调用成功后告诉我：workspaceId、workspaceName（若有 apiKeyId / localUserId 也可一并列出）
3. 可选再调用 list_datasources 或 list_dashboards，确认资源列表可读
4. 若失败，把报错信息原样贴出

端到端建看板

请使用智析 MCP 完成一次端到端验证：
1. 用 create_datasource 接入一个可访问的 MySQL 或 PostgreSQL 数据源，并用 test_connection 确认连通；
2. 用 get_tables / get_fields 探查元数据；
3. 用 create_dashboard 创建看板，再用 create_chart 至少添加 KPI 与折线图，必要时 update_layout；
4. 用 publish_dashboard 发布，再用 generate_share_link 生成分享链接并返回给我。

不要只在聊天里描述，必须真正调用工具；完成后告诉我：数据源 id、看板 id、看板名称与分享链接。

分析洞察

请使用智析 MCP 完成一次指标分析验证：
1. 若尚无数据源，先 create_datasource 并 test_connection；否则用 get_tables / get_fields 确认可用表；
2. 调用 analyze_metric，针对一个具体业务问题（例如「为什么近期销售额下降？」）给出结构化结论；
3. 若已有看板，用 create_insight_charts 把关键结论回写为解释图表；否则可先 create_dashboard 再建图；
4. 用 get_insight 或 list_insights 核对 Insight 已落库。

完成后告诉我：insightId、主要结论摘要，以及是否已生成解释图表。

创建成功后，可在看板列表中查看与管理；分析结论经 MCP 落库，Web 无独立分析记录页。

工具能力

推荐顺序：whoami → list_datasources（或 create_datasource）→ test_connection → get_tables / get_fields → create_dashboard → create_chart →（可选 update_layout）→ publish_dashboard → generate_share_link。分析链：analyze_metric → create_insight_charts（可选 get_insight / list_insights）。

whoami返回 Agent 身份与工作空间摘要（连通性验证）
list_datasources分页列出数据源摘要
get_datasource获取数据源详情（不含密码）
create_datasource创建数据源（MySQL / PostgreSQL / Excel）
test_connection测试连接（datasourceId 或 type+config）
get_tables获取表 / 工作表列表
get_fields获取表字段列表
list_dashboards分页列出看板摘要
list_dashboard_tree获取看板树（父子层级）
move_dashboard_tree_node移动看板（改父级与同级排序）
create_dashboard创建看板（可选挂到父看板）
update_dashboard更新看板基础信息
delete_dashboard删除看板（有子看板时不可删）
get_dashboard获取看板详情（含图表）
update_layout更新看板布局（items 须带 chartId）
create_chart创建图表（kpi/line/bar/pie/table/rank 等 10 种）
update_chart更新图表
delete_chart删除图表
execute_query执行查询
get_metric_data获取指标数据
publish_dashboard发布看板
generate_share_link生成分享链接
analyze_metric分析指标变化并生成 Insight
explain_change解释指标变化原因
create_insight_charts将分析结论回写为解释图表
get_insight查询单条 Insight
list_insights列出 Insight 记录

签发 Agent 密钥

配置 MCP

验证并开始使用

工具能力