用途:该技能用于分析 PostHog MCP 中智能体工具调用的意图。它把调用附带的自由文本 $mcp_intent 做嵌入并按语义相似度聚类,归因按单次调用计算(无意图的调用继承同一会话中最近一次意图),从而回答“用户想做什么、是否成功”,而非“调用了哪个工具”。
主要能力:提供两个工具。posthog:mcp-analytics-intent-clusters-retrieve 获取项目最新聚类快照;posthog:mcp-analytics-intent-clusters-recompute 触发异步重算。快照含 status、last_computed_at、computed_with、clusters、tools(工具透视)与 tool_overlaps。每个聚类含 label、intent_count、call_count、error_count、error_rate_pct、routing_entropy、tool_distribution、sample_intents,以及 switches 和 self_retries。工具透视含 clusters(capture_pct、rank、top_competitor、description_fit)、n_clusters_served、discovery_rate_pct、contested_score。
使用方式:调用 retrieve 读取当前聚类,按 call_count 看主要行为,按 error_rate_pct 看失败目标;routing_entropy 低表示一个目标稳定映射到一个工具,高表示智能体在寻找合适工具。工具透视可判断可发现性:description_fit 高而 capture_pct 低是可发现性失败,反之则描述低估了工具能力。空快照(status: idle)需先触发重算,重算返回 202 并在后台运行,轮询 retrieve 直到 idle 或 error,不要阻塞等待。UI 链接为 https://app.posthog.com/project/<project_id>/mcp-analytics/intent-clustering。
适用场景:分析 MCP 工具被用于哪些目标、哪些目标失败率高、工具之间是否混淆或竞争。
限制:聚类依赖嵌入,无法用 SQL 表达,基于存储快照。需先看 computed_with 中的采样覆盖率再引用数字;仅带工具目录的会话进入发现率分母,exec-wrapper 模式会话只广告包装器。顶层工具与重叠对的上限会报告 dropped_tools 和 dropped_overlap_pairs,但每聚类列表静默截断,显示 10 个 switches 应理解为“至少 10 个”。聚类只读事件,不含按需会话摘要(MCPSession.intent),需查 intent_coverage_pct。重算每项目同时只允许一个。相关技能:exploring-mcp-tool-quality、exploring-mcp-sessions。