Tài liệu

Nhận biết trang

Nhận biết trang cho phép AI agent của bạn biết khách truy cập đang ở trang nào. Điều này giúp có câu trả lời phù hợp hơn, nhận thức được bối cảnh và cung cấp bối cảnh phong phú hơn khi chuyển cấp cho nhân viên con người.

Nhận biết trang chỉ hoạt động với widget web. Telegram và các kênh nhắn tin khác không có khái niệm "trang hiện tại".

Tổng quan#

Khi được bật, widget tự động thu thập URL, tiêu đề và mô tả của trang hiện tại của khách truy cập. Bối cảnh này được đưa vào system prompt của AI, cho phép nó điều chỉnh câu trả lời dựa trên nơi người dùng đang duyệt.

Bối cảnh trang

Agent thấy URL, tiêu đề và mô tả meta của trang hiện tại

Bối cảnh chuyển cấp

Nhân viên con người nhận được thông tin trang hiện tại của khách truy cập khi chuyển tiếp

Cách hoạt động#

Widget tự động thu thập bối cảnh trang — không cần thay đổi mã trên trang của bạn. Dưới đây là những gì được thu thập với mỗi tin nhắn:

Dữ liệuNguồnVí dụ
URL trangwindow.location.hrefhttps://example.com/pricing
Tiêu đề trangdocument.titlePricing — Acme Corp
Đường dẫnwindow.location.pathname/pricing
Mô tảmeta[name=description]Compare our plans
Nguồn giới thiệudocument.referrerhttps://google.com

Ví dụ: Những gì agent thấy#

Khi một khách truy cập ở /pricing hỏi "Giá bao nhiêu?", system prompt của agent bao gồm:

Đưa vào system prompttext
PAGE CONTEXT (nơi người dùng đang ở ngay bây giờ):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Compare our plans and pricing

Dùng bối cảnh trang này để đưa ra câu trả lời phù hợp hơn, cụ thể theo trang.

Thiết lập#

Nhận biết trang là tính năng tùy chọn bật. Để bật nó:

  1. Vào Kênh và chọn kênh Widget của bạn
  2. Trên bảng cài đặt/giao diện của kênh, gạt công tắc Nhận biết trang ("Widget cho agent biết khách truy cập đang ở trang nào")
  3. Lưu thay đổi của bạn
Không cần thay đổi mã nhúng widget. Widget tự động gửi bối cảnh trang ngay khi tính năng được bật trên agent.

Bối cảnh chuyển cấp#

Khi một hội thoại được chuyển cấp cho nhân viên con người, email thông báo chuyển cấp tự động bao gồm bối cảnh trang hiện tại của khách truy cập. Nhân viên con người thấy chính xác nơi khách truy cập đang duyệt mà không phải hỏi.

Email chuyển cấp bao gồm:

Email chuyển cấp

Tiêu đề: [YourBrand] Conversation Escalated

Đề mục: "Case #123 needs a human" (hoặc "A customer needs a human" khi không có số case)

Nội dung: "A customer has been transferred to a human agent. Please review and respond." — theo sau là một khối trích dẫn với tin nhắn cuối cùng và tên của khách hàng

Bảng thông tin: Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

Open conversation — một nút liên kết thẳng đến cuộc hội thoại trong bảng điều khiển

Bối cảnh trang trong chuyển cấp được bao gồm tự động khi Nhận biết trang được bật — không có công tắc riêng.

Khắc phục sự cố#

Nếu Nhận biết trang có vẻ không hoạt động, hãy kiểm tra những điều sau:

Agent đưa ra câu trả lời chung chung, bỏ qua trang hiện tại

Hãy chắc chắn rằng Nhận biết trang đã được bật cho kênh Widget của bạn (Kênh → Widget → bảng cài đặt/giao diện) và các thay đổi đã được lưu. Tính năng này bị tắt theo mặc định.

Email chuyển cấp không có phần bối cảnh trang

Hãy chắc chắn rằng Nhận biết trang được bật trên kênh Widget của bạn và đã lưu. Đồng thời xác nhận công tắc Cảnh báo chuyển cấp được bật trong cài đặt agent (mặc định là tắt). Email cảnh báo được gửi đến các thành viên trong không gian làm việc của bạn — thành viên được phân công hoặc đội được phân công — dựa trên tùy chọn thông báo của từng thành viên; không có địa chỉ email chuyển cấp riêng để cấu hình.

Tiêu đề trang hiển thị giá trị sai

Widget đọc document.title tại thời điểm người dùng gửi tin nhắn. Nếu trang của bạn cập nhật tiêu đề sau lần render ban đầu (ví dụ bất đồng bộ), widget ghi lại bất cứ giá trị nào được đặt tại thời điểm gửi.