REST Resource: projects.locations.phraseSets

Recurso: PhraseSet

São fornecidas "dicas" ao reconhecedor de fala para aceitar palavras e frases específicas nos resultados.

Representação 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

O nome do recurso do conjunto de frases.
phrases[]

object (Phrase)

Uma lista de palavras e frases.
boost

number

Dica extra. Um valor positivo aumenta a probabilidade de uma frase específica ser reconhecida em vez de outras semelhantes. Quanto maior o aumento, maior a chance de reconhecimento de falsos positivos. Valores de reforço negativo corresponderiam à redução de viés. O anti-biasing não está ativado, então o aumento negativo será ignorado. Embora boost possa aceitar uma ampla variedade de valores positivos, a maioria dos casos de uso é melhor atendida com valores entre 0 (exclusivo) e 20. Recomendamos usar uma abordagem de pesquisa binária para encontrar o valor ideal para seu caso de uso, além de adicionar frases com e sem reforço às suas solicitações.
kmsKeyName

string

Apenas saída. O nome da chave do KMS com que o conteúdo do PhraseSet é criptografado. O formato esperado é projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.
kmsKeyVersionName

string

Apenas saída. O nome da versão da chave do KMS com que o conteúdo do PhraseSet é criptografado. O formato esperado é projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.
uid

string

Apenas saída. Identificador exclusivo atribuído pelo sistema para o PhraseSet. Esse campo não é usado.
displayName

string

Apenas saída. Nome legível para humanos e definido pelo usuário do PhraseSet. Precisa ter no máximo 63 caracteres. Esse campo não é usado.
state

enum (State)

Apenas saída. O estado do ciclo de vida de CustomClass. Esse campo não é usado.
deleteTime

string (Timestamp format)

Apenas saída. O horário em que a exclusão deste recurso foi solicitada. Esse campo não é usado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Apenas saída. O horário em que esse recurso será excluído permanentemente. Esse campo não é usado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
annotations

map (key: string, value: string)

Apenas saída. Permite que os usuários armazenem pequenas quantidades de dados arbitrários. A chave e o valor precisam ter no máximo 63 caracteres cada. No máximo 100 anotações. Esse campo não é usado.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag

string

Apenas saída. Esse checksum é calculado pelo servidor com base no valor de outros campos. Ele pode ser enviado em solicitações de atualização, reversão de exclusão e exclusão para garantir que o cliente tenha um valor atualizado antes de prosseguir. Esse campo não é usado.
reconciling

boolean

Apenas saída. Indica se o PhraseSet está sendo atualizado. Esse campo não é usado.

Frase

Uma lista de frases contendo "dicas" de palavras e frases para que o reconhecimento de fala seja mais provável. Isso pode ser usado para melhorar a precisão de palavras e frases específicas, por exemplo, se comandos específicos forem normalmente falados pelo usuário. Isso também pode ser usado para adicionar palavras ao vocabulário do reconhecedor. Veja os limites de uso.

Os itens de lista também podem incluir classes pré-criadas ou personalizadas com grupos de palavras que representam conceitos comuns que ocorrem em linguagem natural. Por exemplo, em vez de fornecer uma dica de frase para cada mês do ano (por exemplo, "eu nasci em janeiro", "eu nasci em fevereiro" etc.), use a classe $MONTH pré-criada para aumentar a probabilidade de transcrever corretamente o áudio que inclui meses (por exemplo, "eu nasci em $month"). Para se referir a classes pré-criadas, use o símbolo da classe precedido por $, por exemplo, $MONTH. Para se referir a classes personalizadas definidas inline na solicitação, defina o customClassId da classe como uma string exclusiva para todos os recursos de classe e classes inline. Em seguida, use o ID da classe envolvido em ${...}, por exemplo, "${my-months}". Para se referir a recursos de classes personalizadas, use o ID da classe entre ${} (por exemplo, ${my-months}).

A Speech-to-Text oferece suporte a três locais: global, us (América do Norte dos EUA) e eu (Europa). Se você estiver chamando o endpoint speech.googleapis.com, use o local global. Para especificar uma região, use um endpoint regional com o valor de local us ou eu correspondente.

Representação JSON 
{
  "value": string,
  "boost": number
}
Campos
value

string

A própria frase.
boost

number

Dica extra. Substitui o aumento definido no nível do conjunto de frases. Um valor positivo aumenta a probabilidade de uma frase específica ser reconhecida em vez de outras semelhantes. Quanto maior o aumento, maior a chance de reconhecimento de falsos positivos. O reforço negativo será ignorado. Embora boost possa aceitar uma ampla variedade de valores positivos, a maioria dos casos de uso é melhor atendida com valores entre 0 e 20. Recomendamos usar uma abordagem de pesquisa binária para encontrar o valor ideal para seu caso de uso, além de adicionar frases com e sem reforço às suas solicitações.

Estado

Conjunto de estados que definem o ciclo de vida de uma CustomClass.

Tipos enumerados
STATE_UNSPECIFIED Estado não especificado. Isso só é usado/útil para distinguir valores não definidos.
ACTIVE O estado normal e ativo.
DELETED Esta CustomClass foi excluída.

Métodos

create

 Crie um conjunto de dicas de frases.

delete

 Exclui um conjunto de frases.

get

 Recebe um conjunto de frases.

list

 Listar conjuntos de frases.

patch

 Atualiza um conjunto de frases.