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」。格式如下：https://tools.ietf.org/html/bcp47。如要查看支援的語言清單，請前往 https://developers.google.com/assistant/console/languages-locales

回應主體

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

針對發現項目相符的意圖的回應。

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

object (Intent)

意圖相符，依關聯性由高到低排序。系統只會傳回前 50 個相符項目。

Intent

代表意圖。

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

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