本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon Connect Voice ID 中詐騙者註冊任務的輸入和輸出檔案結構描述
<a name="fraudster-registration-schema"></a>

**注意**  
支援結束通知：2026 年 5 月 20 日， AWS 將結束對 Amazon Connect Voice ID 的支援。2026 年 5 月 20 日之後，您將無法再存取 Amazon Connect 主控台上的語音 ID、管理員網站或聯絡控制面板上的語音 ID Connect Customer 功能，或存取語音 ID 資源。如需詳細資訊，請造訪 [Amazon Connect Voice ID 終止支援](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)。

## 輸入檔案結構描述
<a name="fraudster-registration-input-schema"></a>

以下是詐騙者註冊工作的輸入清單檔案的結構描述：

```
{
 "Version": "string",
    "FraudsterRegistrationRequests": [
       {
           "RequestId": "string",
           "AudioSpecifications": [
               {
                   "S3Uri": "string",
                   "ChannelId": number 
               }
           ] 
       }
    ]
}
```

**注意**  
結構描述中的所有欄位都是**必要的**。

以下是輸入結構描述的每個屬性的說明。
+ `Version`：結構描述文件的版本。目前，此項目應為 `1.0`。
+ `FraudsterRegistrationRequests`：作為工作一部分要履行的詐騙者註冊請求清單。
  + `RequestId`：此詐騙者註冊請求的識別碼。在輸入檔案內，此項目必須是唯一的。它用於映射和識別輸出檔案中的項目。
  + `AudioSpecifications`：語音 ID 可用於註冊此詐騙者的音訊檔案清單。語音 ID 會將這些音訊檔案一起使用，以收集註冊所需的語音數量。目前，註冊請求允許的音訊檔案數量上限為 **10** 個。每個檔案可以是高達 20 MB 的 .wav 檔案，包含具有 8 kHz 採樣率和 PCM-16 編碼的音訊。
    + `S3URI`：需要用於註冊詐騙者的 .wav 格式音訊檔案的 Amazon S3 位置。
    + `ChannelId`：用於在多頻道音訊檔案中註冊詐騙者的音訊頻道。語音 ID 支援最多兩個頻道的音訊檔案，因此此值限制為 **0** 或 **1**。

## 輸入檔案結構描述
<a name="fraudster-registration-output-schema"></a>

以下是詐騙者註冊工作的輸出清單檔案的結構描述：

```
{
 "Version": "string",
   "Errors": [
       {
          "RequestId": "string",
          "ErrorCode": number,
          "ErrorMessage": "string"
       }
   ],
   "SuccessfulRegistrations": [
       {
          "RequestId": "string", 
          "GeneratedFraudsterId": "string", 
          "RegistrationStatus": "DUPLICATE_SKIPPED" | "NEW_REGISTRATION",
          "FraudsterSimilarityScore": number
       }
   ]   
}
```

以下是輸出結構描述的每個屬性的說明。
+ `Version`：輸出結構描述文件的版本。目前，此項目應為 `1.0`。
+ `Errors`：在註冊過程中某個時候失敗的詐騙者註冊請求的錯誤清單。
+ 
  + `RequestId`：與此要求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 `RequestId` 相同。
  + `ErrorCode`：代表錯誤類型的 HTTP 錯誤代碼。以下描述一些範例錯誤案例。
**注意**  
這並非一份詳盡無遺的清單。
    + 400 (錯誤的請求異常)：
      + 輸入的 JSON 檔案格式錯誤，無法剖析。
      + 提供的音訊檔案沒有足夠的語音進行註冊。
    + 402 (ServiceQuotaLimitExceededException)：
      + 超過詐騙者限制。
    + 500 (內部錯誤)：
      + 內部伺服器錯誤 (服務端出現意外錯誤)。
  + `ErrorMessage`：描述詐騙者註冊失敗原因的訊息。
+ `SuccessfulRegistrations`：成功的註冊請求清單。
  + `RequestId`：與此請求相關聯的請求識別碼。這與此請求的輸入檔案中指定的 `RequestId` 相同。
  + `RegistrationStatus`：成功的詐騙者註冊狀態。
    + `DUPLICATE_SKIPPED`：詐騙者被識別為重複，並跳過註冊。
    + `NEW_FRAUDSTER`：詐騙者是新加入該系統的。
  + `GeneratedFraudsterId`：已註冊詐騙者的服務產生識別碼。如果 `RegistrationStatus` 是 `DUPLICATE_SKIPPED`，則這是網域中已經與給定詐騙者最接近匹配的詐騙者的識別碼。
  + `FraudsterSimilarityScore`：當詐騙者註冊由於重複而跳過詐騙者註冊時填充的可選欄位。這代表了給定的詐騙者與網域中已經存在的最接近相符詐騙者的相似性。