Mô hình gọi chỉ định cách người dùng gọi các Hành động trong dự án của bạn. Khi người dùng gọi ra một Hành động, họ sẽ bắt đầu một cuộc trò chuyện với Hành động đó, tức là được xác định theo mô hình cuộc trò chuyện của bạn. 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 bắt buộc duy nhất cho dự án Actions của bạn. Người dùng nói một cụm từ tương tự như "Ok Google, hãy trò chuyện với <display name>" để khớp với ý định này, mà bạn thường xử lý bằng cách chào người dùng bằng tin nhắn chào mừng.
Lệnh gọi đường liên kết sâu – Đây là những 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 đối tượng có ý định tùy chỉnh để người dùng có thể liên kết sâu đến một phần cụ thể của ứng dụng cuộc trò chuyện. Người dùng có thể nói một cụm từ tương tự như "Ok Google, hãy trò chuyện với <tên hiển thị> thành <deep link cụm từ>" để khớp với các loại ý định (ví dụ: "Ok Google, hãy nói với Thông tin về Google để tìm công ty sự thật")
Ý định tích hợp – Đây là những lệnh gọi không bắt buộc cho phép bạn tận dụng các lệnh gọi do hệ thống xác định các mô hình gọi. Bằng cách khai báo tính năng hỗ trợ cho ý định tích hợp, người dùng có thể khám phá và gọi dự án Actions của bạn mà không cần 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 lựa chọn gọi.
Tạo lệnh gọi chính
Mỗi dự án Actions đều có một lệnh gọi chính mặc định đóng vai trò là lệnh gọi mặc định
điểm truy cập vào dự án Actions 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, nên người dùng chỉ cần nói
cụm từ tương tự như "Ok Google, hãy trò chuyện với <display name>" để sử dụng
lời gọi. Khi người dùng gọi Hành động của bạn theo cách này, Trợ lý
thời gian chạy 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ời gọi liên kết sâu
Để tạo lệnh gọi liên kết sâu, bạn phải tạo ý định chung của người dùng thông qua quá trình huấn luyện các cụm từ xác định hoạt động đầu vào của người dùng mà bạn muốn thiết lập cho đường liên kết sâu. Người dùng nói tên hiển thị của bạn cùng với cụm từ đường liên kết sâu sẽ hiển thị lời gọi liên kết sâu (ví dụ: "Ok Google, nói chuyện với <display tên> thành <deep link snippet>")
Tạo lời gọi ngầm ẩn
Lời gọi ngầm ẩn 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ị. Để tìm các 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ý làm một việc gì đó tương tự như một khẩu lệnh gọi yêu cầu ý định đã định cấu hình của bạn hoặc khi người dùng đang ở trong bối cảnh mà Hành động của bạn là phù hợp.
Xử lý sự kiện gọi
Khi Trợ lý 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 gì trình xử lý của bạn có thể thực hiện (bạn có thể chọn một hoặc bất kỳ kết hợp nào trong số ba cách).
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:
Câu lệnh
Trình xử lý ý định của bạn có thể phản hồi bằng một lời nhắc tĩnh. Thông thường, lời nhắc về ý định gọi ra chào đón người dùng, định hướng cho họ cách sử dụng Hành động, hoặc phản hồi và cung cấp 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ý lệnh gọi trùng khớp ý định. Điều này mang lại cho bạn sự linh hoạt nhất để thực hiện logic. Để chuyển sang một cảnh: