Parametro Suggerimenti

Per migliorare l'accuratezza della post-elaborazione e allinearsi meglio alle intenzioni dell'utente, Smart Formatter supporta ora un nuovo parametro hints. Il parametro hints aiuta a guidare la formattazione indicando il tipo di attributo previsto. Questo parametro consente al formattatore di interpretare e strutturare i dati in modo più efficace, soprattutto quando l'input dell'utente è ambiguo o poco strutturato.

Valori supportati

Il parametro hints supporta i seguenti valori:

Valori supportati per il parametro hints
Suggerimento	Descrizione	Risolve l'ambiguità in	Esempio
`date`	Formatta l'input come data.	Distingue tra espressioni numeriche e riferimenti a date. Ad esempio, un input vocale come `six twenty seven twenty fourteen` può essere interpretato come un numero o una data. Quando viene specificato il suggerimento `date`, viene formattato correttamente come data.	`six twenty seven twenty fourteen` è formattato come `06/27/2014`.
`alphanum`	Formatta l'input come una stringa alfanumerica (lettere e numeri combinati).	In un input audio, quando un altoparlante dice `o`, potrebbe riferirsi alla lettera `o` o alla cifra `0`. Specificando il suggerimento `alphanum`, lo Smart Formatter conserva `o` come lettera invece di convertirla in zero.	`A o 5 B` è formattato come `Ao5B`.

Oltre a date e alphanum, il parametro hints supporta anche i seguenti valori:

number- Interpreta correttamente sequenze numeriche in contesti ambigui.
email- Risolve le ambiguità degli indirizzi e-mail pronunciati.
phonenumber- Distingue i numeri di telefono da altre espressioni numeriche.

Specificando un suggerimento, gli sviluppatori possono migliorare la capacità del formattatore di fornire risultati che corrispondano maggiormente alle aspettative dell'utente. Per ulteriori informazioni sul formattatore intelligente, vedere Formattatore intelligente.

Utilizzo del parametro Suggerimenti

Il parametro hints funziona solo quando la formattazione intelligente è abilitata con la versione 2.0. Per utilizzarlo, includere i seguenti parametri nella richiesta:

smart_formatting=true
smart_formatting_version=2.0

Attualmente, date e alphanum sono i suggerimenti supportati.

Richiesta di esempio:

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"

Risposta di esempio:

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

Attributo rigoroso

L'attributo strict può essere usato insieme a qualsiasi suggerimento per rimuovere il contesto indesiderato o extra dall'output. Aiuta a produrre un risultato più conciso e preciso quando l'input dell'utente contiene parole extra che non sono necessarie nell'output formattato.

Richiesta di esempio:

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"

Ad esempio, se l'input è My Birthday is on June twenty seven two thousand fourteen, l'output con l'attributo date è My Birthday is on 06/27/2014. L'output con entrambi gli attributi date e strict è 06/27/2014. L'attributo strict aiuta a garantire che venga restituito solo il valore formattato essenziale, eliminando il contesto circostante, se presente.

Lingue supportate

Il parametro hints supporta attualmente l'inglese (US) (en-US).