Tính năng Hành trình cho Android Studio cho phép bạn mô tả luồng người dùng toàn diện bằng ngôn ngữ tự nhiên và chạy trực tiếp luồng đó bằng tác nhân AI trên một thiết bị thông minh hoặc trình mô phỏng đã kết nối. Tập hợp hướng dẫn của bạn (gọi là hành trình) được chuyển đổi thành các hành động mà tác nhân thực hiện trên ứng dụng của bạn. Ngoài ra, bạn có thể viết và mô tả các câu nhận định phức tạp hơn mà tác nhân đánh giá dựa trên những gì tác nhân thấy trên thiết bị.
Vì tác nhân suy luận về những hành động cần thực hiện để đạt được mục tiêu, nên hành trình sẽ linh hoạt hơn trước những thay đổi nhỏ về bố cục hoặc hành vi của ứng dụng, dẫn đến ít kiểm thử không ổn định hơn khi chạy trên các phiên bản ứng dụng và cấu hình thiết bị khác nhau.
Bạn có thể viết và chạy hành trình ngay trong Android Studio hoặc từ dòng lệnh bằng bất kỳ tác nhân nào. Khi bạn chạy một hành trình, tác nhân sẽ thực hiện từng bước trong quy trình, xác minh kết quả dự kiến và tạo báo cáo kèm theo ảnh chụp màn hình cho biết từng bước đã đạt hay không đạt.
Viết hành trình
Hành trình được viết bằng XML để sắp xếp nội dung mô tả và các bước trong hành trình.
Tệp hành trình sử dụng đuôi .journey.xml và được lưu trữ trong thư mục src/journeysTest/ của mô-đun ứng dụng. Android Studio cung cấp một
trình chỉnh sửa trực quan giúp bạn dễ dàng tạo và chỉnh sửa hành trình. Bạn không cần phải
thay đổi tệp bản dựng để sử dụng hành trình.
Để tạo hành trình, hãy làm theo một trong những cách sau:
- Trong bảng điều khiển Project (Dự án) trong Android Studio, hãy nhấp chuột phải vào mô-đun ứng dụng mà bạn muốn viết hành trình rồi chọn New > Journey File (Mới > Tệp hành trình). Bạn cũng có thể chọn File > New > Journey File (Tệp > Mới > Tệp hành trình) trong trình đơn chính.
- Trong cửa sổ Tác nhân, hãy yêu cầu tác nhân tạo một hành trình cho luồng người dùng trong ứng dụng của bạn. Ví dụ: "Tạo một hành trình tìm kiếm sản phẩm, thêm sản phẩm đó vào giỏ hàng và xác minh rằng giỏ hàng cho thấy một mặt hàng".
Để chỉnh sửa một hành trình, hãy mở tệp hành trình. Bạn có thể sử dụng chế độ xem Code (Mã) để trực tiếp chỉnh sửa XML, chế độ xem Design (Thiết kế) để có trải nghiệm chỉnh sửa đơn giản hoặc chế độ xem Split (Phân tách) để xem cả hai. Bạn cũng có thể yêu cầu tác nhân cập nhật một tệp hành trình hiện có.
Trong chế độ xem Thiết kế, mỗi hàng là một bước trong hành trình. Nhập một hành động mà bạn muốn tác nhân thực hiện hoặc một câu nhận định mà bạn muốn tác nhân kiểm tra, sau đó nhấn Enter để thêm bước tiếp theo.
Mẹo viết hành trình
Mặc dù tác nhân có thể hiểu hầu hết các bước được viết bằng ngôn ngữ được hỗ trợ, nhưng việc làm theo các mẹo viết hành trình sau đây có thể mang lại kết quả chính xác và như mong đợi hơn:
- Giả sử ứng dụng của bạn đã chạy trên nền trước: Khi bạn chạy một hành trình, ứng dụng của bạn sẽ tự động khởi chạy. Các bước trong hành trình của bạn sẽ bắt đầu sau khi ứng dụng đã khởi chạy hoàn toàn. Tức là bạn không cần thêm bước "mở ứng dụng".
- Sử dụng ngôn từ rõ ràng: Việc sử dụng ngôn từ chính xác sẽ giảm thiểu khả năng hiểu sai và tăng độ tin cậy.
| Thay vì | Nên |
|---|---|
| "Chọn nút đóng" | "Nhấn vào 'Đóng'" hoặc chỉ cần nói "Đóng" |
| "Nhập 'cần tây'" | "Nhập "cần tây" vào thanh tìm kiếm ở đầu màn hình chính" |
| "Vuốt để đóng" | "Vuốt sang trái để đóng, sau đó thẻ sẽ không còn xuất hiện nữa" |
- Đưa tiêu chí thành công vào bước: Điều này giúp tác nhân hiểu rõ hơn ý định của bạn và làm rõ thời điểm hành động hoàn tất và hành động tiếp theo có thể bắt đầu.
| Thay vì | Nên |
|---|---|
| "Chọn nút gửi" | "Gửi email bằng cách nhấn vào nút gửi. Thao tác này sẽ đóng email và đưa bạn trở lại hộp thư đến." |
| "Chuyển tới giỏ hàng" | "Nhấn vào biểu tượng giỏ hàng để chuyển đến trang giỏ hàng. Xác minh rằng mục này không chứa mục nào" |
| "Nhấp vào video đầu tiên" | "Nhấp vào video đầu tiên và đợi video tải xong" |
- Tinh chỉnh hành trình: Nếu hành trình của bạn không thực thi như mong đợi, hãy xem kết quả để hiểu lý do nhân viên hỗ trợ có thể không thực thi các bước như bạn mong đợi. Hãy sử dụng thông tin này để làm rõ hơn hướng dẫn của bạn.
- Chia nhỏ hành trình thành các bước cụ thể hơn: Mặc dù tác nhân có thể diễn giải các bước có nhiều hành động, nhưng đôi khi các bước riêng biệt chi tiết hơn có thể cải thiện độ chính xác và khả năng tái tạo của hành trình.
Các chức năng và giới hạn được hỗ trợ
Dưới đây là thông tin tổng quan về các chức năng được hỗ trợ khi viết hành trình và các chức năng không được hỗ trợ hoặc có thể hoạt động không nhất quán. Danh sách sau đây chưa đầy đủ.
Các hành động sau đây được hỗ trợ trong hành trình:
- Nhấn vào các phần tử trên giao diện người dùng.
- Nhấn và giữ các phần tử trên giao diện người dùng.
- Nhập để nhập văn bản vào các trường văn bản.
- Vuốt/Cuộn theo một hướng nhất định để di chuyển trên giao diện người dùng.
Các tính năng sau hiện chưa được hỗ trợ:
- Cử chỉ nhiều ngón tay (ví dụ: chụm để thu phóng) – Các hoạt động tương tác yêu cầu hai hoặc nhiều điểm tiếp xúc trên màn hình cùng một lúc, chẳng hạn như chụm để phóng to hoặc thu nhỏ, hoặc vuốt bằng hai ngón tay.
Các tính năng sau đây có thể hoạt động không ổn định:
- Đếm – Theo dõi chính xác số lượng, tần suất hoặc tiến trình.
Các tính năng và chức năng không ngừng được cải thiện. Bạn nên kiểm tra lại trang này sau để tìm hiểu về các tính năng và chức năng bổ sung. Để giúp chúng tôi cải thiện tính năng Hành trình, hãy chia sẻ ý kiến phản hồi của bạn.
Chạy hành trình
Bạn chạy hành trình bằng tác nhân AI trong cửa sổ Tác nhân. Khi bạn chạy một hành trình, tác nhân sẽ tạo và triển khai ứng dụng của bạn cho một thiết bị, thực hiện từng bước trong hành trình và báo cáo xem hành trình đó thành công hay không.
Để chạy một hành trình, hãy làm theo một trong những cách sau:
- Mở tệp hành trình rồi nhấp vào Run (Chạy)
trong thanh công cụ của trình chỉnh sửa. - Trong chế độ xem Code (Mã) hoặc Split (Phân tách), hãy nhấp vào biểu tượng Run (Chạy)
trong lề bên cạnh thẻ <journey>. - Trong bảng điều khiển Project (Dự án), hãy nhấp chuột phải vào một tệp hành trình rồi chọn Run Journey with Agent (Chạy hành trình bằng tác nhân). Để chạy nhiều hành trình, hãy chọn nhiều tệp hành trình hoặc một thư mục chứa tệp hành trình, rồi chọn Run Journeys with Agent (Chạy hành trình bằng tác nhân).
- Trong cửa sổ Tác nhân, hãy yêu cầu tác nhân chạy một hành trình.
Android Studio sẽ bắt đầu một cuộc trò chuyện mới trong cửa sổ Tác nhân bằng tác nhân bạn chọn gần đây nhất, bao gồm cả các tác nhân khác mà bạn đã kết nối trong phần Cài đặt > Công cụ > AI > Tác nhân.
Tác nhân chạy hành trình trên thiết bị được chọn trong thanh công cụ chính. Nếu không có thiết bị nào đang chạy, thì tác nhân có thể chạy một trình mô phỏng cho bạn. Nếu bạn chạy nhiều hành trình hoặc chọn nhiều thiết bị, thì tác nhân sẽ hiển thị thông tin tóm tắt về kết quả khi quá trình chạy hoàn tất.
Chạy hành trình từ dòng lệnh
Để chạy Hành trình từ dòng lệnh bằng bất kỳ tác nhân nào, hãy sử dụng Android CLI.
Xem kết quả
Khi hoàn tất một hành trình, tác nhân sẽ báo cáo xem hành trình đó đã đạt hay không đạt, bao gồm cả mọi bước không đạt, trong cửa sổ Tác nhân. Trang này cũng cung cấp đường liên kết đến báo cáo về hành trình. Báo cáo này bao gồm:
- Kết quả tổng thể của hành trình.
- Từng bước đã thành công hay không thành công.
- Các lệnh mà tác nhân đã chạy trên thiết bị.
- Nhận xét của nhân viên hỗ trợ về từng bước.
- Đường liên kết đến ảnh chụp màn hình mà nhân viên hỗ trợ đã chụp.
Chạy hành trình dưới dạng bộ kiểm thử AGP
Trong Android Studio Rabbit 2 trở xuống, Hành trình là một tính năng của Studio Labs, chạy các hành trình dưới dạng bộ kiểm thử của Trình bổ trợ Android cho Gradle (AGP). Để sử dụng, hãy làm như sau:
- Chuyển đến Studio Labs trong trình đơn cài đặt rồi bật tính năng Hành trình.
- Đảm bảo rằng dự án của bạn sử dụng AGP 9.0.0 trở lên.
- Trong bảng điều khiển Project (Dự án), hãy nhấp chuột phải vào mô-đun ứng dụng rồi chọn New > Journey Test (Mới > Kiểm thử hành trình). Nếu đây là lần đầu tiên bạn thêm hành trình vào dự án, thì Android Studio cũng sẽ thêm tính năng hỗ trợ bộ kiểm thử AGP vào dự án của bạn.
- Mở tệp hành trình và trong chế độ xem Design (Thiết kế), hãy nhấp vào Run Journey (Chạy hành trình). Android Studio sẽ tạo cấu hình chạy thử nghiệm Journeys Test, chạy cấu hình đó trên thiết bị đã chọn và cho thấy kết quả trong bảng kết quả kiểm thử.
Bộ kiểm thử chạy dựa trên biến thể bản dựng đang hoạt động khi bạn tạo hành trình. Nếu bạn chuyển sang một biến thể bản dựng khác, hãy thêm biến thể đó vào thuộc tính targetVariants trong khối testSuites của tệp build.gradle.kts ở cấp mô-đun.