页面感知

页面感知让您的 AI 智能体知道访客当前所在的页面。这能带来更相关、更贴合上下文的答案，并在升级给人工客服时提供更丰富的上下文。

页面感知仅适用于 网页挂件。Telegram 及其他即时消息渠道没有「当前页面」的概念。

概览#

启用后，挂件会自动收集访客当前页面的 URL、标题和描述。这些上下文会注入到 AI 的系统提示中，使其能够根据用户正在浏览的位置来定制答案。

页面上下文

agent 可看到当前页面的 URL、标题和 meta 描述

升级上下文

人工客服在升级时会收到访客当前页面的信息

工作原理#

挂件会自动捕获页面上下文——无需在您的站点上改动任何代码。以下是每条消息随附收集的内容：

数据	来源	示例
页面 URL	window.location.href	https://example.com/pricing
页面标题	document.title	Pricing — Acme Corp
路径	window.location.pathname	/pricing
描述	meta[name=description]	对比我们的套餐
来源页（Referrer）	document.referrer	https://google.com

示例：agent 看到的内容#

当处于 /pricing 页面的访客询问 "How much does it cost?"（要多少钱？）时，agent 的系统提示会包含：

注入到系统提示中text

PAGE CONTEXT (where the user is right now):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Compare our plans and pricing

Use this page context to provide more relevant, page-specific answers.

设置#

页面感知是一项需手动开启的功能。要启用它：

前往 Channels 并选择您的 Widget 渠道
在该渠道的设置/外观面板上，打开 Page awareness（「挂件会告诉 agent 访客当前所在的页面」）
保存您的更改

无需改动您的挂件嵌入代码。一旦该功能在 agent 上启用，挂件便会自动发送页面上下文。

升级上下文#

当对话升级给人工客服时，升级通知邮件会自动包含访客当前的页面上下文。人工客服无需询问即可清楚知道访客当时正在浏览哪里。

升级邮件包含：

升级邮件

主题： [YourBrand] Conversation Escalated

标题： "Case #123 needs a human"（没有 case 编号时则为 "A customer needs a human"）

正文： "A customer has been transferred to a human agent. Please review and respond." —— 后面是引用块，包含客户的最后一条消息和姓名

事实表格： Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

Open conversation —— 直接跳转到仪表盘中该对话的按钮

只要页面感知已启用，升级时就会自动包含页面上下文——不存在单独的开关。

故障排查#

如果页面感知似乎不起作用，请检查以下几点：

agent 给出笼统答案，忽略了当前页面

确认您 Widget 渠道上的 Page awareness 已打开（Channels → Widget → 设置/外观面板），并且更改已保存。该功能默认为关闭。

升级邮件中没有页面上下文部分

确认您 Widget 渠道上的 Page awareness 已启用并保存。同时确认 agent 设置中的 Escalation alerts 开关已启用（它默认为关闭）。提醒邮件会根据每位团队成员的通知偏好，发送给您工作区的团队成员——被分配的成员或分配的团队；不存在需要单独配置的升级邮件地址。

页面标题显示了错误的值

挂件会在用户发送消息的那一刻读取 document.title。如果您的站点在初始渲染之后才更新标题（例如异步更新），挂件捕获的将是发送时所设置的值。