Method: projects.matchIntents

Tìm những ý định khớp với một cụm từ tìm kiếm 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

Tham số
project

string

Bắt buộc. Dự án đang được thử nghiệm, được biểu thị bằng Mã dự án. Định dạng: dự án/{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
}
Trường
query

string

Bắt buộc. Truy vấn 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ữ cần sử 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ợ bằng 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)
    }
  ]
}
Trường
matchedIntents[]

object (Intent)

Số ý định đã so khớp, được sắp xếp theo mức độ liên quan từ nhiều nhất đến ít liên quan nhất. Chỉ 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
}
Trường
name

string

Bắt buộc. Tên của ý định được 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à sơ đồ liên kết tên của thông số đã xác định với giá trị của thông số đã xác định từ hoạt động đầu vào của người dùng. Tất cả các thông số được xác định trong ý định phù hợp đã xác định được 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 từ người dùng cuối khớp với ý định này. Mã này sẽ được điền sẵn khi một ý định được so khớp, dựa trên hoạt động đầu vào của người dùng.