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

Recurso: CannedQuery

Es el recurso de consulta estándar de Assistant. Representa un acceso directo a un inicio de conversación predefinido.

Representación JSON
{
  "name": string,
  "displayName": string,
  "defaultTexts": {
    object (CannedQueryTexts)
  },
  "localizedTexts": {
    string: {
      object (CannedQueryTexts)
    },
    ...
  },
  "requiredCapabilities": [
    {
      object (AssistantCapability)
    }
  ],
  "enabled": boolean,
  "googleDefined": boolean
}
Campos
name

string

Inmutable. Es el nombre del recurso de la búsqueda predefinida. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}/cannedQueries/{cannedQuery}

Debe ser una cadena codificada en UTF-8 con un límite de 1,024 caracteres.

displayName

string

Es el nombre visible de la consulta predefinida. Debe ser una cadena codificada en UTF-8 con un límite de 128 caracteres.

defaultTexts

object (CannedQueryTexts)

Obligatorio. Son los valores predeterminados (sin localización) para los atributos de texto.

localizedTexts

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

Es opcional. Son las traducciones de los atributos de texto. Las claves deben ser códigos de idioma BCP-47.

requiredCapabilities[]

object (AssistantCapability)

Es opcional. Son las capacidades que debe tener el Asistente para usar esta búsqueda predefinida.

enabled

boolean

Indica si esta búsqueda predefinida está habilitada.

googleDefined

boolean

Solo salida. Indica si se trata de una consulta predefinida de solo lectura definida por Google.

CannedQueryTexts

Son los fragmentos de texto de la búsqueda predeterminada, que se pueden localizar.

Representación JSON
{
  "title": string,
  "prefix": string,
  "suggestedPrompts": [
    {
      object (SuggestedPrompt)
    }
  ]
}
Campos
title

string

Obligatorio. Es el título que se muestra al usuario final.

prefix

string

Es opcional. Es el prefijo con el que debe comenzar suggestedPrompts.

suggestedPrompts[]

object (SuggestedPrompt)

Obligatorio. Son las instrucciones que la consulta predefinida ofrecerá al usuario.

SuggestedPrompt

Es una instrucción sugerida para la búsqueda predefinida.

Representación JSON
{
  "promptText": string
}
Campos
promptText

string

Obligatorio. Es el texto de la instrucción sugerida.

AssistantCapability

Es la capacidad de un asistente que se necesita para usar esta búsqueda predefinida.

Representación JSON
{

  // Union field capability can be only one of the following:
  "actionName": string
  // End of list of possible types for union field capability.
}
Campos
Campo de unión capability. Es la capacidad de un asistente, ya sea una acción o una herramienta. capability puede ser solo uno de los parámetros siguientes:
actionName

string

Es el nombre de la acción que debe configurar Asistente para usar esta consulta predefinida.

Métodos

create

Crea un CannedQuery.

delete

Borra un CannedQuery.

get

Obtienes una CannedQuery.

list

Enumera todos los CannedQuery en un Assistant.

listActiveCannedQueryUserViews

Enumera los CannedQueryUserViews de todos los CannedQuerys activos.

patch

Actualiza un CannedQuery.