Angepasstes Sprachmodell erstellen

Damit Sie eine Grammatik für die Spracherkennung verwenden können, müssen Sie sie zu einem angepassten Sprachmodell hinzufügen. Sie können ein vorhandenes angepasstes Sprachmodell verwenden oder mit der Methode POST /v1/customizations ein neues angepasstes Modell erstellen. Informationen zum Erstellen eines neuen angepassten Modells enthält der Abschnitt Angepasstes Sprachmodell erstellen.

Ein angepasstes Sprachmodell kann Korpora und angepasste Wörter sowie Grammatiken beinhalten. Bei der Spracherkennung können Sie das angepasste Modell mit oder ohne Grammatiken verwenden. Wenn Sie eine Grammatik verwenden, erkennt der Service jedoch nur Wörter aus der angegebenen Grammatik.

Grammatik zu einem angepassten Sprachmodell hinzufügen

Mit der Methode POST /v1/customizations/{customization_id}/grammars/{grammar_name} können Sie eine Grammatikdatei zu einem angepassten Modell hinzufügen.

customization_id (erforderliche Zeichenfolge)

Geben Sie die Anpassungs-ID des benutzerdefinierten Modells an, zu dem die Grammatik hinzugefügt werden soll.

grammar_name (erforderliche Zeichenfolge)

Geben Sie einen Namen für die Grammatik an. Verwenden Sie einen übersetzten Namen in der Sprache des angepassten Modells, der den Inhalt der Grammatik wiedergibt.

• Der Name sollte nicht mehr als 128 Zeichen umfassen.
• Verwenden Sie keine Zeichen, die eine URL-Codierung erforderlich machen. Verwenden Sie beispielsweise keine Leerzeichen, Schrägstriche, umgekehrten Schrägstriche, Doppelpunkte, Et-Zeichen, Anführungszeichen, Pluszeichen, Gleichheitszeichen, Fragezeichen etc. im Namen. (Die Verwendung dieser Zeichen ist im Service nicht unzulässig. Da für sie jedoch stets eine URL-Codierung erforderlich ist, wird von einer Verwendung dieser Zeichen ausdrücklich abgeraten.)
• Verwenden Sie nicht den Namen einer Grammatik oder eines Korpus, die/der bereits zum angepassten Modell hinzugefügt wurde.
• Verwenden Sie nicht den Namen user, der im Service für angepasste Wörter reserviert ist, die vom Benutzer hinzugefügt oder geändert werden.
• Verwenden Sie nicht den Namen base_lm oder default_lm. Beide Namen sind für die zukünftige Verwendung durch den Service reserviert.

Content-Type (erforderliche Zeichenfolge)

Verwenden Sie den Anforderungsheader, um das Format der Grammatik anzugeben:

• application/srgs für eine ABNF-Grammatik
• application/srgs+xml für eine XML-Grammatik

Übergeben Sie die Grammatik-Textdatei als Hauptteil der Anfrage. Im folgenden Beispiel wird die Grammatikdatei mit dem Namen confirm.abnf zum angepassten Modell mit der angegebenen ID hinzugefügt. Im Beispiel wird der Name confirm-abnf für die Grammatik verwendet.

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
--header "Content-Type: application/srgs" \
--data-binary @confirm.abnf \
"{url}/v1/customizations/{customization_id}/grammars/confirm-abnf"

IBM Cloud Pak for Data IBM Software Hub

curl -X POST \
--header "Authorization: Bearer {token}" \
--header "Content-Type: application/srgs" \
--data-binary @confirm.abnf \
"{url}/v1/customizations/{customization_id}/grammars/confirm-abnf"

Die Methode akzeptiert außerdem den optionalen Abfrageparameter allow_overwrite, mit dem eine vorhandene Grammatik desselben Namens überschrieben werden kann. Verwenden Sie den Parameter, wenn Sie eine Grammatik aktualisieren müssen, nachdem Sie sie zu einem Modell hinzugefügt haben.

Diese Methode arbeitet asynchron. Je nach Größe der Grammatik und aktueller Auslastung des Service kann es einige Sekunden oder Minuten dauern, bis der Service die Grammatik analysiert hat. Im Abschnitt Anforderung zum Hinzufügen einer Grammatik überwachen erfahren Sie genauer, wie Sie den Status einer Grammatik überprüfen können.

Sie können beliebig viele Grammatiken zu einem angepassten Modell hinzufügen, indem Sie die Methode für jede Grammatikdatei separat aufrufen. Das Hinzufügen einer Grammatik muss vollständig abgeschlossen sein, bevor Sie eine weitere Grammatik hinzufügen können.

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/customizations/{customization_id}/grammars/confirm-abnf"

curl -X GET \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations/{customization_id}/grammars/confirm-abnf"

{
  "name": "confirm-abnf",
  "out_of_vocabulary_words": 0,
  "status": "being_processed"
}

{
  . . .
  "error": "{\"code\":500, \"code_description\":\"Internal Server Error\",
\". . . Cannot compile grammar . . .\"},
  . . .
}

Wörter in der Grammatik validieren

Wenn Sie eine Grammatikdatei zu einem angepassten Sprachmodell hinzufügen, analysiert der Service die Grammatik und ermittelt, ob die Grammatik Wörter erkennt, die noch nicht zum Grundvokabular des Service gehören. Solche Wörter werden als 'vokabularexterne Wörter' bezeichnet. Der Service fügt vokabularexterne Wörter zur Wörterressource des angepassten Modells hinzu. Zweck der Wörterressource ist das Definieren von Wörtern, die noch nicht im Vokabular des Services enthalten sind.

Die Definitionen in der Wörterressource weisen den Service an, wie die vokabularexternen Wörter zu transkribieren sind. Die Informationen enthalten ein Feld sounds_like, das den Service darüber informiert, wie das Wort ausgesprochen wird, ein Feld display_as, das den Service anweist, wie das Wort angezeigt werden soll, und ein Feld source, das angibt, wie das Wort zum angepassten Modell hinzugefügt wurde. Weitere Informationen zur Wörterressource und zu vokabularexternen Wörtern finden Sie im Abschnitt Wörterressource.

Nachdem Sie eine Grammatik zu einem angepassten Modell hinzugefügt haben, ist es zweckdienlich, die vokabularexternen Wörter in der Wörterressource des Modells zu untersuchen und ihre gleich klingenden Aussprachevarianten zu prüfen. Nicht jede Grammatik enthält vokabularexterne Wörter, aber eine Überprüfung der Wörterressource ist generell sinnvoll. Mit den folgenden Methoden können Sie die Wörter eines angepassten Modells überprüfen, nachdem Sie eine Grammatik hinzugefügt haben:

• Mit der Methode GET /v1/customizations/{customization_id}/words werden alle Wörter aus einem angepassten Modell aufgelistet. Übergeben Sie den Wert grammars im Parameter word_type der Methode, damit nur Wörter aufgelistet werden, die aus Grammatiken hinzugefügt wurden.
• Mit der Methode GET /v1/customizations/{customization_id}/words/{word_name} wird ein einzelnes Wort aus einem Modell angezeigt.

Vergewissern Sie sich, dass die gleich klingenden Aussprachevarianten der Wörter präzise und richtig sind. Suchen Sie auch in den Wörtern selbst nach Schreib- und anderen Fehlern. Weitere Informationen zum Validieren und Korrigieren der Wörter in einem angepassten Modell finden Sie unter Wortressource für Modelle der vorherigen Generation validieren.

Angepasstes Sprachmodell trainieren

Bevor Sie eine Grammatik mit einem angepassten Sprachmodell verwenden können, müssen Sie im letzten Schritt das Modell trainieren. Der erforderliche Prozess ist derselbe wie beim Trainieren eines angepassten Modells mit neuen Korpora oder neuen angepassten Wörtern. Durch das Training wird die Grammatik zur Verwendung bei der Spracherkennung kompiliert. Der Service wandelt die Grammatik bei der Verarbeitung aus ihrem ursprünglichen textbasierten Format in ein binäres Laufzeitformat für die Spracherkennung um. Die Verwendung der Grammatik ist erst nach dem Training des Modells möglich.

Mit der Methode POST /v1/customizations/{customization_id}/train können Sie ein angepasstes Modell trainieren. An die Methode übergeben Sie wie im folgenden Beispiel die Anpassungs-ID des Modells, das Sie trainieren wollen.

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
"{url}/v1/customizations/{customization_id}/train"

IBM Cloud Pak for Data IBM Software Hub

curl -X POST \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations/{customization_id}/train"

Die Methode für das Training wird asynchron ausgeführt. Normalerweise dauert das Training einige Sekunden oder Minuten. Es kann jedoch je nach Größe und Komplexität der Grammatik sowie der aktuellen Auslastung des Service auch mehr Zeit in Anspruch nehmen. Im Abschnitt Anforderung zum Trainieren eines Modells überwachen erfahren Sie, wie Sie den Status einer Trainingsoperation überprüfen können.

{
  "customization_id": "74f4807e-b5ff-4866-824e-6bba1a84fe96",
  "created": "2018-06-01T18:42:25.324Z",
  "language": "en-US",
  "dialect": "en-US",
  "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
  "name": "Example model",
  "description": "Example custom language model",
  "base_model_name": "en-US_BroadbandModel",
  "status": "training",
  "progress": 0
}