> ## Documentation Index
> Fetch the complete documentation index at: https://agentbase.vn/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Trang trợ giúp

> Trang hỗ trợ kiểu ChatGPT cho agent của bạn — có đường dẫn riêng để chia sẻ ở mọi nơi, và đặt được ngay trên tên miền doanh nghiệp.

Trang trợ giúp là một trang web riêng dành cho agent của bạn, nơi khách vào đặt câu hỏi và nhận câu trả lời ngay trên đó. Giao diện là một trang trò chuyện đầy màn hình, quen thuộc với bất kỳ ai từng dùng ChatGPT.

Điểm khác biệt so với chat widget: trang trợ giúp có **đường dẫn riêng**. Widget phải chờ khách ghé website rồi tự phát hiện ra bong bóng chat ở góc màn hình. Trang trợ giúp thì bạn chủ động gửi cho khách — dán vào cuối email xác nhận đơn, tin nhắn tự động của Zalo OA, phần mô tả trên Facebook, hay mã QR in trên hộp hàng.

<Info>
  Trang trợ giúp **không giới hạn theo gói**. Mọi workspace đều bật được, kể cả
  gói Free. Chỉ có phần tin nhắn là tính credits như các kênh khác.
</Info>

## Trước khi bắt đầu

Bạn cần:

* Một agent đã được huấn luyện dữ liệu
* Agent đang ở trạng thái **Hoạt động** (trong **Cài đặt**)

<Warning>
  Trang trợ giúp có công tắc bật/tắt riêng, **độc lập** với trạng thái của
  agent. Cả hai đều phải bật thì đường dẫn mới hoạt động — nếu thiếu một trong
  hai, khách truy cập sẽ nhận trang 404.
</Warning>

## Bật trang trợ giúp

<Steps>
  <Step title="Mở trang trợ giúp">
    Vào agent → **Triển khai** → thẻ **Trang trợ giúp** → **Quản lý**.
  </Step>

  <Step title="Mở hộp thoại Deploy">
    Nhấn nút **Deploy** ở góc trên bên phải. Ngăn kéo triển khai mở ra từ
    bên phải màn hình.
  </Step>

  <Step title="Bật công tắc">
    Bật **"Bật trang trợ giúp"**. Thay đổi này lưu ngay, không cần nhấn lưu.
  </Step>

  <Step title="Sao chép đường dẫn">
    Ở mục **"Truy cập trang"**, nhấn nút sao chép để lấy đường dẫn, hoặc nút
    mở để xem thử trang.
  </Step>

  <Step title="Kiểm tra">
    Mở đường dẫn ở tab ẩn danh và hỏi thử một câu. Agent sẽ trả lời sau vài
    giây.
  </Step>
</Steps>

<Tip>
  Khi tắt công tắc, đường dẫn trả về 404 ngay lập tức — không có độ trễ cache.
  Đây là cách nhanh nhất để gỡ trang xuống nếu cần.
</Tip>

## Tùy chỉnh giao diện

Trang quản lý chia làm ba tab bên trái, kèm bản xem trước trực tiếp bên phải.

| Tab           | Nội dung                                                            |
| ------------- | ------------------------------------------------------------------- |
| **Tổng quan** | Mô hình AI, nguồn dữ liệu, hướng dẫn riêng cho kênh này             |
| **Giao diện** | Toàn bộ phần hiển thị của trang — xem bảng bên dưới                 |
| **Hành động** | Các AI Actions đang bật. Chỉ để xem, cấu hình ở trang **Hành động** |

Tab **Giao diện** gồm các nhóm:

| Nhóm           | Cấu hình được                                                                      |
| -------------- | ---------------------------------------------------------------------------------- |
| **Chung**      | Tiêu đề trang (hiện trên tab trình duyệt), favicon                                 |
| **Nội dung**   | Câu chào, gợi ý trong ô nhập, các câu hỏi gợi ý                                    |
| **Tài nguyên** | Logo và ảnh hero, riêng cho giao diện sáng và tối                                  |
| **Khả năng**   | Nhập bằng giọng nói, đính kèm tệp                                                  |
| **Giao diện**  | Cho phép khách đổi sáng/tối, giao diện mặc định, màu chủ đạo, hiệu ứng viền ô nhập |
| **Nút**        | Nút chính và nút phụ ở thanh bên, cùng các thẻ liên kết                            |

<Note>
  Tối đa **2 thẻ liên kết**. Chúng hiện dưới ô nhập ở màn hình chào, thường
  dùng để dẫn về trang sản phẩm hoặc chính sách đổi trả.
</Note>

### Chế độ chỉnh sửa

Bật **"Chế độ chỉnh sửa"** ở thanh dưới bản xem trước để sửa trực tiếp trên
trang thay vì tìm trong danh sách bên trái.

Khi bật, di chuột lên một thành phần sẽ hiện viền xanh quanh nó:

* **Chữ** — bấm vào để sửa tại chỗ
* **Ảnh** — bấm vào để mở hộp chọn tệp
* **Câu hỏi gợi ý, thẻ liên kết, nút** — bấm biểu tượng bánh răng để mở bảng cấu hình

Nút bên cạnh chuyển bản xem trước giữa **máy tính** và **điện thoại**. Ở chế độ
điện thoại thanh bên tự đóng lại, đúng như khách sẽ thấy.

<Warning>
  Chỉnh sửa trên bản xem trước **chưa được lưu** cho đến khi bạn nhấn **Lưu** ở
  thanh dưới cùng. Nhấn **Hủy** để bỏ mọi thay đổi chưa lưu.
</Warning>

## Đặt trên tên miền của bạn

Mặc định trang chạy trên đường dẫn AgentBase cấp sẵn. Bạn đưa được nó về tên
miền của chính doanh nghiệp, để khách thấy `tencuahang.vn/help` thay vì một tên
miền lạ.

Cách làm: thêm **ba quy tắc rewrite** vào dự án website của bạn. Ngăn kéo
**Deploy** tạo sẵn đoạn cấu hình cho **Next.js**, **Vercel**, **Netlify** và
**Node.js**, kèm nút sao chép — bạn chỉ việc dán vào đúng file.

<Info>
  Bước này cần người biết kỹ thuật, khoảng mười phút của một lập trình viên.
  Nếu chưa có ai làm được ngay, cứ dùng đường dẫn AgentBase trước — trang vẫn
  chạy đầy đủ và bạn đổi sang tên miền riêng lúc nào cũng được.
</Info>

Ba quy tắc đó làm ba việc:

| Quy tắc        | Phục vụ                                                |
| -------------- | ------------------------------------------------------ |
| `/help`        | Trang trợ giúp                                         |
| `/help/:path*` | Các đường dẫn con của trang                            |
| `/__ab/:path*` | Tài nguyên tĩnh của trang (JavaScript, CSS, phông chữ) |

<Warning>
  Đừng bỏ quy tắc `/__ab`. Thiếu nó trang vẫn tải nhưng **không có giao diện**
  — khách sẽ thấy một trang trắng.
</Warning>

Riêng phần trò chuyện gọi thẳng về máy chủ AgentBase, không đi qua proxy của
bạn, nên **không có quy tắc thứ tư** cho nó. Đây là chủ ý: giới hạn tần suất của
AgentBase cần thấy đúng địa chỉ IP của từng khách, mà qua proxy thì mọi khách
đều mang chung địa chỉ máy chủ của bạn.

## Cùng một agent, cùng dữ liệu

Trang trợ giúp không phải một agent riêng. Vẫn là agent bạn đã huấn luyện, vẫn
nguồn dữ liệu đó, vẫn những AI Actions đó — gồm thu thập thông tin khách và
chuyển tiếp cho nhân viên.

Cuộc trò chuyện từ trang trợ giúp hiện trong **Hoạt động → Chat logs** cùng chỗ
với widget, Zalo OA và Messenger, với nhãn kênh riêng để lọc. Nhân viên trả lời
trực tiếp từ đó và agent sẽ tự động ngừng trả lời cuộc đó.

## Xử lý sự cố

| Hiện tượng                           | Nguyên nhân thường gặp                                                         |
| ------------------------------------ | ------------------------------------------------------------------------------ |
| Đường dẫn trả về **404**             | Công tắc trang trợ giúp đang tắt, hoặc agent đang ở trạng thái không hoạt động |
| Trang trắng khi dùng tên miền riêng  | Thiếu quy tắc rewrite `/__ab/:path*`                                           |
| Sửa xong nhưng khách vẫn thấy bản cũ | Thay đổi chưa được lưu — kiểm tra thanh **Lưu** ở dưới cùng                    |
| Nút micro không hiện                 | Tắt **"Nhập bằng giọng nói"** trong **Giao diện → Khả năng**                   |
| Ảnh logo không đổi                   | Logo có bản riêng cho sáng và tối — kiểm tra đúng bản đang xem                 |

<Note>
  **Đính kèm tệp** đang phát triển. Công tắc có sẵn trong **Khả năng** nhưng
  chưa bật được: agent chưa xử lý được tệp khách gửi lên.
</Note>

## Tiếp theo

<CardGroup cols={2}>
  <Card title="Chat widget" icon="message-square" href="/docs/user-guides/agent/deploy">
    Nhúng bong bóng chat vào website, chạy song song với trang trợ giúp.
  </Card>

  <Card title="Hành động" icon="zap" href="/docs/user-guides/agent/actions/overview">
    Thu thập thông tin khách và chuyển tiếp cho nhân viên ngay trong trang.
  </Card>
</CardGroup>