Parameter Hinweise

Zur Verbesserung der Nachbearbeitungsgenauigkeit und zur besseren Anpassung an die Benutzerabsicht unterstützt der Smart Formatter jetzt einen neuen Parameter hints. Der Parameter hints hilft bei der Formatierung, indem er den erwarteten Attributtyp angibt. Dieser Parameter ermöglicht es dem Formatierer, Daten effektiver zu interpretieren und zu strukturieren, insbesondere wenn die Benutzereingabe mehrdeutig oder lose strukturiert ist.

Unterstützte Werte

Der Parameter hints unterstützt die folgenden Werte:

Unterstützte Werte für den Parameter hints
Tipp	Beschreibung	Löst Zweideutigkeit auf in	Beispiel
`date`	Formatiert die Eingabe als Datum.	Unterscheidet zwischen numerischen Ausdrücken und Datumsreferenzen. So kann beispielsweise eine gesprochene Eingabe wie `six twenty seven twenty fourteen` entweder als Zahl oder als Datum interpretiert werden. Wenn der Hinweis `date` angegeben wird, wird er korrekt als Datum formatiert.	`six twenty seven twenty fourteen` ist als `06/27/2014` formatiert.
`alphanum`	Formatiert die Eingabe als alphanumerische Zeichenfolge (Buchstaben und Zahlen kombiniert).	Wenn ein Sprecher `o` sagt, kann sich das entweder auf den Buchstaben `o` oder die Ziffer `0` beziehen. Durch Angabe des Hinweises `alphanum` behält der Smart Formatter `o` als Buchstabe bei, anstatt ihn in eine Null umzuwandeln.	`A o 5 B` ist als `Ao5B` formatiert.

Zusätzlich zu den Parametern date und alphanum unterstützt hints auch die folgenden Werte:

number- Interpretiert numerische Sequenzen in mehrdeutigen Zusammenhängen richtig.
email- Behebt Mehrdeutigkeiten in gesprochenen E-Mail-Adressen.
phonenumber- Unterscheidet Rufnummern von anderen numerischen Ausdrücken.

Durch die Angabe eines Hinweises können Entwickler die Fähigkeit des Formatierers verbessern, Ergebnisse zu liefern, die den Erwartungen der Benutzer besser entsprechen. Weitere Informationen zu Smart Formatter finden Sie unter Smart Formatter.

Verwendung des Parameters hints

Der Parameter hints funktioniert nur, wenn Smart Formatting in der Version 2.0 aktiviert ist. Um sie zu verwenden, müssen Sie die folgenden Parameter in Ihre Anfrage aufnehmen:

smart_formatting=true
smart_formatting_version=2.0

Derzeit werden die Hinweise date und alphanum unterstützt.

Beispielanforderung:

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"

Beispielantwort:

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

Strenges Attribut

Das Attribut strict kann zusammen mit einem beliebigen Hinweis verwendet werden, um unerwünschten oder zusätzlichen Kontext aus der Ausgabe zu entfernen. Sie hilft, ein präziseres Ergebnis zu erzielen, wenn die Benutzereingabe zusätzliche Wörter enthält, die in der formatierten Ausgabe nicht benötigt werden.

Beispielanforderung:

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"

Wenn die Eingabe beispielsweise My Birthday is on June twenty seven two thousand fourteen lautet, ist die Ausgabe mit dem Attribut date My Birthday is on 06/27/2014. Die Ausgabe mit den beiden Attributen date und strict lautet 06/27/2014. Das Attribut strict trägt dazu bei, dass nur der wesentliche formatierte Wert zurückgegeben wird, wobei der umgebende Kontext, falls vorhanden, entfernt wird.

Unterstützte Sprachen

Der Parameter hints unterstützt derzeit Englisch (US) (en-US).