Eingabe- und Ausgabedateischema für den Speaker Enrollment Job in Amazon Connect Voice ID - Amazon Connect
Schema der EingabedateiSchema der Ausgabedatei

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Eingabe- und Ausgabedateischema für den Speaker Enrollment Job in Amazon Connect Voice ID

Schema der Eingabedatei

Im Folgenden finden Sie das Schema der Eingabemanifestdatei für den Speaker Enrollment Job:

{
  "Version": "string",
  "SpeakerEnrollmentRequests": [
      {
          "RequestId": "string",
          "SpeakerId": "string",
          "AudioSpecifications": [
              {
                  "S3Uri": "string",
                  "ChannelId": number 
              }
           ] 
      }
   ]
}
Anmerkung

Alle Felder im Schema sind Pflichtfelder.

Im Folgenden finden Sie eine Beschreibung der einzelnen Attribute des Eingabeschemas.

  • Version: Die Version des Eingabeschemadokuments. Derzeit sollte es 1.0 sein.

  • SpeakerEnrollmentRequests: Liste der Anfragen zur Registrierung von Sprechern, die im Rahmen des Jobs erfüllt werden müssen.

    • RequestId: Eine Kennung für diese Anfrage zur Registrierung von Sprechern. Es muss innerhalb der Eingabedatei eindeutig sein. Es wird für die Zuordnung und Identifizierung von Einträgen in der Ausgabedatei verwendet.

    • SpeakerId: Die vom Kunden bereitgestellte Kennung des Sprechers, der angemeldet werden muss. Sie müssen das CustomerSpeakerId in diesem Feld eingeben. GeneratedSpeakerId wird derzeit nicht unterstützt.

    • AudioSpecifications: Die Liste der Audiodateien, die Sprach-ID für die Registrierung dieses Sprechers verwenden kann. Sprach-ID verwendet diese Audiodateien zusammen, um die für die Registrierung erforderliche Sprachmenge zu sammeln. Derzeit sind maximal 10 Audiodateien für eine Registrierungsanfrage zulässig. Bei jeder Datei kann es sich um eine WAV-Datei mit einer Größe von bis zu 20 MB handeln, die Audio mit einer KHz Samplerate von 8 und einer Kodierung von -16 enthält. PCM

      • S3URI: Der Amazon-S3-Speicherort der Audiodatei im WAV-Format, die für die Registrierung des Sprechers verwendet werden muss.

      • ChannelId: Der Audiokanal, der für die Registrierung des Sprechers in eine Mehrkanal-Audiodatei verwendet werden soll. Sprach-ID unterstützt Audiodateien mit bis zu zwei Kanälen, daher ist dieser Wert auf 0 oder 1 beschränkt.

Schema der Ausgabedatei

Im Folgenden finden Sie das Schema der Ausgabedatei, die für den Speaker Enrollment Job generiert wurde:

{
  "Version": "string",
  "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulEnrollments": [
       {
          "RequestId": "string",
          "GeneratedSpeakerId": "string",
          "CustomerSpeakerId": "string",
          "EnrollmentStatus": "DUPLICATE_SKIPPED" | "NEW_ENROLLMENT" | "ENROLLMENT_OVERWRITE"
       }
   ]   
}

Es folgt eine Beschreibung der einzelnen Attribute des Ausgabeschemas.

  • Version: Die Version des Ausgabeschemadokuments. Derzeit sollte es 1.0 sein.

  • Errors: Die Liste der Fehler für die Anfragen zur Registrierung von Sprechern, die zu einem bestimmten Zeitpunkt während der Registrierung fehlgeschlagen sind.

    • RequestId: Die mit dieser Anfrage verbundene Anfragekennung. Dies entspricht der RequestId in der Eingabedatei für diese Anfrage.

    • ErrorCode: Der HTTP Fehlercode, der die Art des Fehlers darstellt. Im Folgenden werden einige Beispielfehlerszenarien beschrieben.

      Anmerkung

      Dies ist keine vollständige Liste.

      • 400 (Bad Request Exception):

        • Die JSON Eingabedatei ist falsch formatiert und kann nicht analysiert werden.

        • Die bereitgestellten Audiodateien verfügen nicht über ausreichend Sprachkenntnisse für die Registrierung.

        • Die Überprüfung der Betrugsversuche für den angegebenen Sprecher ist fehlgeschlagen.

      • 402 ()ServiceQuotaLimitExceededException:

        • Die Lautsprecherbegrenzung wurde überschritten.

      • 409 (Konfliktausnahme):

        • Widersprüchliche Aktion: Sie können keine Registrierung für einen Sprecher beantragen, für den Sie sich abmelden möchten.

      • 500 (Interner Fehler):

        • Interner Serverfehler (Unerwarteter Fehler auf der Serviceseite).

    • ErrorMessage: Eine Meldung, in der die Ursache des Registrierungsfehlers beschrieben wird.

  • SuccessfulEnrollments: Die Liste der Registrierungsanfragen, die erfolgreich waren.

    • RequestId: Die mit dieser Anfrage verbundene Anfragekennung. Dies entspricht der RequestId in der Eingabedatei für diese Anfrage.

    • CustomerSpeakerId: Die vom Kunden bereitgestellte Kennung für den Sprecher, der angemeldet war.

    • GeneratedSpeakerId: Die vom Dienst generierte Kennung für den Sprecher, der angemeldet war.

    • EnrollmentStatus: Der Status der erfolgreichen Rednerregistrierung

      • DUPLICATE_SKIPPED: Der Sprecher ist bereits angemeldet und die Registrierung wurde übersprungen.

      • NEW_ENROLLMENT: Der Sprecher wurde neu im System registriert.

      • ENROLLMENT_OVERWRITE: Der Sprecher ist bereits registriert, wurde aber mit dem neuen Audio erneut registriert/überschrieben.