REST Resource: projects.locations.phraseSets

Recurso: PhraseSet

Proporciona "sugerencias" al reconocedor de voz para favorecer palabras y frases específicas en los resultados.

Representación JSON
{
  "name": string,
  "phrases": [
    {
      object (Phrase)
    }
  ],
  "boost": number,
  "kmsKeyName": string,
  "kmsKeyVersionName": string,
  "uid": string,
  "displayName": string,
  "state": enum (State),
  "deleteTime": string,
  "expireTime": string,
  "annotations": {
    string: string,
    ...
  },
  "etag": string,
  "reconciling": boolean
}
Campos
name

string

Nombre de recurso del conjunto de frases.

phrases[]

object (Phrase)

Una lista de palabras y frases.

boost

number

Pista. Un valor positivo aumentará la probabilidad de que se reconozca una frase específica en lugar de otras frases que suenen de forma similar. Cuanto mayor sea el aumento, mayor será la probabilidad de que se produzcan falsos positivos. Los valores de impulso negativos se corresponderían con la eliminación de sesgos. El ajuste para evitar sesgos no está habilitado, por lo que el aumento negativo se ignorará. Aunque boost puede aceptar una amplia gama de valores positivos, la mayoría de los casos prácticos se adaptan mejor a valores comprendidos entre 0 (excluido) y 20. Te recomendamos que uses una búsqueda binaria para encontrar el valor óptimo de tu caso práctico, así como que añadas frases con y sin refuerzo a tus solicitudes.

kmsKeyName

string

Solo de salida. El nombre de la clave de KMS con la que se cifra el contenido de PhraseSet. El formato esperado es projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.

kmsKeyVersionName

string

Solo de salida. El nombre de la versión de la clave de KMS con la que se cifra el contenido de PhraseSet. El formato esperado es projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.

uid

string

Solo de salida. Identificador único asignado por el sistema al objeto PhraseSet. Este campo no se usa.

displayName

string

Solo de salida. Nombre legible por humanos que puede definir el usuario para el PhraseSet. Debe tener 63 caracteres como máximo. Este campo no se usa.

state

enum (State)

Solo de salida. El estado del ciclo de vida de CustomClass. Este campo no se usa.

deleteTime

string (Timestamp format)

Solo de salida. Hora a la que se solicitó la eliminación de este recurso. Este campo no se usa.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

expireTime

string (Timestamp format)

Solo de salida. La hora a la que se purgará este recurso. Este campo no se usa.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

annotations

map (key: string, value: string)

Solo de salida. Permite a los usuarios almacenar pequeñas cantidades de datos arbitrarios. Tanto la clave como el valor deben tener 63 caracteres como máximo. Un máximo de 100 anotaciones. Este campo no se usa.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

etag

string

Solo de salida. El servidor calcula esta suma de comprobación en función del valor de otros campos. Puede enviarse en solicitudes de actualización, restauración y eliminación para asegurarse de que el cliente tenga un valor actualizado antes de continuar. Este campo no se usa.

reconciling

boolean

Solo de salida. Indica si este PhraseSet se está actualizando o no. Este campo no se usa.

Frase

Frases que contengan palabras y frases "sugerencias" para que el reconocimiento de voz tenga más probabilidades de reconocerlas. Esto se puede utilizar para mejorar la precisión de palabras y frases específicas, por ejemplo, si el usuario suele pronunciar comandos específicos. Esto también se puede usar para agregar palabras adicionales al vocabulario del reconocedor. Consulta los límites de uso.

Los elementos de lista también pueden incluir clases predefinidas o personalizadas que contengan grupos de palabras que representen conceptos comunes que se dan en el lenguaje natural. Por ejemplo, en lugar de proporcionar una sugerencia de frase para cada mes del año (por ejemplo, "i was born in january", "i was born in february", etc.), usar la clase $MONTH precompilada aumenta la probabilidad de transcribir correctamente el audio que incluye meses (por ejemplo, "i was born in $month"). Para hacer referencia a clases precompiladas, usa el símbolo de la clase precedido por $, por ejemplo, $MONTH. Para hacer referencia a las clases personalizadas que se han definido de forma insertada en la solicitud, asigna a customClassId de la clase una cadena única para todos los recursos de clase y las clases insertadas. A continuación, usa el ID de la clase entre ${...}, por ejemplo, "${my-months}". Para hacer referencia a recursos de clases personalizadas, usa el ID de la clase entre ${} (por ejemplo, ${my-months}).

Speech-to-Text admite tres ubicaciones: global, us (Norteamérica) y eu (Europa). Si llamas al endpoint speech.googleapis.com, usa la ubicación global. Para especificar una región, usa un endpoint regional con el valor de ubicación us o eu correspondiente.

Representación JSON
{
  "value": string,
  "boost": number
}
Campos
value

string

La frase en sí.

boost

number

Pista. Anula el refuerzo definido a nivel de conjunto de frases. Un valor positivo aumentará la probabilidad de que se reconozca una frase específica en lugar de otras frases que suenen de forma similar. Cuanto mayor sea el aumento, mayor será la probabilidad de que se produzcan falsos positivos. El aumento negativo se ignorará. Aunque boost puede aceptar una amplia gama de valores positivos, la mayoría de los casos prácticos se adaptan mejor a valores entre 0 y 20. Te recomendamos que uses una búsqueda binaria para encontrar el valor óptimo de tu caso práctico, así como que añadas frases con y sin refuerzo a tus solicitudes.

Estado

Conjunto de estados que definen el ciclo de vida de un CustomClass.

Enumeraciones
STATE_UNSPECIFIED Estado sin especificar. Solo se usa o es útil para distinguir los valores no definidos.
ACTIVE El estado normal y el estado activo.
DELETED Se ha eliminado este CustomClass.

Métodos

create

Crea un conjunto de sugerencias de frases.

delete

Elimina un conjunto de frases.

get

Obtener un conjunto de frases.

list

Lista de conjuntos de frases.

patch

Actualizar un conjunto de frases.