Method: projects.matchIntents

Tìm ý định phù hợp với một truy vấn nhất định.

Yêu cầu HTTP

POST https://actions.googleapis.com/v2/{project=projects/*}:matchIntents

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
project

string

Bắt buộc. Dự án đang được kiểm thử, được biểu thị bằng Mã dự án. Định dạng: project/{project}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "query": string,
  "locale": string
}
Các trường
query

string

Bắt buộc. Cụm từ tìm kiếm của người dùng dưới dạng văn bản thuần tuý.

locale

string

Bắt buộc. Ngôn ngữ dùng để đánh giá truy vấn, chẳng hạn như "en". Định dạng phải tuân theo BCP 47: https://tools.ietf.org/html/bcp47 Xem danh sách ngôn ngữ được hỗ trợ tại https://developers.google.com/assistant/console/languages-locales

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Phản hồi để tìm ý định phù hợp.

Biểu diễn dưới dạng JSON
{
  "matchedIntents": [
    {
      object (Intent)
    }
  ]
}
Các trường
matchedIntents[]

object (Intent)

Các ý định đã khớp, được sắp xếp theo thứ tự từ liên quan nhiều nhất đến ít liên quan nhất. Chỉ có 50 kết quả trùng khớp đầu tiên được trả về.

Intent

Đại diện cho một ý định.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
Các trường
name

string

Bắt buộc. Tên của ý định so khớp gần đây nhất.

params

map (key: string, value: object (IntentParameterValue))

Bắt buộc. Biểu thị các tham số được xác định trong quá trình so khớp ý định. Đây là liên kết tên của thông số đã xác định với giá trị của tham số được xác định từ hoạt động đầu vào của người dùng. Tất cả thông số được xác định trong ý định phù hợp đã được xác định sẽ xuất hiện tại đây.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

query

string

Không bắt buộc. Thông tin nhập bằng giọng nói hoặc nhập bằng giọng nói của người dùng cuối khớp với ý định này. Giá trị này sẽ được điền sẵn khi so khớp một ý định, dựa trên hoạt động đầu vào của người dùng.