Method: projects.matchIntents

ค้นหา Intent ที่ตรงกับคำค้นหาที่ระบุ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
project

string

ต้องระบุ โปรเจ็กต์ที่กำลังทดสอบ ซึ่งระบุด้วยรหัสโปรเจ็กต์ รูปแบบ: projects/{project}

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "query": string,
  "locale": string
}
ช่อง
query

string

ต้องระบุ การค้นหาของผู้ใช้ในรูปแบบข้อความธรรมดา
locale

string

ต้องระบุ ภาษาที่จะใช้ประเมินข้อความค้นหา เช่น "en" โดยรูปแบบควรเป็นไปตาม BCP 47 https://tools.ietf.org/html/bcp47 ดูรายการภาษาที่รองรับได้ใน https://developers.google.com/assistant/console/languages-locales

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การตอบสนองสำหรับการค้นหา Intent ที่ตรงกัน

การแสดง JSON 
{
  "matchedIntents": [
    {
      object (Intent)
    }
  ]
}
ช่อง
matchedIntents[]

object (Intent)

Intent ตรงกัน โดยเรียงลำดับจากมากไปน้อยที่เกี่ยวข้อง ระบบจะส่งคืนเฉพาะ 50 รายการแรกเท่านั้น

ความตั้งใจ

หมายถึงความตั้งใจ

การแสดง JSON 
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
ช่อง
name

string

ต้องระบุ ชื่อของความตั้งใจที่ตรงกันล่าสุด
params

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

ต้องระบุ แสดงพารามิเตอร์ที่ระบุว่าเป็นส่วนหนึ่งของการจับคู่ Intent นี่คือการแมปชื่อของพารามิเตอร์ที่ระบุกับค่าของพารามิเตอร์ที่ระบุจากข้อมูลที่ผู้ใช้ป้อน พารามิเตอร์ทั้งหมดที่กำหนดไว้ใน Intent ที่ตรงกันซึ่งมีการระบุจะแสดงที่นี่

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
query

string

ไม่บังคับ ข้อมูลที่พิมพ์หรือพูดจากผู้ใช้ปลายทางที่ตรงกับความตั้งใจนี้ ข้อมูลนี้จะป้อนข้อมูลเมื่อความตั้งใจตรงกัน โดยอิงจากข้อมูลที่ผู้ใช้ป้อน