AI Reviews — tạo đánh giá bằng AI

Cần chuẩn bị

• Một tài khoản AI có API key và còn hạn mức: OpenAI, Anthropic (Claude), Google Gemini, hoặc bất kỳ dịch vụ nào tương thích OpenAI (DeepSeek, Groq, OpenRouter, Ollama…).
• Máy chủ website kết nối được ra Internet.
• Nên tắt WP-Cron của WordPress và cho hệ thống chạy lịch thay, nếu bạn muốn lịch chạy đúng giờ. Xem mục cuối bài.

Mở tab AI Reviews

1. Tab AI Reviews — bên trong chia làm chín mục, có mục lục dính bên trái để nhảy nhanh.

Đọc dải số ở đầu trang

1. Trạng thái — Đang bật hay Tắt. Tắt thì lịch không chạy, nhưng bạn vẫn bấm chạy tay được.
2. Provider active — mấy nhà cung cấp còn dùng được trên tổng số đã khai. Thấy 0/3 nghĩa là cả ba đều đang bị tạm nghỉ vì lỗi hạn mức.
3. Reviews đã sinh — tổng số đánh giá AI đã tạo từ trước tới nay.
4. Chi phí tích luỹ — tổng tiền đã tiêu, tính bằng đô la Mỹ.
5. Lịch tiếp theo — còn bao lâu tới lượt chạy kế. Hiện dấu gạch nghĩa là chưa đặt lịch.

Mục 1 — Cấu hình chung

1. Bật AI Reviews — công tắc chính. Cứ để tắt cho tới khi bạn đã chạy thử và ưng nội dung.
2. Chế độ failover — khi có nhiều nhà cung cấp: Theo độ ưu tiên luôn dùng cái rẻ nhất trước, hết hạn mức mới chuyển; Round-robin chia đều; Random chọn ngẫu nhiên. Chọn theo độ ưu tiên là hợp lý nhất.
3. Cooldown — khi một nhà cung cấp báo hết hạn mức, tạm bỏ qua nó bao nhiêu giây. Mặc định 3600 (một tiếng) là hợp lý.
4. Retry & timeout — thử lại mấy lần khi lỗi mạng, và chờ tối đa bao nhiêu giây cho mỗi lượt gọi. Để mặc định.
5. Tự động tắt — sau bao nhiêu lỗi liên tiếp thì cho nhà cung cấp đó nghỉ 24 giờ. Để 0 là không bao giờ tự tắt.

Mục 2 — Khai báo nhà cung cấp

1. Ưu tiên — số càng nhỏ càng được gọi trước. Đặt cái rẻ nhất số nhỏ nhất.
2. API Key — hiện dạng che bớt, chỉ để bạn đối chiếu xem có đúng key không.
3. Trạng thái — Active là dùng được; Cooldown là đang tạm nghỉ vì lỗi hạn mức; Disabled là bạn đã tự tắt.
4. Test — gọi thử một lượt để kiểm tra key và model có đúng không. Nút Sửa và Xoá nằm cạnh.
5. + Thêm provider — mở hộp thoại khai báo mới.

Hộp thoại thêm nhà cung cấp

1. Tên hiển thị — đặt gì cũng được, chỉ để bạn nhận ra trong bảng và trong nhật ký.
2. Loại — chọn xong sẽ hiện ngay khối hướng dẫn xanh: lấy key ở đâu, nên dùng model rẻ nào. Chọn OpenAI-compatible cho DeepSeek, Groq, OpenRouter, Ollama; khi đó có thêm ô Base URL.
3. Model — gõ đúng mã model, ví dụ gpt-4o-mini. Gõ sai thì lượt gọi nào cũng lỗi.
4. Fetch — gõ API key trước rồi bấm nút này, plugin đi hỏi nhà cung cấp danh sách model thật và đổ vào ô chọn nhanh bên cạnh. Cách chắc chắn nhất để không gõ sai tên model.
5. API Key — dán key vào. Khi sửa một nhà cung cấp có sẵn, để trống ô này nghĩa là giữ nguyên key cũ.
6. Ưu tiên — số nhỏ được gọi trước.
7. Bảng giá — giá mỗi triệu token vào và ra, cùng tỷ giá VNĐ. Chọn model từ danh sách gợi ý thì plugin tự điền. Điền đúng giá thì con số chi phí ở mục 8 mới đáng tin.

Cuối hộp thoại còn ô Reasoning. Chỉ đụng vào khi bạn dùng model biết suy luận (reasoning) và gặp cảnh đánh giá trả về rỗng: dấu hiệu là trong nhật ký thấy out_tk gần bằng max_tokens mà nội dung trống. Model thường thì để mặc định, gửi tham số lạ có thể bị nhà cung cấp từ chối.

Mục 3 — Prompt

1. System prompt — mô tả vai trò cho AI, ví dụ "bạn là khách hàng thật vừa mua sản phẩm này".
2. User prompt — yêu cầu cụ thể. Trong đây dùng được các ô thay thế như {product_context} (thông tin sản phẩm), {rating} (số sao), {tone}, {length}, {language}, {few_shot_block} (vài đánh giá thật làm mẫu). Danh sách đầy đủ in ngay dưới ô nhập.
3. Tone / Độ dài / Ngôn ngữ — giọng văn, độ dài và tiếng dùng. Chọn Mixed ở ô độ dài để mỗi đánh giá một độ dài khác nhau, nhìn tự nhiên hơn nhiều.
4. Tinh chỉnh model — Temperature càng cao càng đa dạng (0.8–1.0 là hợp cho đánh giá); Max tokens giới hạn độ dài trả về.
5. Phân bố sao — tỷ lệ số sao, ví dụ 70,20,8,2,0 nghĩa là 70% năm sao, 20% bốn sao, 8% ba sao, 2% hai sao. Đừng để 100% năm sao.

Mục 4 — Ngữ cảnh sản phẩm

Hàng ô tích ở trên cùng chọn nguồn thông tin: tên sản phẩm, mô tả ngắn, mô tả đầy đủ, danh mục, thẻ, thuộc tính, giá. Càng cho nhiều thì đánh giá càng sát sản phẩm, nhưng cũng tốn token hơn. Bật tên sản phẩm, mô tả ngắn và danh mục là đủ cho phần lớn trường hợp.

1. Max words mô tả đầy đủ — cắt bớt mô tả dài để khỏi tốn tiền. Chỉ có tác dụng khi bạn bật ô "mô tả đầy đủ".
2. Thương hiệu — cho AI biết tên hãng, lấy từ nhóm phân loại hoặc thuộc tính sản phẩm.
3. Custom meta keys — thêm những trường dữ liệu riêng của bạn, mỗi tên một dòng. Bỏ trống nếu không dùng.
4. Few-shot reviews thật — cho AI xem vài đánh giá thật đã có trên website để bắt chước giọng văn. Đây là cách đơn giản nhất khiến kết quả bớt "mùi máy". Chỉ dùng được khi bạn đã có sẵn đánh giá thật.

Mục 5 — Người đánh giá

1. Chế độ tên — AI gen để AI tự nghĩ tên (tốn thêm một lượt gọi), hoặc lấy ngẫu nhiên từ danh sách bạn khai. Dùng danh sách thì rẻ hơn và bạn kiểm soát được.
2. Prompt tạo tên — chỉ dùng khi chọn AI gen. Mô tả loại tên bạn muốn, ví dụ tên người Việt tự nhiên, có cả tên hiếm.
3. Rút gọn tên — hiện "Nguyễn Ngọc Ánh Thư" thành "Anh Thư". Nên bật, vì khách thật thường để tên ngắn.
4. Tự sinh — tạo kèm email và số điện thoại giả cho mỗi đánh giá. Bật nếu bạn có bật hiện số điện thoại cạnh tên ở Cài đặt chung.
5. Khách đã mua (verified) — có gắn nhãn "đã mua hàng" cho đánh giá AI không. Cân nhắc kỹ: nhãn này khẳng định người viết đã mua thật, gắn bừa là nói dối khách. Chọn "không bao giờ" là an toàn nhất.

Mục 6 — Lập lịch và chọn sản phẩm

1. Chế độ chạy — Manual chỉ chạy khi bạn bấm; ngoài ra có chạy theo giờ, theo ngày, hoặc theo khoảng thời gian tự đặt.
2. Ngày trong tuần — bỏ tích những ngày không muốn chạy. Bỏ hết là chạy mọi ngày.
3. Lọc danh mục — chỉ chạy cho sản phẩm thuộc danh mục được chọn. Để trống là tất cả.

1. Sản phẩm chỉ định — gõ tên hoặc mã để chọn đích danh vài sản phẩm. Để trống là không giới hạn.
2. Exclude danh mục — danh mục cần tránh, ví dụ danh mục hàng khuyến mãi hoặc quà tặng.
3. Exclude sản phẩm — sản phẩm cần tránh. Ngoài ra bạn có thể bật ô "Bỏ qua AI Reviews" ngay trong trang sửa từng sản phẩm.
4. Loại sản phẩm — chỉ chạy cho sản phẩm đơn giản, có biến thể, theo nhóm hay liên kết ngoài.

Hai dòng tiếp theo không có trong ảnh nhưng cũng quan trọng:

1. Ngưỡng review — sản phẩm đã có bao nhiêu đánh giá thì thôi không viết thêm, và mỗi lượt viết bao nhiêu cái cho một sản phẩm.
2. Rải timestamp review — quan trọng nhất về mặt "trông có thật". Nếu không rải, mọi đánh giá sẽ mang đúng thời điểm chạy, nghĩa là mười đánh giá cùng lúc 3 giờ sáng. Chọn rải trong khung giờ ban ngày và trải ra vài ngày.
3. Giới hạn batch — mỗi lượt chạy tối đa bao nhiêu sản phẩm, bao nhiêu lượt gọi, chờ giữa hai lượt bao lâu, chạy tối đa bao nhiêu giây và tốn tối đa bao nhiêu tiền.
4. Giới hạn chi phí — trần cứng theo ngày và theo tháng. Hãy điền hai ô này ngay. Chúng là thứ duy nhất chặn được cảnh lịch chạy mỗi giờ suốt một tháng rồi hoá đơn về vài trăm đô. Để 0 nghĩa là không giới hạn.

Mục 7 — Chạy thử trước khi bật lịch

1. Chạy 1 batch — chạy đúng một lượt theo cấu hình đã lưu, rồi dừng.
2. Chạy liên tục đến hết — chạy hết lượt này tới lượt khác cho tới khi hết sản phẩm hoặc chạm trần chi phí. Có nút Dừng bên cạnh.
3. Force unlock — chỉ dùng khi một lượt chạy bị kẹt giữa chừng (mất điện, hết thời gian máy chủ) khiến plugin tưởng vẫn đang chạy và từ chối chạy tiếp.
4. Chọn sản phẩm — gõ tên để tìm một sản phẩm cụ thể.
5. Generate preview — sinh thử một đánh giá cho sản phẩm đó và cho bạn xem, không lưu vào website. Bấm vài lần cho tới khi ưng giọng văn rồi hãy chạy thật.

Mục 8 và 9 — Chi phí và nhật ký

1. Đánh giá — số đánh giá đã tạo thành công.
2. Tổng chi phí — tính theo bảng giá bạn khai trong hộp thoại nhà cung cấp. Khai giá sai thì con số này sai theo.
3. TB/review — trung bình mỗi đánh giá tốn bao nhiêu. Dùng con số này để ước tính: cần 500 đánh giá thì nhân lên là ra.
4. Theo provider — bảng so sánh từng nhà cung cấp: bao nhiêu lượt gọi, bao nhiêu lỗi hạn mức, tốn bao nhiêu. Nhìn bảng này để biết nên bỏ ai và giữ ai.
5. Xuất CSV — tải toàn bộ số liệu về máy để tính toán riêng.

1. Mức — success là bình thường, error là hỏng, warn là chạy được nhưng có vấn đề.
2. Nội dung — thông báo lỗi nguyên văn từ nhà cung cấp. Khi nhắn hỏi hỗ trợ, hãy gửi đúng dòng này.
3. Tk — số token vào/ra. Nếu số ra gần bằng giới hạn mà nội dung trống thì đó là model reasoning, xem lại ô Reasoning ở mục 2.

Thứ tự nên làm

1. Thêm một nhà cung cấp, bấm Test cho tới khi báo thành công.
2. Điền trần chi phí theo ngày và theo tháng ở mục 6, bấm Lưu thay đổi.
3. Vào mục 7, chọn một sản phẩm rồi bấm Generate preview vài lần. Chưa ưng thì quay lại sửa prompt ở mục 3.
4. Bấm Chạy 1 batch, rồi mở trang sản phẩm xem kết quả thật.
5. Ưng rồi mới bật Bật AI Reviews ở mục 1 và đặt lịch ở mục 6.

Muốn lịch chạy đúng giờ

WordPress chỉ kiểm tra lịch khi có người vào website. Website ít khách thì lịch 2 giờ sáng có thể tới 9 giờ mới chạy. Muốn đúng giờ, nhờ người quản trị máy chủ thêm dòng sau vào wp-config.php:

define('DISABLE_WP_CRON', true);

rồi đặt hệ thống gọi wp-cron.php mỗi 5 phút. Không làm bước này plugin vẫn chạy, chỉ là giờ chạy không chính xác.

Lỗi thường gặp

Tiếp theo: Nhắc khách đánh giá qua email — cách lấy đánh giá thật.