REST Resource: projects.locations.collections.engines.assistants.cannedQueries

資源：CannedQuery

Assistant 的罐頭查詢資源。這代表預先定義的對話啟動捷徑。

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "defaultTexts": {
    object (CannedQueryTexts)
  },
  "localizedTexts": {
    string: {
      object (CannedQueryTexts)
    },
    ...
  },
  "requiredCapabilities": [
    {
      object (AssistantCapability)
    }
  ],
  "enabled": boolean,
  "googleDefined": boolean
}
欄位
name

string

不可變更。罐頭查詢的資源名稱，格式：projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/cannedQueries/{cannedQuery}

必須是 UTF-8 編碼的字串，長度上限為 1024 個字元。
displayName

string

罐頭查詢的顯示名稱。必須是 UTF-8 編碼的字串，長度上限為 128 個字元。
defaultTexts

object (CannedQueryTexts)

這是必要旗標，文字屬性的預設 (非本地化) 值。
localizedTexts

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

(選用步驟) 文字屬性的翻譯內容。鍵應為 BCP-47 語言代碼。
requiredCapabilities[]

object (AssistantCapability)

(選用步驟) 助理必須具備哪些功能，才能使用這項預先設定的查詢。
enabled

boolean

罐頭查詢是否已啟用。
googleDefined

boolean

僅供輸出。這是否為 Google 定義的唯讀罐頭查詢。

CannedQueryTexts

罐頭查詢的文字片段，可進行本地化。

JSON 表示法 
{
  "title": string,
  "prefix": string,
  "suggestedPrompts": [
    {
      object (SuggestedPrompt)
    }
  ]
}
欄位
title

string

這是必要旗標，提供給使用者的標題。
prefix

string

(選用步驟) suggestedPrompts 應開頭的前置字串。
suggestedPrompts[]

object (SuggestedPrompt)

這是必要旗標，罐頭查詢會向使用者顯示的提示。

SuggestedPrompt

罐頭查詢的建議提示。

JSON 表示法 
{
  "promptText": string
}
欄位
promptText

string

這是必要旗標，建議提示的文字。

AssistantCapability

使用這項預先建立的查詢時，助理必須具備的能力。

JSON 表示法 
{

  // Union field capability can be only one of the following:
  "actionName": string
  // End of list of possible types for union field capability.
}
欄位
聯集欄位 capability。助理的功能，可以是動作或工具。capability 只能是下列其中一個設定：
actionName

string

助理必須設定的動作名稱，才能使用這項罐頭查詢。

方法

create

 建立 CannedQuery。

delete

 刪除 CannedQuery。

get

 取得 CannedQuery。

list

 列出 Assistant 下的所有 CannedQuery。

listActiveCannedQueryUserViews

 列出所有有效 CannedQuery 的 CannedQueryUserView。

patch

 更新 CannedQuery。