Ý định là các đối tượng thông báo mô tả cách thực hiện một việc gì đó. Bạn có thể sử dụng ý định theo một trong 2 cách:
- Bằng cách cung cấp phương thức thực hiện cho một ý định, hoặc
- Yêu cầu Trợ lý Google thực hiện ý định.
Quy trình mà bạn cung cấp phương thức thực hiện cho một ý định sẽ khác nhau đối với nhà phát triển xây dựng bằng Dialogflow và đối với nhà phát triển tạo bằng SDK Hành động. Tuy nhiên, trong cả hai trường hợp, bạn đều cung cấp tên của ý định và URL của webhook thực hiện nhiệm vụ. Điều này cho Actions on Google biết rằng bạn có thể hỗ trợ các truy vấn của người dùng phù hợp với ý định.
Để yêu cầu thực hiện một ý định, bạn cần chỉ định ý định đó trong đối tượng possibleIntents khi phản hồi Trợ lý. Trong yêu cầu tiếp theo đối với phương thức thực hiện của bạn, Trợ lý sẽ trả về kết quả của ý định đã xử lý cho bạn. Để biết thêm thông tin, hãy đọc phần tổng quan về cách sử dụng của trình trợ giúp.
Ý định phổ biến
Bảng sau đây mô tả các ý định mà Trợ lý yêu cầu bạn thực hiện.
| Tên ý định | Cách sử dụng | Sự kiện Dialogflow |
|---|---|---|
actions.intent.MAIN |
Bắt buộc: Mỗi Gói Hành động khai báo một và chỉ một ý định đóng vai trò là điểm truy cập để người dùng bắt đầu cuộc trò chuyện. | WELCOME hoặc GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
Lấy bản trình bày dạng văn bản thô của yêu cầu của người dùng. Bạn thường sử dụng cấp độ này khi tham gia trò chuyện với người dùng. | |
actions.intent.CANCEL |
Bạn nhận được ý định này khi chọn nhận ý định huỷ trong gói hành động của mình. Khi người dùng nói một lệnh huỷ chung, chẳng hạn như "thoát", bạn sẽ nhận được ý định này trong yêu cầu tiếp theo đến phương thức thực hiện, vì vậy bạn có thể phản hồi bằng thông báo cuối cùng và thực hiện mọi thao tác dọn dẹp trong logic thực hiện của bạn. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
Bạn nhận được ý định này khi chọn nhận ý định không có đầu vào trong gói hành động của mình. Khi người dùng không phản hồi lời nhắc, bạn sẽ nhận được ý định này trong yêu cầu tiếp theo để thực hiện yêu cầu. | actions_intent_NO_INPUT |
Người trợ giúp
Bảng sau đây mô tả các trình trợ giúp được hỗ trợ mà bạn có thể yêu cầu Trợ lý thực hiện.
| Tên ý định | Cách sử dụng | Sự kiện Dialogflow |
|---|---|---|
actions.intent.PERMISSION |
Lấy tên đầy đủ, vị trí tương đối hoặc vị trí chính xác hoặc cả 3 thông tin của người dùng. | actions_intent_PERMISSION |
actions.intent.OPTION |
Nhận mục đã chọn từ giao diện người dùng của danh sách hoặc băng chuyền. Hoặc nếu người dùng không chọn trong giao diện người dùng danh sách hoặc băng chuyền, hãy nhận dữ liệu nhập bằng lời nói hoặc văn bản khớp với khoá trong danh sách hoặc giao diện người dùng băng chuyền. | actions_intent_OPTION |
actions.intent.DATETIME |
Nhận ngày và giờ nhập từ người dùng. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
Yêu cầu quy trình liên kết tài khoản để liên kết tài khoản của người dùng. | actions_intent_SIGN_IN |
actions.intent.PLACE |
Lấy địa chỉ hoặc vị trí đã lưu từ người dùng. | actions_intent_PLACE |
actions.intent.CONFIRMATION |
Nhận xác nhận từ người dùng (ví dụ: câu trả lời cho câu hỏi có hoặc không). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
Yêu cầu người dùng cấp quyền chuyển sang một nền tảng khác của Trợ lý. | actions_intent_NEW_SURFACE |
Ý định tích hợp
Các ý định tích hợp mô hình hoá một số cách phổ biến để người dùng thể hiện việc họ muốn làm hoặc thông tin họ tìm kiếm, chẳng hạn như đặt đồ ăn, đặt xe hoặc kiểm tra số dư tài khoản. Hãy xem tài liệu tham khảo về ý định tích hợp để biết thêm thông tin.
Ý định khác
Hầu hết các Hành động trò chuyện đều được xây dựng bằng sự kết hợp của các ý định phổ biến, trình trợ giúp và phản hồi. Tuy nhiên, những Hành động kết hợp với các tính năng bổ sung như giao dịch hoặc cập nhật hằng ngày sẽ có quyền truy cập vào các ý định dành riêng cho các tính năng đó.
Trình trợ giúp giao dịch
Bảng sau đây mô tả các trình trợ giúp liên quan đến việc xử lý giao dịch mua mà bạn có thể yêu cầu Trợ lý thực hiện. Bạn có thể tìm thêm thông tin về cách triển khai các ý định này và các ý định liên quan khác trong tài liệu về tính năng giao dịch.
| Tên ý định | Cách sử dụng | Sự kiện Dialogflow |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
Nhận thông tin nhập địa chỉ giao hàng từ người dùng. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
Kiểm tra xem tất cả các yêu cầu đối với một giao dịch có được đáp ứng hay không. | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
Hỏi người dùng xem có nên thực hiện giao dịch hay không. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
Xác thực cấu hình giao dịch của người dùng. Dùng để tránh cung cấp hàng hoá kỹ thuật số cho người dùng mà giao dịch không thành công. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
Bắt đầu một yêu cầu mua hàng. Đưa ra kết quả mua hàng mô tả giao dịch thành công hay không thành công và cách thức giao dịch đó thành công. | actions_intent_COMPLETE_PURCHASE |
Ý định tương tác của người dùng
Bảng sau đây mô tả các ý định liên quan đến các tính năng về mức độ tương tác của người dùng. Bạn có thể tìm thêm thông tin về cách triển khai các ý định này và các ý định liên quan khác trong tài liệu về tính năng mức độ tương tác của người dùng.
| Tên ý định | Cung cấp phương thức thực hiện đơn hàng | Yêu cầu thực hiện | Cách sử dụng | Sự kiện Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | Yêu cầu người dùng đăng ký bản cập nhật. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | Bạn nhận được ý định này khi người dùng cố gắng đăng ký bản cập nhật (tức là cần gửi ý định SIGN_UPDATE). | actions_intent_CONFIGURE_UPDATES |
Ý định tuỳ chỉnh
Bạn có thể tạo ý định riêng để xác định các lối tắt trong cuộc trò chuyện nhằm giúp người dùng hoàn thành công việc hiệu quả hơn. Các ý định này nằm trong không gian tên của riêng bạn; bạn xác định cách người dùng kích hoạt ý định và Gói Hành động của bạn là gói duy nhất có thể hỗ trợ các ý định đó.
Để biết thêm thông tin, hãy đọc bài viết xác định Hành động trong Dialogflow hoặc bằng SDK Hành động. Bạn có thể tìm thêm thông tin về các gói Hành động trong tài liệu Tài liệu tham khảo về gói hành động.
Ý định của nhà thông minh
Nếu đang tạo một Hành động trong nhà thông minh, bạn sẽ xác định tính năng hỗ trợ cho ý định theo cách hơi khác. Vui lòng xem tài liệu về ý định của nhà thông minh để biết thêm thông tin.