Microsoft Clarity 是一个行为分析工具。它为团队提供会话录制、热力图和洞察,展示人们实际上如何在页面中移动: 他们点击哪里,滚动到哪里,卡在什么地方。对于理解网站上的人类体验,很少有比直接观看它发生更直观的方式。
如今,网站承载的不只是使用鼠标的人。AI agent 会抓取页面并为真实客户完成任务。人们会在 AI 助手陪伴下浏览。一些流量根本无法解释。团队希望知道这三类流量各自有多少到达了自己这里,以及应用应该对此做什么。这个工作属于 AgentCredia 的 actor intelligence 产品 Proof of Actor。
本页会公平地比较两者。下面有关 Clarity 的事实,来自 Microsoft 自己的文档和官方 Clarity 博客,截至 2026年11月。
简短结论
| Microsoft Clarity | Proof of Actor | |
|---|---|---|
| 核心问题 | 人们如何与我的页面交互? | 这次交互由谁或什么在执行,以及证据是什么? |
| 主要数据采集 | 页面 head 中的一段 JavaScript 跟踪代码 | 服务端中间件、edge、HTTP API、MCP servers,以及经批准的浏览器采集器 |
| bot 会话 | 默认检测并排除;该设置可关闭 | 进行分类并保留,因此你可以看到并路由它们 |
| AI crawler 活动 | 来自 CDN 和服务端日志集成的 Bot Activity 报告 | 每次交互的 Agent 结果,带有 verified、declared 或 inferred 依据 |
| 使用 AI 的人 | 不作为单独类别描述 | 一等公民结果: Human + AI |
| 不明确的流量 | 除非被检测为 bot,否则按会话计入 | 报告为 Unknown,并使用你选择的回退 |
| 是否对流量采取动作 | 不,它只报告和记录 | 在观察之后,依据你自己的代码和策略按 route 处理 |
本页其余部分会逐项解释。
录制和热力图本来是为了展示什么
Clarity 的设计目标是展示页面上的体验。一次会话录制会重放一次访问: 光标轨迹、滚动、犹豫,以及那些没有任何结果的点击。热力图会汇总多次访问中的点击和滚动深度,让你看出页面哪些部分最受关注。Insights 使用机器学习来浮现最重要的会话和模式。这些视图都在回答一个设计问题,而且都默认另一端是带浏览器的人。
对于录制工具来说,这个假设是合理的。只有存在可观看的体验时,录制才有价值,而一个只是抓取 HTML、却不运行页面脚本的 agent 不会留下可回放的内容。这也意味着,把人类、使用 AI 的人和浏览器自动化混在一起的热力图,可能会把设计团队带向错误的问题。
Proof of Actor 回答的是录制之前的那个问题: 这次交互背后是谁或什么。它在信号指向一个人时返回 Human,在一个人借助 AI 并通过受支持的集成被声明或观察到时返回 Human + AI,在自动化或 agent 来源的交互时返回 Agent,在证据不足以可靠判断时返回 Unknown。每个结果都带有一个 evidence basis,即 verified、declared、inferred 或 unknown,因此你知道录制上的一个标签能承受多大的分量。
各自运行在哪里
根据 Microsoft 的 Clarity setup documentation,你可以通过将其跟踪代码添加到网站的 <head> 中、通过受支持的第三方平台,或通过 NPM package 来安装 Clarity。数据从浏览器发送到 Clarity 的收集 endpoint。Microsoft 还指出,Clarity 无法捕获 Canvas 或第三方 iframe 元素内部的内容。
浏览器脚本只能看到浏览器。许多 agent 会在不运行 JavaScript 的情况下抓取 HTML,直接调用你的 API,或连接到 MCP server,而这些路径都不会加载页面脚本。
Proof of Actor 运行在你的应用逻辑所在的位置: Node.js 中间件、Next.js、你控制的 edge 层、通用 HTTP API 和 MCP servers,以及一个可选的、你批准的页面浏览器采集器。参见 integrations 页面。它可以分类交互,而不管页面是否真的被渲染。
Clarity 如何处理 bot 和 AI agent
Clarity 很重视 bot,而且体现在两个不同层面。
会话数据中的 bot 检测。 Microsoft 的设置文档说明,默认情况下,Clarity 会检测 bot 流量,并将其从总会话数和分析中排除,而且你可以在仪表板顶部查看被排除的 bot 会话数量。Bot Detection 设置可以关闭或重新开启。当它关闭时,Clarity 不会检测 bot 流量,也不会将其从会话数中排除。
Bot Activity 报告。 在 AI Visibility 下,Clarity 提供一个 Bot Activity 视图。根据官方 Clarity 博客,该视图由通过 CDN 集成收集的服务端日志提供支持,文中提到的受支持提供商包括 Fastly、Amazon CloudFront 和 Cloudflare,而不是页面脚本。该博客将其描述为展示来自 AI bots 的请求占比、按用途分组的 bot 活动、按 operator 分类的 crawler 请求,以及自动化系统最常请求的路径。
这两者对于保持会话分析整洁,以及在站点层面理解抓取行为,都很有用。它们都没有被描述为应用在请求时收到的逐次交互答案,而 Microsoft 的文档也没有描述一个专门用于使用 AI 辅助的人的类别。
Bot Activity 与逐次请求的 actor 类别
Clarity 的 Bot Activity 视图和 Proof of Actor 的结果看起来有关联,但它们在不同层级回答的是不同问题。
| Clarity Bot Activity | Proof of Actor result | |
|---|---|---|
| 来源 | 根据官方 Clarity 博客,来自 CDN 集成的服务端日志 | 你请求路径中的信号: server、edge、HTTP API、MCP server、经批准的浏览器页面 |
| 单位 | 按 operator、用途和路径分组的 crawler 请求 | 一次交互,带有类别和依据 |
| 读取者 | 查看站点级仪表板的人 | 你的应用代码在请求时读取,及你的团队在 actor analytics 中查看 |
| 使用 AI 的人 | 不在范围内;它报告抓取 | 一等公民结果: Human + AI |
| 能否改变响应 | 不能 | 可以,通过你在代码中编写的策略 |
实际差异正是由这张表推导出来的。
在请求仍打开时得到答案。 Bot Activity 是事后汇总抓取情况。Proof of Actor 会在交互期间把结果返回给你的应用,因此你之后分析的同一分类现在就能影响响应。
证据,而不是 operator 名称。 一个 verified 的 Agent 结果意味着请求签名已与已发布密钥进行核对,例如使用 HTTP Message Signatures,其定义见 RFC 9421。declared 和 inferred 结果会按此标注。单独的 crawler 名称只依赖 user agent string,而这可以被伪造,正如 user agent spoofing 条目所解释的那样。
让 agent 保持可见,而不只是被排除。 Clarity 的 Bot Detection 会把 bot 会话排除在人类分析之外,这对录制和热力图是合适的。Proof of Actor 会把这些访问者报告为 Agent 结果,因此你可以看到它们使用了哪些 route,并为它们提供合适的服务。关于 为 AI agent 提供结构化内容 的指南对此有说明。
让 Unknown 变得可见。 既没有被检测为 bot、也没有明确是人的流量,在录制工具中通常只是普通会话。Proof of Actor 会返回 Unknown 并按 route 跟踪其比例;关于 处理 Unknown 流量 的指南说明了如何设置回退。
由你控制的策略。 策略按 route、actor 类别和依据编写: allow、adapt、challenge、send to review 或 rate-limit。Proof of Actor 从 observation mode 开始,因此在你选择 enforce 之前,安装不会改变任何内容。
按 actor 类别过滤录制和热力图
将两者结合最直接的方法,是把 actor 类别带入 Clarity 本身:
- 在 server、edge、API 或 MCP 层对每次交互进行分类,并附带其依据,使用 Proof of Actor 完成。
- 为 Clarity 会话打标签。 在运行 Clarity 的页面上,通过其 client API 将 actor 类别作为自定义标签传给 Clarity。
- 按类别过滤录制。 将 Human + AI 会话与未辅助的 Human 会话并排查看,以了解使用 AI 的人在哪些地方移动得更快或被卡住,并审查 Unknown 会话,看不明流量在页面上究竟做了什么。
- 按类别拆分热力图。 仅保留 Human 会话的热力图能显示你的用户真实面临的设计问题,而不会被自动化点击所扭曲。
- 为保持干净的人类分析,请保留 Bot Detection 开启,并将 Proof of Actor 的 actor analytics 用于 Clarity 要么会排除、要么根本看不到的 agent 流量,例如 API 和 MCP 调用。
- 在最重要的地方采取行动。 当情况足够清晰时,为那些 actor 类别应改变体验的 route 编写策略。关于 安全上线 actor-aware 策略 的指南涵盖了这些步骤,而 websites use case 展示了生产站点上的完整流程。
何时选择哪个
当你的问题是关于体验时,选择 Microsoft Clarity: 人们如何使用页面,他们在哪里犹豫,忽略了什么,以及设计在哪里阻碍了他们。它的 Bot Activity 视图是 AI 抓取的一个有用的站点级图景。
当你需要知道每次录制或请求背后是谁,并且需要明确的证据时,当使用 AI 的人应该作为独立群体可见时,当 agent 通过页面脚本看不到的 API 和 MCP servers 到达你这里时,或者当你的应用应按 actor 以不同方式响应时,添加 Proof of Actor。Clarity 让你看到体验。Proof of Actor 告诉你是谁在经历它,并给你的代码一种响应方式。
开始使用
Proof of Actor 目前处于私有 beta。通过 founding developer program,入选团队可在约定使用范围内获得最长 12 个月的免费访问,且不会自动计费。申请早期访问,并告诉我们你的站点以及你希望理解的流量类型。
Microsoft Clarity 是 Microsoft Corporation 的商标。