Mô hình lệnh gọi chỉ định cách người dùng gọi Hành động trong dự án. Khi người dùng gọi một Hành động, họ sẽ bắt đầu một cuộc trò chuyện với Hành động đó, do mô hình cuộc trò chuyện xác định. Bạn có thể xác định lệnh gọi theo các cách sau:
Lệnh gọi chính – Đây là lệnh gọi duy nhất bắt buộc cho dự án Hành động của bạn. Người dùng nói một cụm từ tương tự như "Ok Google, trò chuyện với <tên hiển thị>" để khớp với ý định này. Bạn thường xử lý ý định này bằng cách chào người dùng bằng tin nhắn chào mừng.
Lệnh gọi liên kết sâu – Đây là các lệnh gọi không bắt buộc cho phép bạn xác định các cụm từ huấn luyện trong một ý định tuỳ chỉnh, nhờ đó người dùng có thể liên kết sâu vào một phần cụ thể trong cuộc trò chuyện của bạn. Người dùng có thể nói một cụm từ tương tự như "Ok Google, nói chuyện với <tên hiển thị> đến <cụm từ liên kết sâu>" để khớp các loại ý định này (ví dụ: "Ok Google, nói chuyện với Thông tin về Google để lấy thông tin công ty")
Ý định tích hợp – Đây là các lệnh gọi không bắt buộc cho phép bạn tận dụng các mô hình lệnh gọi do hệ thống xác định. Bằng cách khai báo hỗ trợ cho một ý định tích hợp, người dùng có thể khám phá và gọi dự án Hành động của bạn mà không phải chỉ định tên hiển thị. Ví dụ: người dùng có thể nói "Ok Google, chơi trò chơi" và Trợ lý Google có thể hiển thị Hành động của bạn dưới dạng một tuỳ chọn để gọi.
Tạo lệnh gọi chính
Mỗi dự án Hành động đều có một lệnh gọi chính mặc định đóng vai trò là điểm truy cập mặc định vào dự án Hành động của bạn.Mô hình ngôn ngữ cho lệnh gọi này được liên kết với tên hiển thị của dự án, vì vậy, người dùng chỉ cần nói một cụm từ tương tự như "Ok Google, nói chuyện với <tên hiển thị>" để sử dụng lệnh gọi này. Khi người dùng gọi Hành động của bạn theo cách này, thời gian chạy của Trợ lý sẽ khớp với ý định của hệ thống actions.intent.MAIN.
Cách tạo lệnh gọi chính:
Tạo lệnh gọi đường liên kết sâu
Để tạo các lệnh gọi liên kết sâu, bạn cần tạo ý định của người dùng toàn cầu bằng các cụm từ huấn luyện giúp xác định hoạt động đầu vào của người dùng mà bạn muốn đặt cho đường liên kết sâu. Người dùng cho biết tên hiển thị của bạn kết hợp với cụm từ liên kết sâu để thực hiện lệnh gọi liên kết sâu (ví dụ: "Ok Google, nói chuyện với <tên hiển thị> đến <cụm từ liên kết sâu>")
Tạo lời gọi ngầm ẩn
Lệnh gọi ngầm cho phép người dùng gọi Hành động của bạn mà không cần sử dụng tên hiển thị của dự án. Để tìm Hành động phù hợp, Google sử dụng các tín hiệu như người dùng yêu cầu Trợ lý thực hiện hành động tương tự như một cụm từ của lời gọi cho một trong các ý định đã định cấu hình hoặc khi người dùng ở trong ngữ cảnh mà Hành động của bạn phù hợp.
Xử lý sự kiện gọi
Khi khớp với một trong các ý định chung của bạn, Trợ lý sẽ kích hoạt một sự kiện mà bạn có thể xử lý bằng trình xử lý. Các phần sau đây mô tả những việc trình xử lý có thể thực hiện (bạn có thể chọn một hoặc kết hợp cả ba phương thức này).
Kích hoạt webhook
Trình xử lý ý định của bạn có thể uỷ quyền cho một dịch vụ web bằng cách kích hoạt một sự kiện webhook. Cách kích hoạt webhook và yêu cầu dịch vụ web xử lý lệnh gọi:
Lời nhắc
Trình xử lý ý định của bạn có thể phản hồi bằng lời nhắc tĩnh. Thông thường, lời nhắc ý định gọi sẽ chào đón người dùng, định hướng họ về cách sử dụng Hành động hoặc phản hồi thông tin mà người dùng cần ngay lập tức (Thao tác một lần).
Cách xử lý việc so khớp ý định gọi bằng lời nhắc:
Chuyển sang một cảnh
Trình xử lý ý định của bạn có thể chuyển đổi sang một cảnh để xử lý ý định gọi đã khớp. Điều này giúp bạn linh hoạt nhất để thực hiện logic. Cách chuyển sang một cảnh: