Kể từ ngày 13 tháng 6 năm 2023, Hành động trò chuyện không còn được dùng nữa. Để biết thêm thông tin, hãy xem phần Hành động trò chuyện ngừng hoạt động.

Trang này được dịch bởi Cloud Translation API.

Loại

Các loại cho phép bạn định cấu hình công cụ NLU của Trợ lý (hiểu ngôn ngữ tự nhiên) để trích xuất dữ liệu có cấu trúc từ hoạt động đầu vào của người dùng. Bạn có thể sử dụng các kiểu trong các trường hợp sau:

Trong ý định, bạn có thể chú thích các cụm từ huấn luyện bằng các kiểu để tạo vị trí. Khi người dùng nói nội dung nào đó khớp với một ô, công cụ NLU sẽ trích xuất nội dung đó dưới dạng một tham số đã nhập để bạn có thể xử lý thông số đó trong cảnh.
Trong giai đoạn lấp đầy vùng trống của cảnh, bạn có thể chỉ định nhiều vùng mà bạn muốn người dùng cung cấp trước khi họ có thể chuyển đổi hoặc thoát khỏi cảnh.
Trong giai đoạn conditions của cảnh, bạn có thể cơ sở logic dựa trên việc tham số có giá trị cụ thể được xác định trong một kiểu hay không.

Loại tuỳ chỉnh

Các kiểu tuỳ chỉnh cho phép bạn tạo thông số kỹ thuật loại riêng để thông báo cho NLU gán một tập hợp giá trị cho một khoá. Bạn có thể chỉ định các loại theo nhiều cách:

Từ và từ đồng nghĩa cho phép bạn liên kết nhiều giá trị với một khoá duy nhất, được gọi là một mục nhập. Loại của bạn có thể chứa một hoặc nhiều mục nhập. Nếu chọn tuỳ chọn này, bạn cũng có thể bật các chế độ cài đặt NLU sau:
- Bật tính năng so khớp mờ – Tính năng này cho phép so khớp các mục có nhiều từ, ngay cả khi các từ được đọc theo thứ tự khác.
- Chấp nhận giá trị không xác định – Khi bạn không thể chỉ định tất cả giá trị có thể, trình xử lý ngôn ngữ có thể chấp nhận những từ hoặc cụm từ không xác định dựa trên dữ liệu huấn luyện ý định và đầu vào xung quanh, chẳng hạn như các mục có thể được thêm vào danh sách hàng tạp hoá.
Biểu thức chính quy cho phép loại này khớp với các giá trị bằng cách sử dụng mẫu biểu thức chính quy dựa trên tiêu chuẩn RE2 của Google.
Văn bản dạng tự do cho phép kiểu này khớp với bất cứ nội dung nào người dùng nói. Việc chú thích một ý định bằng loại này cho phép bạn sử dụng mọi đầu vào dưới dạng tham số mà bạn có thể chuyển đến NLU của riêng mình.

Loại hệ thống

Các loại hệ thống cho phép bạn chú thích và trích xuất dữ liệu phổ biến từ hoạt động đầu vào của người dùng bằng cách sử dụng dữ liệu và giá trị huấn luyện do hệ thống cung cấp. Các loại hệ thống sau được hỗ trợ:

Loại	Nội dung mô tả
`actions.type.DateTime`	Chứa ngày, giờ và múi giờ dựa trên chế độ cài đặt trên thiết bị của người dùng. Dùng được cho chú thích cụm từ huấn luyện và lấp đầy vị trí.
`actions.type.Date`	Chỉ chứa ngày. Chỉ dành cho việc lấp đầy khoảng trống.
`actions.type.Time`	Chỉ chứa thời gian. Chỉ dành cho việc lấp đầy khoảng trống.
`actions.type.Number`	Loại `Number` khớp với số thứ tự và số đếm.

Mức sử dụng `DateTime`, `Date` và `Time`

Các kiểu này hoạt động theo cách khác nhau tuỳ thuộc vào nơi bạn sử dụng loại và hoạt động đầu vào của người dùng khớp với kiểu.

Dùng với ý định

Việc chú thích các cụm từ huấn luyện trong ý định chỉ hỗ trợ loại DateTime. Dữ liệu đầu vào của người dùng không cần phải khớp với toàn bộ giá trị DateTime. Ví dụ: nếu người dùng chỉ cung cấp năm, thì tham số phiên có thể có dạng như sau:

"date_time": {
  "year": 2019
}

Sử dụng có lấp đầy khe

Tính năng lấp đầy vị trí hỗ trợ DateTime, Date và Time.

Nếu loại vị trí là DateTime, Trợ lý sẽ nhắc người dùng cho đến khi giá trị đầy đủ được cung cấp.
Nếu loại vị trí là Date, Trợ lý sẽ nhắc người dùng cho đến khi giá trị ngày được cung cấp. Khi được thu thập, tham số mà bạn nhận được là DateTime đầy đủ với thời gian được đặt thành 00:00.
Nếu loại vị trí là Time, Trợ lý sẽ nhắc người dùng cho đến khi giá trị thời gian được cung cấp. Khi được thu thập, tham số mà bạn nhận được là một đối tượng DateTime đầy đủ có ngày được đặt thành ngày hiện tại.

Ví dụ: giả sử một người dùng ở Los Angeles nói "Ok Google, tạo một lời nhắc lúc 8 giờ tối ngày 15 tháng 1 năm 2024". Khi DateTime được trích xuất như một phần của quy trình lấp đầy vị trí, tham số đầy đủ có thể có dạng như sau:

"date_time": {
  "day": 15,
  "hours": 20,
  "minutes": 0,
  "month": 1,
  "nanos": 0,
  "seconds": 0,
  "time_zone": {
    "id": "America/Los_Angeles"
  },
  "year": 2024
}

Sử dụng kèm theo các điều kiện

Các điều kiện chỉ cho phép sử dụng số và chuỗi, vì vậy, việc sử dụng tham số DateTime cấp cao nhất sẽ dẫn đến kết quả False cho điều kiện. Ví dụ:

$session.params.my_dateTime.day > 5 là một điều kiện hợp lệ vì giá trị day là một số và được hỗ trợ.
$session.params.my_dateTime > "01-01-2010" là một điều kiện không hợp lệ vì đối tượng "DateTime" cấp cao nhất không phải là một số hay chuỗi.

Ghi đè loại thời gian chạy

Chế độ ghi đè loại thời gian chạy cho phép bạn tự động tạo hoặc sửa đổi các loại trong phương thức thực hiện. Tính năng này cho phép bạn thêm hoặc thay thế thông số kỹ thuật của một kiểu vào thời gian chạy. Ví dụ: bạn có thể kiểm tra nguồn dữ liệu phụ trợ để tải các mục trong thực đơn hằng ngày vào một loại trong phương thức thực hiện của bạn.

Xem hướng dẫn về webhook để biết thêm thông tin về cách ghi đè loại bản dựng.