Angepasste Sprachmodelle auflisten

Die Anpassungsschnittstelle bietet zwei Methoden zum Auflisten von Informationen zu den angepassten Sprachmodellen, deren Eigner die angegebenen Berechtigungsnachweise sind:

• Die Methode GET /v1/customizations listet Informationen zu allen angepassten Sprachmodellen auf oder, wenn Sie den Parameter language angeben, zu allen angepassten Sprachmodellen für die angegebene Sprache. Wenn Sie eine Sprache angeben, verwenden Sie die Sprachenkennung aus dem Namen des Basismodells (z. B. en-US für ein Modell in amerikanischem Englisch).
• Die Methode GET /v1/customizations/{customization_id} listet Informationen zu einem angegebenen angepassten Sprachmodell auf. Verwenden Sie diese Methode, um im Service den Status einer Trainingsanforderung oder einer Anforderung zum Hinzufügen neuer Wörter abzufragen.

Beide Methoden geben die folgenden Informationen zu einem angepassten Modell zurück:

• customization_id gibt die GUID (Globally Unique Identifier) des angepassten Modells zurück. Die GUID dient zum Identifizieren des Modells in den Methoden der Schnittstelle.
• created gibt das Datum und die Uhrzeit für die Erstellung des angepassten Modells in koordinierter Weltzeit (UTC) an.
• updated gibt das Datum und die Uhrzeit für die letzte Änderung des angepassten Modells in koordinierter Weltzeit (UTC) an.
• language ist die Sprache des angepassten Modells. Der Wert entspricht der Sprachenkennung aus dem Namen des Basismodells. Beispiel: en-US für ein Sprachmodell in amerikanischem Englisch.
• dialect ist der Sprachdialekt für das angepasste Modell, der bei spanischen Modellen der vorherigen Generation möglicherweise nicht mit der Sprache des angepassten Modells übereinstimmt. Weitere Informationen finden Sie in der Beschreibung des Felds dialect in Angepasstes Sprachmodell erstellen.
• owner gibt die Berechtigungsnachweise der Serviceinstanz an, die Eigner des angepassten Modells ist.
• name ist der Name des angepassten Modells.
• description ist eine Beschreibung des angepassten Modells, sofern beim Erstellen des Modells eine Beschreibung angegeben wurde.
• base_model gibt den Namen des Sprachmodells an, für das das angepasste Modell erstellt wurde.
• versions stellt eine Liste der verfügbaren Versionen des angepassten Modells zur Verfügung. Jedes Element in dem Array gibt eine Version des Basismodells an, mit der das angepasste Modell verwendet werden kann. Mehrere Versionen können vorhanden sein, wenn für das angepasste Modell ein Upgrade auf eine neue Version des Basismodells durchgeführt wird. Andernfalls wird nur eine einzige Version angezeigt. Weitere Informationen finden Sie im Abschnitt Versionsinformationen für ein angepasstes Modell auflisten.

Die Methode gibt außerdem ein Feld status zurück, das den Status des angepassten Modells angibt.

• pending gibt an, dass das Modell erstellt wurde. Sie wartet darauf, dass gültige Trainingsdaten (Korpora, Wörter oder Grammatiken) hinzugefügt werden oder dass der Service die Analyse der hinzugefügten Daten beendet.
• ready gibt an, dass das Modell gültige Daten enthält und jetzt für das Training bereit ist. Wenn das Modell eine Mischung aus gültigen und ungültigen Ressourcen enthält, schlägt das Training des Modells fehl, falls Sie den Abfrageparameter strict nicht auf false gesetzt haben. Weitere Informationen finden Sie im Abschnitt Fehler bei Training.
• training gibt an, dass das Modell momentan mit Daten trainiert wird.
• available gibt an, dass das Modell trainiert wurde und nun in einer Erkennungsanforderung verwendet werden kann.
• upgrading gibt an, dass das Modell momentan aktualisiert wird.
• failed: Das Training des Modells ist fehlgeschlagen. Prüfen Sie die Wörter in der Wörterressource des Modells auf Fehler, die das Trainieren des Modells verhindern.

Darüber hinaus enthält die Ausgabe ein Feld progress, das den Status des Trainings eines angepassten Modells angibt. Wenn Sie das Modell mit der Methode POST /v1/customizations/{customization_id}/train erfolgreich trainiert haben, hat dieses Feld den Wert 100. Wenn das Modell nicht vollständig trainiert wurde und available ist, hat das Feld den Wert 0.

Wenn Sie die Schulung oder Aktualisierung eines benutzerdefinierten Modells überwachen, fragen Sie den Wert des Feldes status ab, nicht den Wert des Feldes progress. Wenn der Vorgang aus irgendeinem Grund fehlschlägt, ändert sich der Wert des Feldes status entsprechend; der Wert des Feldes progress bleibt 0.

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/customizations?language=en-US"

curl -X GET \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations?language=en-US"

{
  "customizations": [
    {
      "customization_id": "74f4807e-b5ff-4866-824e-6bba1a84fe96",
      "created": "2016-06-01T14:21:26.894Z",
      "updated": "2020-01-18T18:42:25.324Z",
      "language": "en-US",
      "dialect": "en-US",
      "versions": [
        "en-US_BroadbandModel.v2018-07-31",
        "en-US_BroadbandModel.v2020-01-16"
      ],
      "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
      "name": "Example model",
      "description": "Example custom language model",
      "base_model_name": "en-US_BroadbandModel",
      "status": "pending",
      "progress": 0
    },
    {
      "customization_id": "8391f918-3b76-e109-763c-b7732fae4829",
      "created": "2017-12-02T18:51:37.291Z",
      "updated": "2017-12-02T20:02:10.624Z",
      "language": "en-US",
      "dialect": "en-US",
      "versions": [
        "en-US_BroadbandModel.v2017-11-15"
      ],
      "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
      "name": "Example model two",
      "description": "Example custom language model two",
      "base_model_name": "en-US_BroadbandModel",
      "status": "available",
      "progress": 100
    }
  ]
}

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

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

{
  "customization_id": "74f4807e-b5ff-4866-824e-6bba1a84fe96",
  "created": "2016-06-01T14:21:26.894Z",
  "updated": "2020-01-18T18:42:25.324Z",
  "language": "en-US",
  "dialect": "en-US",
  "versions": [
    "en-US_BroadbandModel.v2018-07-31",
    "en-US_BroadbandModel.v2020-01-16"
  ],
  "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
  "name": "Example model",
  "description": "Example custom language model",
  "base_model_name": "en-US_BroadbandModel",
  "status": "pending",
  "progress": 0
}

Angepasstes Sprachmodell zurücksetzen

Mit der Methode POST /v1/customizations/{customization_id}/reset können Sie ein angepasstes Modell zurücksetzen. Beim Zurücksetzen eines Modells werden alle Korpora und Wörter aus dem Modell entfernt, d. h. das Modell wird auf den ursprünglichen Erstellungsstatus zurückgesetzt. Die Methode löscht weder das Modell noch die zugehörigen Metadaten wie Name und Sprache. Nach dem Zurücksetzen des Modells ist die zugehörige Wörterressource leer und muss erneut erstellt werden (durch Hinzufügen von Korpora und Wörtern).

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

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

Angepasstes Sprachmodell löschen

Mit der Methode DELETE /v1/customizations/{customization_id} können Sie ein angepasstes Sprachmodell löschen, das nicht mehr benötigt wird. Diese Methode löscht alle Korpora und Wörter, die dem angepassten Modell zugeordnet sind, sowie das Modell selbst. Verwenden Sie diese Methode mit Vorsicht: Nach dem Löschen können Sie das angepasste Modell und die zugehörigen Daten nicht wiederherstellen.

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

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