Loại

Các loại cho phép bạn định cấu hình 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 loại 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 loại để tạo vị trí. Khi người dùng nói cụm từ khớp với ô trống, công cụ NLU trích xuất dưới dạng tham số đã nhập để bạn có thể xử lý trong một cảnh.

  • Trong giai đoạn lấp đầy vùng của cảnh, bạn có thể chỉ định nhiều vị trí mà bạn muốn người dùng cung cấp trước khi họ có thể chuyển tiếp hoặc thoát khỏi cảnh.

  • Trong giai đoạn điều kiện của cảnh, bạn có thể dựa vào logic về việc liệu một tham số có giá trị cụ thể được xác định trong một loại hay không.

Loại tuỳ chỉnh

Các loại tuỳ chỉnh cho phép bạn tạo thông số kỹ thuật loại của riêng mình để 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 cách:

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

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 đây được hỗ trợ:

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

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

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

Sử dụng cùng ý định

Việc chú giải cụm từ huấn luyện trong ý định chỉ hỗ trợ loại DateTime. Người dùng đầu vào không cần 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ông số phiên có thể có dạng như sau:

"date_time": {
  "year": 2019
}

Sử dụng với tính năng lấp đầy vị trí

Tính năng điền vị trí hỗ trợ DateTime, Date và Time.

  • Nếu loại ô là DateTime, Trợ lý sẽ nhắc người dùng cho đến khi pin đầy giá trị được cung cấp.
  • Nếu loại ô là Date, Trợ lý sẽ nhắc người dùng cho đến một ngày cụ thể giá trị sẽ được cung cấp. Khi được thu thập, thông số bạn nhận được sẽ là thông số đầy đủ DateTime với thời gian được đặt thành 00:00.
  • Nếu loại ô là Time, Trợ lý sẽ nhắc người dùng cho đến một khoảng thời gian giá trị được cung cấp. Khi được thu thập, thông số bạn nhận được sẽ là thông số đầy đủ Đối tượng DateTime 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 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 dưới dạng một phần của một ô quá trình điền, thông 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 với 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, hãy sử dụng cấp cao nhất Tham số DateTime 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à điều kiện không hợp lệ vì cấp cao nhất "DateTime" đối tượng không phải là một số hay chuỗi.

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

Tính năng 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 vào hoặc thay thế thông số của một loại tại thời gian chạy. Ví dụ: bạn có thể kiểm tra một nguồn dữ liệu phụ trợ để tải trình đơ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 tạo ghi đè loại.