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

# 管理選擇性對話日誌擷取
<a name="manage-selective-logging"></a>

使用 Lex 主控台，您可以啟用選擇性對話日誌擷取設定，並選擇您要啟用選擇性對話日誌擷取的插槽。

**在 Amazon Lex V2 主控台中啟用選擇性對話日誌擷取：**

1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/lexv2/home](https://console.aws.amazon.com/lexv2/home)：// 開啟 Amazon Lex V2 主控台。

1. 從左側面板選取**機器人**，然後選擇您要啟用選擇性對話日誌擷取的機器人。使用現有的機器人或建立新的機器人。

1. 在左側面板的**部署**區段下，選擇所選機器人的**別名**。

1. 選擇機器人的別名，然後選取**管理對話日誌**。

1. 在**管理對話日誌**面板中，對於**文字日誌**，選擇選項按鈕來選擇是否啟用或停用文字日誌。如果您選擇**啟用**文字日誌，則需要輸入**日誌群組名稱**，或從下拉式選單中選擇現有的日誌群組名稱。如果您要選擇性地記錄文字檔案，請選取**選擇性記錄表達用語**的核取方塊。
**注意**  
在建置時間 **BotAlias** **設定中，選取對話日誌設定 （文字和/或音訊） 中的選擇性記錄表達用語****核取方塊，以啟用文字和/或音訊日誌**。您必須設定 CloudWatch 日誌群組和 Amazon S3 儲存貯體以選取此選項。

1. 在**音訊日誌**區段中，選擇選項按鈕來選擇是否啟用或停用音訊日誌。如果您選擇**啟用**音訊日誌，則需要指定 Amazon S3 儲存貯體位置和 （選用） 用於加密音訊資料的 KMS 金鑰。如果您正在選擇性地記錄音訊檔案，請選取**選擇性記錄表達用語**的核取方塊。  
![\[用於管理對話日誌的面板。\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/images/logging/selective-manage-logs.png)

1. 選取面板右下角的**儲存**，以儲存您的選擇性對話日誌擷取設定。

**在 Amazon Lex V2 主控台中啟用選擇性對話日誌擷取：**

1. 前往**意圖**，然後選取**意圖名稱**、**初始回應**、**進階設定**、**設定值**、**工作階段屬性**。

1. 根據您要啟用選擇性對話日誌擷取的意圖和槽，將下列屬性設定為 ：
   + `x-amz-lex:enable-audio-logging:intent:slot = "true"`
   + `x-amz-lex:enable-text-logging:intent:slot = "true"`  
![\[新增選擇性工作階段屬性的面板。\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/images/logging/selective-session-attributes.png)
**注意**  
設定 `x-amz-lex:enable-audio-logging:intent:slot = "true"`以擷取僅包含對話中特定位置的表達用語。記錄表達用語的動作取決於表達用語內*意圖 *：*slot* 的評估，相較於工作階段屬性表達式，以及對應的旗標值。若要記錄表達用語，工作階段屬性中至少有一個表達式必須允許，啟用記錄旗標設定為 `true`。*意圖*和*槽*的值`"*"`也可以。如果槽和/或意圖值為 `"*"`，表示 的任何槽和/或意圖值`"*"`都會與其相符。類似於 `x-amz-lex:enable-audio-logging`，稱為 的新工作階段屬性`x-amz-lex:enable-text-logging`將用於控制文字日誌。

1. 選取**更新選項**並建置機器人以包含更新的設定。

**注意**  
您的 IAM 角色必須具有存取許可，以允許您將資料寫入 Amazon S3 儲存貯體，並使用 KMS 金鑰來加密資料。Lex 將使用 Lex 許可更新您的 IAM 角色，以存取 CloudWatch Logs 日誌群組和選取的 Amazon S3 儲存貯體。

**使用選擇性對話日誌擷取的指導方針：**

當您在對話日誌**設定中啟用文字和/或音訊日誌時，您只能啟用文字和/或音訊日誌的選擇性對話日誌**擷取。透過啟用文字和/或音訊日誌的選擇性對話日誌擷取，您可以停用對話中所有意圖和槽的記錄。若要針對特定意圖和插槽產生文字和/或音訊日誌，您必須將這些意圖和插槽的文字或/和音訊選擇性對話日誌擷取工作階段屬性設定為「true」。
+ 如果啟用選擇性對話日誌擷取，且沒有字首為 x-amz-lex：enable-audio-logging 的工作階段屬性，則所有表達式的日誌記錄都會預設為停用。此案例也適用於 x-amz-lex：enable-text-logging。
+ 如果工作階段屬性中至少一個表達式允許，則表達式日誌將僅存放於文字和/或音訊對話區段。
+ 工作階段屬性中定義的文字和/或音訊選擇性對話日誌擷取組態，只有在機器人別名內對話日誌設定中啟用文字和/或音訊的選擇性對話日誌擷取時才會生效；否則，工作階段屬性將被忽略。
+ 啟用選擇性對話日誌擷取時，未使用工作階段屬性啟用記錄的 SessionState、解譯和轉錄中的任何槽值，都會在產生的文字日誌中混淆。
+ 產生音訊和/或文字日誌的決定是透過將機器人引發的槽與選擇性對話日誌擷取工作階段屬性相符來評估，但意圖引出周轉除外，使用者可以提供槽值以及意圖引出。在意圖引動轉彎中，目前轉彎中填充的槽會與選擇性對話日誌擷取工作階段屬性相符。
+ 視為已填滿的插槽衍生自回合結束時的工作階段狀態。因此，對話方塊 Codehook Lambda 對工作階段狀態中槽所做的任何變更都會影響選擇性對話日誌擷取的行為。
+ 在意圖引動轉彎中，如果使用者提供多個槽值，則只有在文字/音訊工作階段屬性允許記錄在此轉彎中填入的所有槽時，才會產生文字和/或音訊日誌。
+ 建議的操作方法是在工作階段開始時設定選擇性對話日誌擷取工作階段屬性，並避免在工作階段期間修改。
+ 如果任何槽包含敏感資料，您應該一律啟用槽混淆。