Knowledge BaseWhats NewFAQPrivacy Policy

Hướng dẫn thiết lập AI Assistant

Khởi tạo và thiết lập AI CS

HƯỚNG DẪN THIẾT LẬP CẤU HÌNH AI (CS AI)

1. Mục đích tính năng

Tính năng Thiết lập AI cho phép doanh nghiệp khởi tạo và cấu hình hệ thống AI của CareSoft, nhằm:

  • Tự động thiết lập quy trình cấu hình cài đặt để sử dụng tính năng AI Assistant của hệ thống CareSoft

  • Thiết lập token xác thực (Gemini Token) để hệ thống gọi đến dịch vụ AI.

  • Hỗ trợ cân bằng tải (load balancing) khi có nhiều luồng xử lý AI hoạt động song song.

2. Điều kiện sử dụng

Để có thể truy cập và thiết lập cấu hình AI, tài khoản người dùng cần có quyền:

  • ✅ admin - cấu hình v2

  • ✅ admin - cấu hình - ai

Nếu không có hai quyền này, hệ thống sẽ không hiển thị màn hình giao diện “CS AI → Thiết lập”. Liên hệ với quản trị viên hệ thống nếu bạn cần được cấp quyền.

3. Vị trí truy cập

Từ giao diện quản trị, chọn:

  • Cấu hình → CS AI → Thiết lập

Tại đây, nhấn “Khởi tạo miễn phí” để bắt đầu tạo AI agent cho doanh nghiệp.

Sau khi khởi tạo thành công: bằng cách điền token gemini và ấn "Khởi tạo", màn hình hiển thị phần “Gemini Token” cho phép người dùng chọn chế độ xử lý tải của AI.

Hướng dẫn tạo "Gemini Token"

Để lấy API Key của Gemini, có thể thực hiện theo các bước sau thông qua Google AI for Developers: Các bước chi tiết

  1. Truy cập Google AI for Developers: Mở trình duyệt web và truy cập vào trang web chính thức dành cho nhà phát triển của Google AI tại địa chỉ: https://ai.google.dev/.

  2. Đăng nhập bằng tài khoản Google: Cần đăng nhập vào tài khoản Google.

  3. Tạo khóa API: Tìm và nhấp vào tùy chọn "Get API key" hoặc "Create API key".

  4. Chọn dự án:

    • Có thể chọn một dự án Google Cloud hiện có (nếu muốn quản lý nâng cao).

    • Hoặc, chọn tùy chọn để tạo khóa API cho một dự án mới.

  5. Xác nhận và nhận Key: Google sẽ tạo một API Key duy nhất. Khóa này sẽ hiển thị trên màn hình.

  6. Lưu trữ Key an toàn: Sao chép và lưu trữ khóa API ở nơi an toàn. Khóa này cần thiết để xác thực khi sử dụng các dịch vụ Gemini API trong các ứng dụng hoặc dự án.

Lưu ý quan trọng

  • Bảo mật: API Key là thông tin nhạy cảm. Không chia sẻ công khai hoặc đưa vào mã nguồn mà người khác có thể truy cập.

  • Miễn phí (có giới hạn): Việc tạo API Key và sử dụng Gemini API ban đầu có thể miễn phí với một số giới hạn về số lượng yêu cầu. Có thể cần nâng cấp lên gói trả phí thông qua Google Cloud Console.

  • Quản lý: Có thể quản lý, xem hoặc tạo khóa mới trong Google AI for Developers hoặc Google Cloud Console.

4. Cấu hình Gemini Token

Giao diện bao gồm hai lựa chọn:

4.1. Không phân tải

  • Mô tả: Chế độ này chỉ sử dụng một bộ thông tin xác thực (token) duy nhất cho toàn bộ hoạt động AI. Hệ thống sẽ gửi tất cả yêu cầu xử lý AI qua token này mà không chia tải.

  • Khi nên sử dụng:

    • Doanh nghiệp có lượng truy cập thấp hoặc đang thử nghiệm tính năng AI.

    • Không cần nhiều token hoặc hạ tầng chia tải phức tạp.

  • Ưu điểm: Dễ cấu hình, thao tác nhanh.

  • Nhược điểm: Nếu token đạt giới hạn truy cập, hệ thống có thể bị tạm dừng xử lý tạm thời.

4.2. Cân bằng tải

  • Mô tả: Cho phép sử dụng nhiều token AI khác nhau để phân bổ yêu cầu xử lý — giúp hệ thống hoạt động ổn định và mượt mà khi có lượng truy cập lớn.

  • Nguyên lý hoạt động:

    • Các token sẽ được hệ thống luân phiên sử dụng để gửi yêu cầu AI.

    • Nếu một token tạm ngừng hoặc đạt giới hạn, hệ thống tự động chuyển sang token khác.

  • Khi nên sử dụng:

    • Doanh nghiệp có lượng người dùng cao, nhiều tác vụ AI chạy song song.

    • Cần đảm bảo tốc độ phản hồi nhanh và ổn định.

  • Cách thiết lập:

    1. Chọn tab “Cân bằng tải”.

  1. Nhấn “Thêm bộ xác thực”.

  2. Nhập:

    • Tên token(bắt buộc): dễ phân biệt trong danh sách.

    • Gemini Token (bắt buộc): Token Gemini

  3. Nhấn Cập nhật → hệ thống sẽ kiểm tra và kích hoạt token hợp lệ.

Có thể sửa, xóa, bật/tắt bộ xác thực đã tạo bằng cách click vào các icon . Bộ xác thực mặc đinh không được xóa

  • Lưu ý:

    • Nên cấu hình tối thiểu 2 token hoạt động song song để đảm bảo ổn định.

    • Có thể chuyển đổi giữa hai chế độ Không phân tải ↔ Cân bằng tải bất kỳ lúc nào.

Kết quả sau khi thiết lập

Sau khi lưu cấu hình thành công:

  • AI được kích hoạt và sẵn sàng sử dụng trong các module CS Assistant

  • Hệ thống sẽ tự động phân bổ luồng xử lý dựa trên cấu hình token.

  • Người quản trị có thể kiểm tra hoặc cập nhật token trong phần CS AI → Thiết lập bất cứ lúc nào.

Quản lý bảo trì

  • Ghi chú rõ mục đích từng token để dễ kiểm soát.

  • Khi cần thay thế hoặc ngắt kết nối AI, chỉ cần xóa token cũ hoặc bật/tắt trong mục Thiết lập.

5. Cấu hình Speech to text

Tính năng Speech to Text cho phép hệ thống chuyển đổi giọng nói của khách hàng thành văn bản trong các cuộc hội thoại. Người dùng có thể lựa chọn nhà cung cấp dịch vụ nhận dạng giọng nói phù hợp để tích hợp vào hệ thống CS AI.

Để cấu hình tính năng này cần bật quyền: Speech to text config

Quy trình thiết lập Speech to Text

1

Bước 1: Mở tab Speech to text trong phần Thiết lập của CS AI.

2

Bước 2: Nhấn vào ô Nhà cung cấp → Chọn.

Chọn nhà cung cấp Speech to Text bạn muốn sử dụng. Hiện tại hệ thống chỉ hỗ trợ nhà cung cấp ELEVENLAB

3

Bước 3: Thêm mới token

Điền các token từ nhà cung cấp Elevenlab. Truy câp vào https://elevenlabs.io/ để lấy key dùng thử miễn phí

4

Nhấn "Cập nhật" để lưu cấu hình.

6. Xử lý lỗi khi khởi tạo AI hoặc token không hợp lệ

Trong quá trình khởi tạo AI hoặc thiết lập Gemini Token, có thể xảy ra một số lỗi phổ biến. Dưới đây là hướng dẫn chi tiết giúp bạn nhận biết và khắc phục nhanh chóng.

Lỗi khi khởi tạo AI

Trường hợp 1: Không có quyền truy cập

Mô tả: Khi nhấn “Khởi tạo miễn phí”, hệ thống hiển thị thông báo:

“Bạn không có quyền truy cập. Vui lòng liên hệ quản trị viên để được cấp quyền.”

Nguyên nhân: Tài khoản của bạn chưa được cấp quyền “Admin - Cấu hình v2” hoặc “Admin - Cấu hình - AI”.

Cách khắc phục:

  1. Liên hệ quản trị viên hệ thống (người có toàn quyền trong module Cấu hình).

  2. Yêu cầu cấp quyền sau:

    • Admin - Cấu hình v2

    • Admin - Cấu hình - AI

  3. Sau khi được cấp, đăng xuất và đăng nhập lại hệ thống để cập nhật quyền.

Trường hợp 2: Kết nối khởi tạo AI thất bại

Mô tả:

  • Nút “Khởi tạo miễn phí” không phản hồi, hoặc hiển thị lỗi “Không thể khởi tạo AI”.

Nguyên nhân:

  • Hệ thống tạm thời gián đoạn kết nối với máy chủ AI.

  • Trình duyệt bị chặn bởi tường lửa nội bộ hoặc plugin bảo mật.

Cách khắc phục:

  1. Kiểm tra kết nối mạng và thử lại sau vài phút.

  2. Tắt các tiện ích chặn script (VD: AdBlock, NoScript).

  3. Làm mới trang (F5) hoặc đăng nhập lại.

  4. Nếu vẫn lỗi, liên hệ đội kỹ thuật CareSoft để kiểm tra log kết nối.

Lỗi khi thiết lập token

Trường hợp 1: Token không hợp lệ

Mô tả: Thông báo:

“Token không hợp lệ hoặc đã hết hạn.”

Nguyên nhân:

  • Token nhập sai định dạng.

  • Token hết hạn hoặc bị thu hồi từ nhà cung cấp (VD: Gemini, OpenAI,...).

Cách khắc phục:

  1. Kiểm tra lại token bạn nhập có chính xác không (không thêm khoảng trắng hoặc ký tự thừa).

  2. Nếu token cũ hết hạn, tạo token mới trên hệ thống của nhà cung cấp AI.

  3. Quay lại CS AI → Thiết lập → Cân bằng tải → Thêm token mới, nhập lại token mới.

  4. Nhấn Lưu cấu hình để cập nhật.

Trường hợp 2: Cân bằng tải không hoạt động

Mô tả: Đã thêm nhiều token nhưng hệ thống vẫn chỉ chạy 1 token duy nhất.

Nguyên nhân:

  • Token khác bị vô hiệu hóa hoặc chưa được xác thực.

  • Cấu hình cân bằng tải chưa được kích hoạt.

Cách khắc phục:

  1. Kiểm tra lại trạng thái từng token trong danh sách (chỉ token có trạng thái “Hoạt động” mới được sử dụng).

  2. Đảm bảo bạn đã chọn đúng chế độ “Cân bằng tải” thay vì “Không phân tải”.

  3. Lưu lại cấu hình và thử khởi động lại phiên làm việc AI.

Last updated

Was this helpful?