1. Kích hoạt module GenAI

Để bắt đầu, bạn cần mở khóa tính năng GenAI trong hệ thống: Truy cập vào Extend Modules → Tìm module GenAI → Chọn Kích hoạt.

2. Tích hợp "Bộ não" AI

SmaxAI đóng vai trò là nền tảng quản lý, còn "bộ não" xử lý ngôn ngữ sẽ do các nền tảng AI lớn cung cấp. Bạn cần kết nối SmaxAI với một trong các nền tảng này thông qua API Key (có thể hiểu đơn giản là "mã kích hoạt" để Smax mượn trí tuệ của AI).

Các bước thực hiện:

1. Vào Cài đặt → Tích hợp.
2. Chọn Thêm mới, đặt tên cho tích hợp và chọn nền tảng AI bạn muốn sử dụng. Hiện SmaxAI hỗ trợ:
   • OpenAI (ChatGPT)
   • Gemini (Google)
   • Groq
   • Claude
   • XAi
   • DeepSeek
3. Nhập API Key của nền tảng đó và nhấn Lưu.

Hướng dẫn lấy API Key cho từng nền tảng

2.1. OpenAI (ChatGPT)

• Truy cập: platform.openai.com/settings/organization/billing/overview
• Lưu ý: Bạn cần nạp tiền vào tài khoản (Credit) thì API mới hoạt động.
• Cách lấy: Chọn API keys → Create new secret key → Copy mã này dán vào SmaxAI.

2.2. Gemini (Google)

• Truy cập: aistudio.google.com/apikey
• Cách lấy: Chọn Create API Key.
• Lưu ý: Bản miễn phí sẽ có giới hạn số câu trả lời. Để dùng ổn định cho doanh nghiệp, hãy chọn Set up Billing và thêm thẻ ngân hàng.

2.3. Groq

• Truy cập: console.groq.com/settings/billing/manage để thêm thẻ thanh toán.
• Cách lấy: Sau khi thanh toán, chọn API Keys để tạo mã mới.

2.4. Claude

• Truy cập: console.anthropic.com/settings/billing để nạp tiền vào tài khoản.
• Cách lấy: Tạo API Key sau khi tài khoản đã có số dư.

2.5. XAI

• Truy cập: [docs.x.aiOverview](https://docs.x.ai/docs/overview) → Click Avatar → Go to Console.
• Cách lấy: Vào Billing → Payment để nạp tiền → Vào API Keys → Create API key.

2.6. Deepseek

• Truy cập: www.deepseek.com/ → Chọn API.
• Cách lấy: Vào Top up để nạp tiền → Vào API keys → Create new API key.

3. Xây dựng AI Chatbot của riêng bạn

3.1. Tổng quan giao diện

Khi tạo mới một GenAI Agent, bạn sẽ làm việc với 3 khu vực chính:

(1) Prompt (Hướng dẫn): Nơi bạn "dạy" AI biết nó là ai, phong cách trả lời thế nào và mục tiêu là gì. (2) Cấu hình (Kiến thức): Nơi bạn cung cấp tài liệu, sản phẩm, dữ liệu để AI không trả lời sai sự thật. (3) Demo & Review (Thử nghiệm): Nơi bạn chat thử để kiểm tra và điều chỉnh trước khi cho khách hàng dùng.

3.2. Chọn mô hình AI

Bạn cần chọn loại AI và phiên bản (ví dụ: GPT-4o, Gemini Pro...) để kết nối. Tùy vào ngân sách và yêu cầu về độ thông minh mà bạn chọn mô hình phù hợp.

3.3. Thiết lập Prompt (Hướng dẫn điều hướng)

3.3.1. Các công cụ hỗ trợ viết Prompt

• Tối ưu Prompt bằng AI: Nếu bạn không biết viết sao cho hay, hãy mô tả yêu cầu đơn giản (ví dụ: "Hãy viết cho tôi một prompt cho nhân viên tư vấn mỹ phẩm nhẹ nhàng"), AI sẽ tự soạn một bản Prompt chuyên nghiệp cho bạn.

• Sử dụng cú pháp #: Bạn có thể dùng dấu # để chia các mục (Tiêu đề 1, Tiêu đề 2...) giúp AI dễ dàng nắm bắt cấu trúc hướng dẫn.

3.3.2. Phân biệt System Prompt và User Prompt

Hãy tưởng tượng một cuộc hội thoại tại cửa hàng:

System Prompt

User Prompt

3.3.3. Sử dụng Thư viện Prompt

Nếu bạn mới bắt đầu, hãy sử dụng các mẫu có sẵn theo ngành nghề: Bước 1: Click Thư viện prompt → Bước 2: Chọn mẫu phù hợp → Bước 3: Nhấn Sử dụng Prompt hoặc Copy để chỉnh sửa.

3.3.4. Tối ưu hóa Prompt

Khi AI trả lời chưa đúng ý, bạn có thể:

1. Click Tối ưu hoá → Nhập yêu cầu điều chỉnh → AI sẽ viết lại Prompt.
2. Tự động tối ưu: AI tự cải thiện dựa trên logic của nó.
3. Tối ưu dựa trên kết quả debug: Bạn chỉ ra câu trả lời nào của AI bị sai, AI sẽ sửa Prompt để lần sau không sai nữa.

3.4. Cấu hình "Kho kiến thức" (Knowledge Base)

Để AI không "nói hươu nói vượn", bạn cần cung cấp dữ liệu chính xác của doanh nghiệp.

3.4.1. Kỹ năng (Skill)

Chọn chuyên môn cho AI để nó ưu tiên cách tư vấn phù hợp:

3.4.2. Các nguồn cung cấp kiến thức

Bạn nên phối hợp nhiều nguồn kiến thức để AI thông minh nhất:

A. Tài liệu (PDF, Word, Excel, PPT)

• Khi nào dùng: Khi bạn có file chính sách bảo hành, hướng dẫn sử dụng dài, danh mục sản phẩm chi tiết.
• Cách dùng: Nhấn dấu (+) để tải file lên.

B. Văn bản (Text)

• Khi nào dùng: Khi bạn muốn thêm nhanh các thông tin ngắn như: "Địa chỉ shop tại 123 ABC", "Giờ mở cửa từ 8h-21h".
• Cách dùng: Nhấn dấu (+) → Nhập Tên & Nội dung → Lưu.

C. Bảng dữ liệu (Data Table)

• Khi nào dùng: Khi bạn có dữ liệu có cấu trúc (ví dụ: Bảng giá sản phẩm, Bảng tra cứu mã vận đơn).
• Cách dùng: Tạo bảng tại module Bảng dữ liệu → Quay lại GenAI → Nhấn (+) → Chọn bảng cần dùng.

D. Lịch sử tin nhắn

Giúp AI nhớ khách vừa nói gì ở câu trước để không hỏi lại.

• Lịch sử tin nhắn (Message): Nhớ X câu gần nhất.
• Lịch sử phiên (Chat Session): Nhớ toàn bộ cuộc trò chuyện trong vòng 24h.

E. Mẫu phản hồi (Fixed Response)

• Khi nào dùng: Khi bạn muốn AI trả lời chính xác 100% một câu nào đó, không được tự ý sáng tạo (ví dụ: Câu trả lời về pháp lý, cam kết giá).
• Cách dùng: Nhấn (+) → Nhập Câu hỏi mẫu và Câu trả lời mẫu → Lưu.

F. Sản phẩm

• Khi nào dùng: Khi bạn muốn AI tư vấn đúng mã sản phẩm, giá cả và mô tả từ kho hàng của Smax.
• Cách dùng: Nhấn (+) → Chọn sản phẩm từ danh sách → Lưu.

3.4.3. Cấu hình nâng cao: Ý định (Intentions)

Ví dụ thực tế: Khách nhắn: "Tôi muốn hủy đơn hàng" → AI nhận diện Ý định là Hủy đơn → Smax sẽ tự động gửi một Block kịch bản yêu cầu khách nhập mã đơn hàng → Chuyển cho nhân viên xử lý.

Cách tạo Ý định:

1. Nhấn (+) tại mục Intentions.
2. Tên: Đặt tên ngắn gọn (ví dụ: huy_don, dat_lich).
3. Mô tả: Mô tả chi tiết để AI biết khi nào thì khách đang có ý định này.
4. Thông tin thu thập (tùy chọn): Thiết lập những thông tin AI cần hỏi khách trước khi kết thúc (ví dụ: Số điện thoại, Ngày hẹn).

3.5. Demo & Review (Kiểm thử)

Trước khi cho AI "ra trận", bạn hãy dùng khu vực này để kiểm tra chất lượng.

• Chat thử: Nhập câu hỏi như khách hàng → Xem AI trả lời dựa trên Prompt và Kiến thức bạn đã cài.
• Tinh chỉnh: Nếu AI trả lời sai → Quay lại sửa Prompt hoặc thêm Kiến thức → Chat thử lại.
• Xóa lịch sử: Nhấn Xóa lịch sử chat để bắt đầu một phiên thử nghiệm mới hoàn toàn.