GetUtterancesView - Amazon Lex V1
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

如果您使用的是 Amazon Lex V2，請參閱 Amazon Lex V2 指南。

 

如果您使用的是 Amazon Lex V1，我們建議您將機器人升級到 Amazon Lex V2。我們不再向 V1 添加新功能，強烈建議所有新機器人使用 V2。

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

GetUtterancesView

使用該GetUtterancesView操作可獲取有關用戶對您的機器人進行的語音的信息。您可以使用此列表來調整機器人響應的話語。

例如，假設您已經創建了一個機器人來訂購鮮花。使用者使用您的機器人一段時間後，請使用該GetUtterancesView操作來查看他們提出的請求以及他們是否成功。您可能會發現「我要花」的話語沒有被認可。您可以將此話語添加到OrderFlowers意圖中，以便您的機器人識別該話語。

發布新版本的機器人後，您可以獲取有關舊版本和新版本的信息，以便您可以比較兩個版本的性能。

表達用語統計資料為每天產生一次。過去 15 天的資料可用。您可以在每個請求中要求最多 5 個機器人版本的資訊。Amazon Lex 會傳回機器人在過去 15 天內收到的最常用語音。回應包含每個版本最多 100 個語音的相關資訊。

在下列情況下，不會產生話語統計資料：

  • 建立機器人時，childDirected欄位設定為 true。

  • 您正在使用一個或多個插槽的插槽混淆。

  • 您選擇不參與改善亞 Amazon Lex。

這項操作需要 lex:GetUtterancesView 動作的許可。

請求語法

GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

botname

應傳回其語音資訊的機器人名稱。

長度約束：最小長度為 2。長度上限為 50。

模式：^([A-Za-z]_?)+$

必要：是

botVersions

應傳回語音資訊的機器人版本陣列。限制為每個請求 5 個版本。

陣列成員：項目數下限為 1。項目數上限為 5。

長度限制：長度下限為 1。長度上限為 64。

模式：\$LATEST|[0-9]+

必要：是

statusType

要返回已識別和處理的語音，請使用。Detected要返回未識別的語音，請使用。Missed

有效值:Detected | Missed

必要：是

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "botName": "string",
   "utterances": [ 
      { 
         "botVersion": "string",
         "utterances": [ 
            { 
               "count": number,
               "distinctUsers": number,
               "firstUtteredDate": number,
               "lastUtteredDate": number,
               "utteranceString": "string"
            }
         ]
      }
   ]
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

botName

傳回語音資訊的機器人名稱。

類型：字串

長度約束：最小長度為 2。長度上限為 50。

模式：^([A-Za-z]_?)+$

utterances

一個UtteranceList對象數組，每個對象都包含描述由您的機器人處理的話語的UtteranceData對象列表。每個版本的回應最多包含 100 個UtteranceData物件。Amazon Lex 會傳回機器人在過去 15 天內收到的最常用語音。

類型：UtteranceList 物件陣列

錯誤

BadRequestException

請求的格式不正確。例如，值無效或缺少必填欄位。請檢查欄位值，然後再試一次。

HTTP 狀態碼：400

InternalFailureException

發生內部 Amazon Lex 錯誤。請再次嘗試您的請求。

HTTP 狀態碼：500

LimitExceededException

請求超過限制。請再次嘗試您的請求。

HTTP 狀態碼：429

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：