Test Case: Thiết kế & Cấu hình Kịch bản Callbot v4

1. Môi trường kiểm thử

  • Môi trường: Dev (https://dev.app.ucall.vn/dashboard)
  • Tài khoản test: ucall.asia@gmail.com
  • Workspace: UCALLXXX / UCALLXXX5
  • Tính năng: Thư viện > Callbot v4 > Chỉnh sửa/Tạo mới kịch bản

2. Danh sách Test Case Chi Tiết

2.1. Giao diện Editor & Luồng chung (Canvas)

ID Tên Test Case Các bước thực hiện Kết quả mong đợi Trạng thái
CBV4_UI_01 Kiểm tra hiển thị giao diện chính của Editor 1. Truy cập vào một kịch bản Callbot v4
2. Quan sát màn hình Editor
Hiển thị đầy đủ: Thanh header (Tên kịch bản, Lưu lúc, Vui lòng kiểm tra thông tin, Cài đặt, Tài nguyên, Kiểm thử, Xuất bản), Vùng Canvas, Panel công cụ (Node nói, Node nghe).  
CBV4_UI_02 Thêm Node Nói vào Canvas 1. Kéo/Click biểu tượng “Node nói” từ thanh công cụ bên trái vào Canvas. Node nói màu hồng được thêm vào vị trí tương ứng trên Canvas.  
CBV4_UI_03 Thêm Node Nghe vào Canvas 1. Kéo/Click biểu tượng “Node nghe” từ thanh công cụ bên trái vào Canvas. Node nghe màu vàng/cam được thêm vào Canvas.  
CBV4_UI_04 Xóa Node khỏi Canvas 1. Chọn một Node bất kỳ trên Canvas
2. Nhấn biểu tượng thùng rác (hoặc phím Delete)
Node biến mất khỏi Canvas, các liên kết đến/đi từ Node đó bị đứt.  
CBV4_UI_05 Nối các Node với nhau 1. Kéo từ điểm ra (output) của một Node vào điểm vào (input) của Node khác. Đường dây liên kết hiển thị nối thành công 2 Node. (Ví dụ: Từ Node Nói sang Node Nghe, từ Ý định của Node Nghe sang Node Nói tiếp theo).  

2.2. Cài đặt kịch bản (Global Settings)

ID Tên Test Case Các bước thực hiện Kết quả mong đợi Trạng thái
CBV4_SET_01 Mở panel Cài đặt kịch bản 1. Nhấn nút “Cài đặt” trên thanh Header Panel “Cài đặt kịch bản” hiển thị bên phải màn hình.  
CBV4_SET_02 Chọn AI Model 1. Trong panel Cài đặt, nhấn vào dropdown “Chọn AI model”
2. Chọn một model (vd: GPT-4, Claude…)
Model được chọn và lưu thành công.  
CBV4_SET_03 Cập nhật Prompt hệ thống 1. Nhập text vào ô “Prompt hệ thống”
2. Nhấn Lưu cài đặt
Nội dung prompt được lưu chính xác, hỗ trợ hiển thị các định dạng nếu có.  
CBV4_SET_04 Cấu hình Giọng Bot (Text to Speech) 1. Chọn radio “Sử dụng giọng bot”
2. Mở dropdown giọng đọc và chọn “Ucall Nữ 2 (Beta)”
3. Thay đổi Tốc độ (0.5 đến 2.0) và Âm lượng.
Các thông số thay đổi được áp dụng.  
CBV4_SET_05 Nghe thử giọng Bot 1. Sau khi chọn giọng bot, nhấn “Sinh file audio nghe trước” Hệ thống sinh ra audio mẫu theo đúng giọng, tốc độ và âm lượng đã chọn. Có thể phát lại audio.  
CBV4_SET_06 Cài đặt âm thanh nền 1. Mở rộng phần “Cài đặt âm thanh”
2. Chọn “Âm thanh nền” từ dropdown
Âm thanh nền được lưu và áp dụng cho toàn bộ cuộc gọi.  
CBV4_SET_07 Cấu hình Từ nối toàn cục 1. Mở “Cài đặt âm thanh”
2. Bật toggle “Sử dụng từ nối ở tất cả các node bot nghe”
Toggle được bật.  
CBV4_SET_08 Cấu hình Từ đặc biệt 1. Mở “Cài đặt âm thanh”
2. Nhập từ vào input “Từ đặc biệt” và nhấn Enter
Từ (tags) được thêm thành công vào danh sách từ đặc biệt. Nhấn nút X để xóa từ.  

2.3. Cấu hình Node Nói (Bot Speak Node)

ID Tên Test Case Các bước thực hiện Kết quả mong đợi Trạng thái
CBV4_S_01 Mở cấu hình Node Nói 1. Click vào một Node Nói trên Canvas Panel “Cài đặt node nói” mở ra bên phải.  
CBV4_S_02 Cấu hình kịch bản Text (Câu cố định) 1. Chọn tab “Câu cố định”
2. Nhập text vào ô “Nhập kịch bản”
Text hiển thị đầy đủ, được đồng bộ ra nội dung tóm tắt hiển thị trực tiếp trên Node ngoài Canvas.  
CBV4_S_03 Tải lên file Ghi âm (Audio) 1. Chọn tab “Câu cố định”
2. Nhấn nút “Tải lên” trong phần Ghi âm
3. Chọn file .mp3/.wav hợp lệ
File tải lên thành công, hiển thị tên file và có thể nghe thử.  
CBV4_S_04 Ghi âm trực tiếp 1. Chọn tab “Câu cố định”
2. Nhấn “Ghi âm”
3. Cấp quyền mic và nói, sau đó lưu lại
File ghi âm được tạo và hiển thị trong danh sách ghi âm.  
CBV4_S_05 Tùy chọn Cá nhân hoá (Giới tính/Nội dung) 1. Chọn tab “Câu cố định”
2. Tick chọn “Cá nhân hoá giới tính” và “Cá nhân hoá nội dung”
Checkbox hoạt động bình thường, lưu lại trạng thái khi đóng mở panel.  
CBV4_S_06 Cấu hình Prompt (Generative Response) 1. Chuyển sang tab “Prompt”
2. Nhập prompt hướng dẫn cho Bot
Prompt được lưu. (Lưu ý hiển thị nhắc nhở: “Nếu bạn dùng node agent thì bạn nên điền prompt…”).  

2.4. Cấu hình Node Nghe (Bot Listen / Intent Node)

ID Tên Test Case Các bước thực hiện Kết quả mong đợi Trạng thái
CBV4_L_01 Mở cấu hình Node Nghe 1. Click vào một Node Nghe (màu vàng) trên Canvas Panel “Cài đặt node nghe” mở ra bên phải.  
CBV4_L_02 Thêm Ý định (Intent) mới 1. Ở tab “Ý định”, nhấn nút +
2. Nhập tên và mô tả ý định, thêm các câu mẫu
Một ý định mới xuất hiện trong danh sách Ý định, đồng thời xuất hiện một cổng (port) đầu ra mới trên Node ngoài Canvas tương ứng với ý định này.  
CBV4_L_03 Sửa/Xóa Ý định 1. Click vào một ý định hiện có để sửa nội dung
2. Nhấn biểu tượng “Trừ” (-) hoặc Thùng rác để xoá
Thông tin ý định được cập nhật. Nếu xoá, nhánh (port) tương ứng trên Canvas cũng bị xoá và đứt kết nối với Node đằng sau.  
CBV4_L_04 Cấu hình Ý định “Mặc định” (Default/Fallback) 1. Kiểm tra ý định Mặc định (luôn tồn tại) Không thể xóa ý định Mặc định. Dùng để rẽ nhánh khi Bot không hiểu.  
CBV4_L_05 Thêm biến nhận diện (Entity) 1. Chuyển sang tab “Nhận diện biến”
2. Thêm biến mới (VD: Tên, Số điện thoại)
Biến được thêm thành công và có thể mapping giá trị.  
CBV4_L_06 Cấu hình thời gian của Node Nghe 1. Kéo xuống phần “Cấu hình” trong tab Ý định
2. Nhập “Thời gian nghe tối đa” (VD: 10 giây)
Lưu thành công. Báo lỗi nếu nhập định dạng sai (chữ cái, số âm).  
CBV4_L_07 Cấu hình số lần kích hoạt 1. Nhập “Kích hoạt mỗi TH tối đa” (VD: 1 lần) Lưu thành công. Báo lỗi nếu nhập <= 0.  
CBV4_L_08 Cấu hình Node Toàn cục (Global Node) 1. Bật toggle “Node toàn cục” Node nghe này có thể bắt ý định bất kể cuộc gọi đang ở bước nào (tuỳ thuộc logic luồng gọi).  
CBV4_L_09 Cấu hình Từ nối cho Node cụ thể 1. Bật toggle “Sử dụng từ nối” trong Node nghe Bật tắt thành công, độc lập hoặc ghi đè lên cấu hình cài đặt chung.  

2.5. Lưu, Kiểm thử & Xuất bản

ID Tên Test Case Các bước thực hiện Kết quả mong đợi Trạng thái
CBV4_AC_01 Tự động lưu kịch bản 1. Thực hiện chỉnh sửa (kéo thả node, nhập text)
2. Quan sát dòng “Lưu lúc…” trên header
Thời gian lưu tự động cập nhật ngay sau khi có thay đổi.  
CBV4_AC_02 Kiểm tra validation kịch bản 1. Tạo một Node nói nhưng không điền nội dung
2. Nhấn vào dòng “Vui lòng kiểm tra X thông tin”
Sổ ra danh sách các lỗi cấu hình thiếu (VD: Cảnh báo Node chưa có nội dung, Node chưa được nối dây). Click vào cảnh báo sẽ focus vào Node lỗi.  
CBV4_AC_03 Kiểm thử (Test kịch bản) 1. Nhấn nút “Kiểm thử” trên header Mở ra cửa sổ/pop-up chat hoặc gọi điện giả lập để test luồng theo cấu hình.  
CBV4_AC_04 Xuất bản (Publish) 1. Điền đủ thông tin để hết lỗi cảnh báo
2. Nhấn nút “Xuất bản”
Kịch bản được xuất bản thành công, trạng thái kịch bản chuyển thành Đã xuất bản (Active).  

2.6. Thực hiện cuộc gọi thử (End-to-End Testing)

ID Tên Test Case Các bước thực hiện Kết quả mong đợi Trạng thái
CBV4_E2E_01 Kiểm thử thay đổi Giọng đọc & Tốc độ/Âm lượng 1. Cài đặt kịch bản: Giọng Nam, Tốc độ 1.5, Âm lượng 0.8
2. Lưu và Xuất bản
3. Tạo chiến dịch gọi test tới SĐT cá nhân
Bot gọi đến phát đúng giọng Nam, tốc độ nói nhanh hơn bình thường và âm lượng nhỏ gọn mặc định.  
CBV4_E2E_02 Kiểm thử nhận diện Ý định (Intent Recognition) 1. Trong cuộc gọi test, nói các câu mẫu thuộc một ý định (VD: “Giá bao nhiêu?”) Bot nhận diện đúng ý định “Giá” và nhảy sang Node Nói tương ứng được nối từ ý định đó.  
CBV4_E2E_03 Kiểm thử kịch bản Rẽ nhánh Mặc định (Fallback) 1. Trong cuộc gọi test, nói một câu không liên quan hoặc ngoài vùng ý định đã cài đặt Bot tự động rẽ nhánh vào Ý định “Mặc định” và phát nội dung của Node nối với nhánh này (VD: “Dạ em chưa nghe rõ, anh chị có thể nhắc lại…”).  
CBV4_E2E_04 Kiểm thử Thời gian nghe tối đa 1. Cài đặt Thời gian nghe tối đa = 5s ở Node Nghe
2. Khi Bot đang lắng nghe, giữ im lặng hoàn toàn quá 5s
Sau 5 giây, Bot ngắt kết nối lắng nghe và chuyển tiếp (theo nhánh mặc định hoặc kết thúc luồng).  
CBV4_E2E_05 Kiểm thử Kích hoạt mỗi TH tối đa (Loop limit) 1. Cài đặt “Kích hoạt mỗi TH tối đa” = 2 lần ở Node Nghe
2. Cố tình kích hoạt lại Node Nghe này 3 lần
Lần 1 và 2 Bot nhận diện và phản hồi. Lần 3 hệ thống không cho phép kích hoạt lại Node này (có thể cúp máy hoặc chuyển nhánh kết thúc).  
CBV4_E2E_06 Kiểm thử Từ nối (Filler words) 1. Bật “Sử dụng từ nối”
2. Tạo cuộc gọi test, nói một câu dài để Bot xử lý ý định
Trong lúc delay chờ AI model phân loại, Bot sẽ phát các từ nối (Dạ vâng ạ, Dạ vâng…) trước khi phát câu trả lời chính.  
CBV4_E2E_07 Kiểm thử Node Toàn cục (Global Node) 1. Bật “Node toàn cục” cho Ý định “Bận” (Cúp máy)
2. Cuộc gọi đang ở một Node Nghe khác bất kỳ, KH nói “Anh đang bận”
Bot nhận diện được ý định “Bận” nhờ Node Toàn cục và chuyển ngay sang luồng chào tạm biệt rồi cúp máy.  
CBV4_E2E_08 Kiểm thử Nhận diện và trích xuất Biến (Entity) 1. Cấu hình biến “Tên khách hàng” trong Node Nghe
2. Cuộc gọi diễn ra, KH nói “Tôi là Nguyễn Văn A”
3. Xem lại lịch sử/chi tiết cuộc gọi
Hệ thống ghi nhận và trích xuất đúng biến Tên khách hàng = “Nguyễn Văn A” trong kết quả cuộc gọi.  
CBV4_E2E_09 Kiểm thử File Audio (Ghi âm) thay vì Text 1. Ở Node Nói, upload file audio MP3 thay vì nhập Text
2. Thực hiện cuộc gọi thử
Khi đến Node đó, Bot phát file Audio đã tải lên thay vì đọc bằng giọng TTS (Text-To-Speech).  
CBV4_E2E_10 Kiểm thử Prompt Agent (Generative AI) 1. Nhập Prompt trong Node Nói hướng dẫn Bot tự sinh câu trả lời
2. Thực hiện cuộc gọi thử và đặt câu hỏi mở
Bot sử dụng AI Model để tự động sinh ra câu trả lời linh hoạt dựa trên Prompt thay vì đọc câu cố định.  

3. Các case Edge/Exception (Cần lưu ý)

  • Xóa một Node đang nằm ở giữa luồng (Node có in và out): Các dây nối sẽ bị mất, hệ thống phải cảnh báo mồ côi Node cho người dùng.
  • Lặp vô hạn vòng lặp (Loop): Nối từ Node sau ngược về Node trước nó mà không có giới hạn ngắt. Hệ thống có cảnh báo hoặc trong call tự động ngắt theo Kích hoạt tối đa.
  • Xóa Ý định đang có nối dây: Dây nối bị xoá theo.
  • Nhập text quá dài trong Node Nói (Tab cố định): Giới hạn độ dài bao nhiêu? Giao diện có bị vỡ không?
  • Sử dụng cả Text Câu cố định và Tải lên Ghi âm trong 1 Node Nói: Hệ thống ưu tiên phát file Ghi âm hay Text to Speech? (Cần confirm lại business logic với BA/PO).

Tài liệu được khởi tạo dựa trên UI Editor hiện tại của Callbot v4.