AI 洞察助手

数字来自对你项目数据执行的分析查询，不检索知识库，也不做向量检索。助手不创建监控、不发通知；第三个页签是只读的 MCP 接入，见 MCP 与 Agent 接入。

控制台全端分析智能运营AI 助手

页签是「问数」「变化归因」「MCP 接入」。未配置模型时，右上角显示「仅规则解析」。

指标与口径

问数把一句话变成可复现的分析：指标、时间、对比、分组和筛选。问题先用规则解析。把握足够且不是追问时，直接执行，不调用模型。把握不足、解析不出查询，或对话里已有上文时，才把问题交给模型，译成同一份查询再执行。结论默认由规则根据结果写成；模型开启且未超出当日上限时，只润色这段规则稿，不能编造结果里没有的数字。模型不可用或超出当日上限时，退回规则结果。

变化归因解释一个指标相对上一周期或去年同期，各维度取值贡献了多少。可选渠道、来源域名、国家、设备、入口页、平台等维度，拆一层或两层。贡献度是该取值的变化量除以总变化量。

如何使用

输入「近 7 天访客趋势，对比上一周期」，回车发送。回答附带查询条件。「在分析器中打开」和「保存为分析」需要你自己点，助手不会自动做。点「为什么变了？」会带着当前指标切到变化归因。

权限与限制

问数使用当前项目的数据。模型调用有站点级的每日上限，页顶会显示今日已用次数；上限为 0 表示不封顶。未配置模型时全程只走规则。

常见问题

答非所问怎么办？ 写清指标、时间和分组，或点建议问法。

追问是怎么处理的？ 「再按国家」「只看移动端」这类追问会带上最近几轮查询，由模型在上一份查询上修改。

MCP 与 Agent 接入

协议是 Streamable HTTP，响应是 JSON，没有服务端推流。服务端只有查询工具，没有资源和提示词模板；问数的行为与 AI 洞察助手 相同。

如何配置

在 控制台全端分析智能运营AI 助手 的「MCP 接入」页签复制端点、配置和命令行示例。端点是 /api/v1/mcp。密钥在 控制台配置设置API 密钥 创建，权限范围选「读取报表」（stats:read），只显示 wck_ 前缀。已登录的控制台会话也可以调用。

方法与工具

POST 发送 JSON-RPC。GET 返回服务信息与工具名。DELETE 表示结束，无状态实现直接成功。除 list_sites 外，工具都要 site_id。

工具	作用	还要提供
list_sites	该凭证能访问的项目	无
site_overview	会话、用户、浏览量等及环比	时间，可选口径
list_metrics	内置指标、已保存指标、近 30 天事件名、可用维度	项目
list_events	近 30 天事件名，按次数	项目
run_insight	用分析查询跑趋势、表格、漏斗等	项目与查询
list_saved_insights	已保存分析	项目，可按名称搜
run_saved_insight	跑一条已保存分析	项目与分析编号，可改时间
ask	自然语言问数	项目与问题
attribute_change	指标变化的维度贡献	项目与指标
dashboard_summary	看板各卡片的摘要	项目；不传看板则用默认看板

默认与限制

握手支持的协议版本以服务端返回为准，当前包含 2025-06-18。run_insight 默认返回压缩结果。时间可用预设或 from / to（站点时区的日期）。每次 tools/call 按 site_id 检查访问权，并计入开放 API 用量与限流。

示例

页上的命令行示例是：POST 该端点，头里 Authorization: Bearer 加你的密钥，方法 tools/call，工具名 ask，参数里带 site_id 和问题。把示例里的 wck_ 占位换成你的密钥。

响应与副作用

成功时结果在 content 的文本里，多为 JSON。工具只读：不写事件、不改定义、不创建监控。ask 看不懂时返回澄清，不执行查询。没有默认看板时，dashboard_summary 说明该项目没有看板。

错误与兼容性

未知工具、缺少 site_id、密钥没有「读取报表」都会失败。通知类方法返回空体。资源列表和提示词列表都是空的，不要假设还有别的工具。