Tài liệu

Tài liệu

Page Assist

Page Assist được xây dựng cho Ollama chạy cục bộ, nhưng cùng màn hình đó cũng hỗ trợ endpoint lưu trữ: Settings → OpenAI Compatible API → Add Provider → Custom, với ba trường; sau đó thanh bên sẽ tóm tắt tab bạn đang mở bằng Claude hoặc GPT thay vì bằng model nào vừa với RAM máy tính xách tay của bạn.

Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, Base URL giữ /v1 và key — sau đó chọn các model id từ danh sách Page Assist tự tải.

Cài đặt → API tương thích OpenAI → Thêm nhà cung cấp → Tùy chỉnh
Provider Name   Kunavo
Base URL        https://api.kunavo.com/v1
API Key         sk-kn-...
                [ Save ]

Model List      (appears after Save — fetched from GET /v1/models)
  [x] claude-haiku-4-5
  [x] claude-sonnet-5
  [x] gpt-5-6-terra
Base URL giữ hậu tố /v1. Trang OpenAI Compatible API không nói rõ điều đó — chính trường này mới cho biết. Phần trợ giúp ghi “Base URL của nhà cung cấp OpenAI API. ví dụ (http://localhost:1234/v1)”, và hai trang nhà cung cấp liên quan có nêu URL cụ thể cho cùng trường này cũng xác nhận: LM Studio ghi “theo mặc định là http://localhost:1234/v1”, còn LLaMA.cpp là http://localhost:8080/v1. Page Assist chỉ nối thêm route, vì vậy origin trần sẽ khiến bạn nhận 404 thay vì 401 — ngược với các client kiểu Anthropic, vốn chỉ cần origin.
Thông thường, Model List được tải về chứ không phải nhập thủ công. Sau khi Save, Page Assist mở Model List với nội dung “Please select the chat models you want to use with this provider”, danh sách được lấy từ endpoint. Kunavo phản hồi GET /v1/models, nên danh sách tự động hiển thị. Nếu danh sách trống, tiện ích mở rộng sẽ báo “Không tìm thấy model. Hãy đảm bảo bạn đã thêm đúng nhà cung cấp với base URL và khóa API”; thông báo này chính xác: danh sách trống thường là vấn đề về Base URL hoặc khóa hơn là về danh mục. Hãy kiểm tra bằng curl bên dưới trước khi thay đổi tiện ích mở rộng. Bạn cũng có thể thêm id thủ công qua Add Custom Model, trong đó trường Model ID nhận nguyên văn slug từ bảng trên trang này.
Chọn Chat Model, không chọn tùy chọn radio còn lại. Biểu mẫu Add Custom Model có lựa chọn Model Type, còn Kunavo không cung cấp model embedding — không có model nào trong danh mục phản hồi endpoint đó, nên tùy chọn thứ hai không có gì để trỏ đến trong trường hợp này. Tính năng Knowledge Base phụ thuộc vào lựa chọn đó: trang riêng của nhà cung cấp cho biết bạn phải thiết lập một model trong RAG Settings và đề xuất nomic-embed-text. Hãy giữ cấu hình Ollama cục bộ bên cạnh nhà cung cấp này để đảm nhiệm việc đó — Page Assist cho phép dùng nhiều nhà cung cấp cùng lúc và hai vai trò không nhất thiết phải đến từ cùng một nơi.
Cài đặt âm thanh cần một lựa chọn dịch vụ riêng. Phần Text-to-Speech của Page Assist có nhà cung cấp OpenAI TTS với các trường API Key, Base URL và TTS Model riêng, còn Kunavo không cung cấp model chuyển văn bản thành giọng nói. Điều tương tự cũng đúng theo chiều ngược lại: Kunavo không cung cấp model chuyển giọng nói thành văn bản, còn tính năng nhập liệu bằng giọng nói của Page Assist dùng trình nhận dạng riêng của trình duyệt, được cấu hình trong Speech Recognition Language, chứ hoàn toàn không gọi API. Hãy để nguyên hai phần này theo cấu hình hiện tại.
Cấu hình này được đối chiếu với tài liệu và chuỗi giao diện của chính nhà cung cấp vào ngày bên dưới. Kunavo chưa chạy Page Assist với endpoint của mình — chưa cố định bản dựng tiện ích mở rộng nào, chưa có phiên thanh bên, chưa có phản hồi truyền phát, chưa có lượt gọi công cụ qua lại. Trang hướng dẫn cấu hình đã xuất bản không phải là một bài kiểm thử, và không nên xem nội dung ở đây là kết quả kiểm thử. Điều bạn có thể tự kiểm tra trong mười giây là curl; cách tiện ích mở rộng hoạt động với endpoint đang chạy là việc giữa bạn và Page Assist.
Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Page Assist.

Từng bước

  1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
  2. Nhấp biểu tượng Page Assist trên thanh công cụ trình duyệt, sau đó nhấp biểu tượng Settings và mở thẻ OpenAI Compatible API.
  3. Nhấp Add Provider. Kunavo không có trong các cấu hình sẵn trong menu thả xuống, vì vậy hãy chọn Custom — đây là nhánh mà bước 5 trong hướng dẫn của nhà cung cấp chỉ định cho những dịch vụ không có trong danh sách.
  4. Điền Provider Name, Base URL = https://api.kunavo.com/v1 và API Key, sau đó nhấp Save.
  5. Trong Model List vừa mở, đánh dấu các id bạn muốn. Thông thường, chọn hai model là phù hợp: một model giá rẻ để tóm tắt trang và một model mạnh để trả lời các câu hỏi tiếp theo.
  6. Mở thanh bên trên một trang thực tế — Ctrl+Shift+L mở Web UI — chọn model trong bộ chọn rồi hỏi về tab đó. Trang có nội dung thực tế sẽ cho bạn biết nhiều hơn một lời chào, vì chính văn bản của trang mới là phần tốn tiền.

Đã kiểm tra đối chiếu với Trang OpenAI Compatible API của Page Assist vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Page Assist.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

ID mô hìnhKunavo vào / raPhù hợp ở đâu trong Page Assist
claude-haiku-4-5$0.70 / $3.50mặc định cho thanh bên: tóm tắt trang và các câu hỏi tiếp theo, trong đó khối lượng sử dụng chiếm ưu thế
gpt-5-6-terra$0.70 / $4.20các trang dài — tài liệu, chuỗi thảo luận, bản ghi lời nói — được gửi nguyên vẹn thay vì cắt bớt
claude-sonnet-5$1.40 / $7.00câu hỏi sau phần tóm tắt, khi câu trả lời cần phải chính xác
gpt-5-6-sol$2.00 / $12.00ý kiến thứ hai từ một dòng họ khác; thêm dưới dạng id được đánh dấu thứ hai, cùng nhà cung cấp
Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

Chi phí xử lý trang và dữ liệu rời khỏi trình duyệt

Client thanh bên tính phí khác với trình soạn thảo, và điểm khác biệt nằm ở trang. Mỗi lượt trò chuyện của Page Assist với tab đều đưa phần văn bản trích xuất từ tab đó vào dưới dạng token đầu vào — một trang tài liệu hoặc chuỗi thảo luận dài có thể chứa hàng chục nghìn token, và chúng được gửi lại trong mỗi câu hỏi tiếp theo của cùng cuộc hội thoại. Vì vậy bảng model phía trên ưu tiên các id giá rẻ: với client này, lượng token đầu vào thường nhiều hơn token đầu ra cả một bậc độ lớn, và claude-haiku-4-5 hoặc gpt-5-6-terra đọc toàn bộ trang tốt hơn một model mạnh hơn nhưng chỉ đọc phần đã bị cắt ngắn.

Ba cài đặt làm tăng lưu lượng dữ liệu dù bạn không chủ động yêu cầu, và cả ba đều được liệt kê trên trang Settings của nhà cung cấp:

  • Generate Title using AI — “Tự động tạo tiêu đề cuộc trò chuyện từ nội dung hội thoại”. Mỗi cuộc trò chuyện có thêm một lệnh gọi, sử dụng model đang được chọn.
  • Internet Search, với Internet Search ON by default và Total Search Results — các trang được tải về sẽ được thêm vào prompt, vì vậy hóa đơn token tăng theo số lượng kết quả.
  • Page Action, tiện ích mở rộng đi kèm — model “bắt đầu bằng cách đọc trang, sau đó thực hiện từng hành động một”, tức là đọc DOM mỗi bước thay vì mỗi cuộc trò chuyện. Tùy chọn Require approval before each action của chính tiện ích này được bật theo mặc định và nên giữ nguyên như vậy.

Ranh giới quyền riêng tư cũng đi theo cùng đường đó. Page Assist lưu các cuộc trò chuyện, knowledge base và cài đặt cục bộ trong bộ nhớ trình duyệt; dữ liệu đi qua mạng là những gì bạn gửi. Khi đã chọn nhà cung cấp này, văn bản trang, tin nhắn của bạn và nội dung cuộc trò chuyện đến thời điểm hiện tại sẽ được gửi tới api.kunavo.com, rồi từ đó đến nhà cung cấp upstream phục vụ model id — xem chính sách quyền riêng tư để biết dữ liệu được lưu ở phía này. Nếu có trang mà bạn sẽ không dán vào cửa sổ trò chuyện, hãy chuyển lại sang Ollama cục bộ; tiện ích mở rộng cho phép cấu hình đồng thời cả hai nhà cung cấp để bạn có thể đổi chỉ bằng một lựa chọn trong menu thả xuống.

Nếu bạn đến đây từ cấu hình sẵn OpenRouter

OpenRouter không cần nhánh Custom. Đây là một trong các cấu hình sẵn được liệt kê trên trang OpenAI Compatible API của nhà cung cấp — cùng với Ollama, LM Studio, Groq, Together, Mistral, xAI và khoảng hai mươi dịch vụ khác — nên lộ trình gồm bốn lần nhấp đầu tiên vẫn như cũ, sau đó chọn OpenRouter trong menu thả xuống thay cho Custom, nhập khóa của OpenRouter vào API Key rồi nhấp Save. Cấu hình sẵn này có Base URL riêng, còn model id của OpenRouter có tiền tố nhà cung cấp — theo dạng anthropic/claude-sonnet-4.5 — trong khi các id trong bảng phía trên không có tiền tố. Chọn nhà cung cấp ở đây cũng là chọn không gian tên id để nhập.

Với riêng client này, việc chuyển sang OpenRouter đáng cân nhắc nếu bạn muốn một màn hình cũng truy cập được các model mà Kunavo không cung cấp, hoặc bạn đã thiết lập khóa nên không cần thiết lập thêm. Chuyển sang Kunavo đáng cân nhắc vì các id trong bảng này cũng là những id bạn dùng trong công cụ lập trình, nhờ đó một khóa dùng được cho cả hai, và bộ nhớ đệm prompt trên ngữ cảnh trang được gửi lại chính là yếu tố quyết định chi phí của thanh bên — xem bộ nhớ đệm. Bạn vẫn có thể giữ cả hai nhà cung cấp: Page Assist liệt kê chúng cùng nhau và bộ chọn model không phân biệt model đến từ dòng nào.

Câu hỏi thường gặp

Làm cách nào để dùng API tùy chỉnh với Page Assist?

Nhấp biểu tượng Page Assist trên thanh công cụ trình duyệt, mở Settings, vào thẻ OpenAI Compatible API rồi nhấp Add Provider. Nếu endpoint của bạn không nằm trong các cấu hình sẵn ở menu thả xuống, chọn Custom rồi điền Provider Name, Base URL và API Key, sau đó nhấp Save. Page Assist sẽ mở Model List được tải từ endpoint, tại đó bạn đánh dấu các model chat muốn dùng với nhà cung cấp này. Nếu không tải được danh sách, bạn cũng có thể nhập id thủ công qua Add Custom Model.

Base URL của Page Assist có cần /v1 không?

Có, với endpoint tương thích OpenAI. Trang OpenAI Compatible API không ghi rõ điều này, nhưng phần trợ giúp của trường Base URL có nêu — “Base URL của nhà cung cấp OpenAI API. ví dụ (http://localhost:1234/v1)” — và các trang LM Studio và LLaMA.cpp hiển thị cùng hậu tố trong trường tương tự: http://localhost:1234/v1 và http://localhost:8080/v1. Với Kunavo, giá trị sẽ là https://api.kunavo.com/v1. Page Assist chỉ nối thêm route, vì vậy bỏ hậu tố sẽ dẫn đến 404 thay vì lỗi xác thực.

Tại sao Page Assist không hiển thị model nào sau khi tôi thêm nhà cung cấp?

Danh sách được tải từ endpoint bằng khóa bạn vừa nhập, và thông báo của chính tiện ích mở rộng cho biết cần kiểm tra những gì: “Không tìm thấy model. Hãy đảm bảo bạn đã thêm đúng nhà cung cấp với base URL và khóa API.” Hãy kiểm tra cùng cặp thông tin đó bên ngoài tiện ích bằng lệnh curl đến /v1/models — nếu nhận được JSON thì vấn đề nằm trong cấu hình nhà cung cấp; 401 nghĩa là khóa sai; 404 thường nghĩa là Base URL thiếu /v1. Nếu vẫn không được, hãy thêm id thủ công qua Add Custom Model; cách này không phụ thuộc vào việc tải danh sách.

Page Assist có thể dùng Claude hoặc GPT thay cho model cục bộ không?

Có. “OpenAI Compatible API” chỉ định định dạng truyền tải, không phải nhà cung cấp, và model id được chuyển tiếp đến Base URL bạn đã cấu hình — vì vậy id Claude hoặc GPT được phân giải tại endpoint đó chứ không phải bên trong tiện ích mở rộng. Các tính năng dùng model cục bộ không bị ảnh hưởng: Page Assist hỗ trợ nhiều nhà cung cấp cùng lúc, nên mục Ollama và mục dịch vụ lưu trữ có thể nằm cạnh nhau, và bạn có thể chuyển qua lại bằng bộ chọn model.

Model nào có chi phí thấp nhất cho Page Assist?

Với client này, phần đầu vào chiếm ưu thế vì mỗi lượt trò chuyện với một tab đều gửi lại phần văn bản trích xuất từ tab đó. Vì vậy, mặc định phù hợp là một model giá rẻ với cửa sổ ngữ cảnh lớn — claude-haiku-4-5 cho các trang thông thường, gpt-5-6-terra cho các trang dài — đồng thời đánh dấu thêm một id mạnh hơn như claude-sonnet-5 để dùng cho những câu hỏi cần câu trả lời quan trọng. Đơn giá trên mỗi triệu token của từng model có trong bảng trên trang này, và bộ nhớ đệm prompt ảnh hưởng đến hóa đơn của thanh bên nhiều hơn lựa chọn model.

Knowledge Base của Page Assist có thể dùng Kunavo không?

Không dùng được cho phần lập chỉ mục. Knowledge Base là tính năng RAG và tài liệu của nhà cung cấp cho biết bạn phải đặt model embedding trong RAG Settings, đồng thời đề xuất nomic-embed-text; Kunavo không cung cấp model embedding, vì vậy vị trí đó cần một nhà cung cấp khác — Ollama cục bộ thường là lựa chọn phù hợp và có thể chạy song song mà không xung đột. Phần trò chuyện không bị ảnh hưởng: sau khi tài liệu được lập chỉ mục, model trả lời câu hỏi về chúng có thể là bất kỳ chat id nào từ nhà cung cấp này.

Kunavo đã kiểm thử Page Assist chưa?

Chưa. Nội dung được kiểm tra vào ngày 21 tháng 9 năm 2026 là tài liệu OpenAI Compatible API của Page Assist và các chuỗi giao diện tiếng Anh của tiện ích mở rộng — lộ trình qua Settings, nhãn và thứ tự các trường, ví dụ Base URL và thông báo danh sách trống đều được trích từ đó. Kunavo chưa cài tiện ích mở rộng, cố định bản dựng hay gửi yêu cầu qua tiện ích, và không đưa ra khẳng định nào về việc truyền phát, trích xuất nội dung trang hoặc tải Model List trong bất kỳ bản dựng cụ thể nào. Lệnh curl trên trang này là phần bạn có thể tự kiểm tra.