Parámetro Sugerencias

Para mejorar la precisión del posprocesamiento y ajustarse mejor a la intención del usuario, el formateador inteligente admite ahora un nuevo parámetro hints. El parámetro hints ayuda a guiar el formato indicando el tipo de atributo esperado. Este parámetro permite al formateador interpretar y estructurar los datos de forma más eficaz, especialmente cuando la entrada del usuario es ambigua o está poco estructurada.

Valores soportados

El parámetro hints admite los siguientes valores:

Valores admitidos para el parámetro hints
Sugerencia	Descripción	Resuelve la ambigüedad en	Ejemplo
`date`	Formatea la entrada como una fecha.	Diferencia entre expresiones numéricas y referencias de fecha. Por ejemplo, una entrada hablada como `six twenty seven twenty fourteen` puede interpretarse como un número o una fecha. Cuando se especifica la sugerencia `date`, se formatea correctamente como una fecha.	`six twenty seven twenty fourteen` tiene el formato `06/27/2014`.
`alphanum`	Formatea la entrada como una cadena alfanumérica (letras y números combinados).	En una entrada de audio, cuando un locutor dice `o`, puede referirse tanto a la letra `o` como al dígito `0`. Al especificar la sugerencia `alphanum`, el formateador inteligente conserva `o` como letra en lugar de convertirla a cero.	`A o 5 B` tiene el formato `Ao5B`.

Además de date y alphanum, el parámetro hints también admite los siguientes valores:

number- Interpreta correctamente secuencias numéricas en contextos ambiguos.
email- Resuelve ambigüedades en las direcciones de correo electrónico habladas.
phonenumber- Distingue los números de teléfono de otras expresiones numéricas.

Al especificar una sugerencia, los desarrolladores pueden mejorar la capacidad del formateador para ofrecer resultados que se ajusten más a las expectativas del usuario. Para obtener más información sobre el formateador inteligente, consulte Formateador inteligente.

Utilización del parámetro hints

El parámetro hints sólo funciona cuando está activado el formato inteligente con la versión 2.0. Para utilizarlo, incluya los siguientes parámetros en su solicitud:

smart_formatting=true
smart_formatting_version=2.0

Actualmente, date y alphanum son las sugerencias admitidas.

Solicitud de ejemplo:

curl -X POST -u "apikey:<apikey>"
-H "Content-Type: audio/wav"
--data-binary @{path}New_Recording.wav  
"{URL}/v1/recognize?model=en-US&hints=date&smart_formatting=true&smart_formatting_version=2.0"

Respuesta de ejemplo:

text msg received %s {
   "result_index": 0,
   "results": [
      {
         "final": true,
         "alternatives": [
            {
               "transcript": "9/9/88 ",
               "confidence": 0.93
            }
         ]
      }
   ]
}

Atributo estricto

El atributo strict puede utilizarse junto con cualquier sugerencia para eliminar el contexto no deseado o adicional de la salida. Ayuda a producir un resultado más conciso y preciso cuando la entrada del usuario contiene palabras adicionales que no son necesarias en la salida formateada.

Solicitud de ejemplo:

curl -X POST -u "apikey:<apikey>"  
-H "Content-Type: audio/wav"  
--data-binary @{path}New_Recording.wav  
"{URL}/v1/recognize?model=en-US&hints=date,strict&smart_formatting=true&smart_formatting_version=2.0"

Por ejemplo, si la entrada es My Birthday is on June twenty seven two thousand fourteen, la salida con el atributo date es My Birthday is on 06/27/2014. La salida con los atributos date y strict es 06/27/2014. El atributo strict ayuda a garantizar que sólo se devuelve el valor formateado esencial, eliminando el contexto circundante si está presente.

Idiomas soportados

El parámetro hints admite actualmente el inglés (US) (en-US).