Method: projects.matchIntents

尋找符合特定查詢的意圖。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
project

string

必要欄位。要測試的專案，以專案 ID 表示。格式：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

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

回應尋找相符意圖的回應。

JSON 表示法 
{
  "matchedIntents": [
    {
      object (Intent)
    }
  ]
}
欄位
matchedIntents[]

object (Intent)

意圖比對相符，按關聯性排序 (從高到低)。系統只會傳回前 50 個相符項目。

意願

代表意圖。

JSON 表示法 
{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}
欄位
name

string

必要欄位。最後一個相符意圖的名稱。
params

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

必要欄位。代表識別為意圖比對過程中的參數。這是將已識別參數的名稱對應到使用者輸入內容所識別參數值的對應。已在相符意圖中定義的所有參數會顯示在這裡。

這個物件中包含 "key": value 組合的清單，例如：{ "name": "wrench", "mass": "1.3kg", "count": "3" }.
query

string

選用設定。使用者輸入或說出符合這項意圖的輸入內容。比對符合使用者輸入內容的意圖時，系統就會填入這項資訊。