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

 

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

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

AMAZON.KendraSearchIntent

若要搜尋已使用 Amazon Kendra 編製索引的文件，請使用AMAZON.KendraSearchIntent意圖。當 Amazon Lex 無法判斷與使用者交談中的下一個動作時，會觸發搜尋意圖。

AMAZON.KendraSearchIntent僅在英文 (美國) (en-US) 地區以及美國東部 (維吉尼亞北部)、美國西部 (奧勒岡) 和歐洲 (愛爾蘭) 區域提供。

Amazon Kendra 是一種 machine-learning-based 搜索服務，用於索引自然語言文檔，如 PDF 文檔或 Microsoft Word 文件。它可以搜尋已編製索引的文件，並傳回下列類型的問題回覆：

如需使用 AMAZON.KendraSearchIntent 的範例，請參閱範例：為 Amazon Kendra 索引建立常見問題集機器人。

如果您為機器人設定AMAZON.KendraSearchIntent意圖，Amazon Lex 會在無法判斷插槽或意圖的使用者說話時呼叫意圖。例如，如果您的機器人引發了一種稱為「比薩餅餡料」的插槽類型的響應，並且用戶說「什麼是比薩餅？ ，」Amazon Lex 打電話AMAZON.KendraSearchIntent來處理這個問題。如果沒有來自 Amazon Kendra 的回應，交談會依照機器人中的設定繼續進行。

當您在同一個機器人AMAZON.FallbackIntent中同時使用AMAZON.KendraSearchIntent和時，Amazon Lex 使用意圖如下：

有三種方法可以使用AMAZON.KendraSearchIntent向 Amazon Kendra 發出請求：

若要在建立機器人時指定queryFilterString參數，或在對話方塊 Lambda 函數中呼叫delegate動作時指定kendraQueryFilterString欄位，請指定用作 Amazon Kendra 查詢屬性篩選器的字串。如果字串不是有效的屬性篩選條件，則您會在執行時間取得 InvalidBotConfigException 例外狀況。如需有關屬性篩選器的詳細資訊，請參閱 Amazon Kendra 開發人員指南中的使用文件屬性篩選查詢。

若要控制 Amazon Lex 傳送至 Amazon Kendra 的查詢，您可以在對話方塊 Lambda 函數的kendraQueryRequestPayload欄位中指定查詢。如果查詢無效，Amazon Lex 會傳回InvalidLambdaResponseException例外狀況。如需詳細資訊，請參閱 Amazon Kendra 開發人員指南中的查詢操作。

如需使用 AMAZON.KendraSearchIntent 的範例，請參閱範例：為 Amazon Kendra 索引建立常見問題集機器人。

Amazon Kendra 搜索的 IAM 政策

若要使用AMAZON.KendraSearchIntent意圖，您必須使用提供 AWS Identity and Access Management (IAM) 政策的角色，讓 Amazon Lex 承擔具有呼叫 Amazon Kendra Query 意圖之權限的執行時期角色。您使用的 IAM 設定取決於您是AMAZON.KendraSearchIntent使用 Amazon Lex 主控台建立，還是使用 AWS 開發套件或 AWS Command Line Interface (AWS CLI) 來建立。使用主控台時，您可以選擇新增將 Amazon Kendra 呼叫給 Amazon Lex 服務連結角色的權限，或使用專門用於呼叫 Amazon Kendra Query 操作的角色。當您使用 AWS CLI 或開發套件建立意圖時，您必須使用專門用於呼叫 Query 操作的角色。

連接許可

您可以使用主控台連接許可，將 Amazon Kendra Query 操作存取到預設的 Amazon Lex 服務連結角色。將許可附加到服務連結角色時，您不需要建立和管理專門用於連線至 Amazon Kendra 索引的執行時期角色。

您用來存取 Amazon Lex 主控台的使用者、角色或群組必須具有管理角色政策的許可。將下列 IAM 政策附加到主控台存取角色。當您授與這些許可時，角色具有變更現有的服務連結角色政策的許可。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:AttachRolePolicy",
                "iam:PutRolePolicy",
                "iam:GetRolePolicy"
            ],
            "Resource": "arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots"
        },
        {
            "Effect": "Allow",
            "Action": "iam:ListRoles",
            "Resource": "*"
        }
    ]
}

指定角色

您可以使用主控台AWS CLI、或 API 來指定呼叫 Amazon Kendra Query 作業時要使用的執行階段角色。

您用來指定執行階段角色的使用者、角色或群組必須具有iam:PassRole權限。下列政策會定義許可。您可以使用 iam:AssociatedResourceArn 和 iam:PassedToService 條件內容鍵來進一步限制許可的範圍。如需詳細資訊，請參閱AWS Identity and Access Management使用指南中的 IAM 和AWS STS條件內容金鑰。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::account:role/role"
        }
    ]
}

Amazon Lex 用來呼叫 Amazon Kendra 所需的執行階段角色必須具有kendra:Query許可。當您使用現有的 IAM 角色獲得呼叫 Amazon Kendra Query 操作的許可時，該角色必須附加以下政策。

您可以使用 IAM 主控台、IAM API 或建AWS CLI立政策並將其附加到角色。這些指示會使用 AWS CLI 來建立角色和政策。

您可以選擇更新 Amazon Lex 服務連結角色，或使用為機器人建立時建立AMAZON.KendraSearchIntent的角色。下列程序顯示如何選擇要使用的 IAM 角色。

使用請求和工作階段屬性作為篩選條件

若要篩選 Amazon Kendra 對與目前對話相關項目的回應，請在建立機器人時新增queryFilterString參數，使用工作階段和請求屬性做為篩選器。您可以在建立意圖時指定屬性的預留位置，然後 Amazon Lex V2 會在呼叫 Amazon Kendra 之前替換值。如需請求屬性的詳細資訊，請參閱設定請求屬性。如需工作階段屬性的詳細資訊，請參閱 設定工作階段屬性。

以下是使用字串篩選 Amazon Kendra 查詢的queryFilterString參數範例。

"{"equalsTo": {"key": "City", "value": {"stringValue": "Seattle"}}}"

以下是使用名"SourceURI"為篩選 Amazon Kendra 查詢的工作階段屬性的queryFilterString參數範例。

"{"equalsTo": {"key": "SourceURI","value": {"stringValue": "[FileURL]"}}}"

以下是使用名為篩選 Amazon Kendra 查詢的請求"DepartmentName"屬性的queryFilterString參數範例。

"{"equalsTo": {"key": "Department","value": {"stringValue": "((DepartmentName))"}}}"

這些AMAZON.KendraSearchInteng篩選器使用與 Amazon Kendra 搜尋篩選器相同的格式。如需詳細資訊，請參閱 Amazon Kendra 開發人員指南中的使用文件屬性篩選搜尋結果。

搭配使用的查詢篩選字串AMAZON.KendraSearchIntent必須為每個篩選器的第一個字母使用小寫字母。例如，以下是有效的查詢篩選器AMAZON.KendraSearchIntent。

{
    "andAllFilters": [
        {
            "equalsTo": {
                "key": "City",
                "value": {
                    "stringValue": "Seattle"
                }
            }
        },
        {
            "equalsTo": {
                "key": "State",
                "value": {
                    "stringValue": "Washington"
                }
            }
        }
    ]
}

使用搜尋回應

Amazon Kendra 會在意圖conclusion陳述式中傳回搜尋的回應。除非履行 Lambda 函數產生結論訊息，否則意圖必須有conclusion陳述式。

Amazon Kendra 有四種類型的回應。

回應會以 request 屬性傳回。每個屬性最多可有五個回應，編號為 1 到 5。如需有關回應的詳細資訊，請參閱 Amazon Kendra 開發人員指南中的回應類型。

conclusion 陳述式必須有一或多個訊息群組。每個訊息群組都包含一或多個訊息。每個訊息都可以包含一或多個預留位置變數，這些變數會在 Amazon Kendra 回應中由請求屬性取代。訊息群組中必須至少有一個訊息，而訊息中的所有變數都會由執行時間回應中的請求屬性值取代，或是群組中必須具有無預留位置變數的訊息。請求屬性會以雙括號 ("((" "))") 括起來。下列訊息群組訊息符合來自 Amazon Kendra 的任何回應：

使用 Lambda 函數來管理請求和回應

AMAZON.KendraSearchIntent意圖可以使用您的對話方塊程式碼掛接和履行代碼勾點來管理傳送給 Amazon Kendra 的請求和回應。當您想要修改傳送至 Amazon Kendra 的查詢時，請使用對話方塊程式碼掛接 Lambda 函數，而當您要修改回應時，履行程式碼會掛接 Lambda 函數。

使用對話方塊程式碼掛勾建立查詢

您可以使用對話方塊程式碼掛接來建立要傳送至 Amazon Kendra 的查詢。使用對話方塊程式碼掛勾是選用的。如果您未指定對話方塊程式碼勾點，Amazon Lex 會根據使用者的話語建構查詢，並使用您在設定queryFilterString意圖時提供的查詢 (如果您提供的話)。

您可以使用對話方塊程式碼勾點回應中的兩個欄位來修改 Amazon Kendra 的請求：

建立篩選器或查詢字串之後，您可以將回應的dialogAction欄位設定為的 Amazon Lex 傳送回應delegate。Amazon Lex 會將查詢傳送至 Amazon Kendra，然後將查詢回應傳回至履行代碼勾點。

針對回應使用履行程式碼掛勾

Amazon Lex 將查詢傳送至 Amazon Kendra 之後，查詢回應就會傳回至AMAZON.KendraSearchIntent履行 Lambda 函數。代碼鉤子的輸入事件包含來自 Amazon Kendra 的完整響應。查詢資料的結構與 Amazon Kendra Query 作業傳回的資料結構相同。如需詳細資訊，請參閱 Amazon Kendra 開發人員指南中的查詢回應語法。

履行程式碼掛勾是選用的。如果不存在，或程式碼掛鉤未在回應中傳回訊息，Amazon Lex 會使用該conclusion陳述式進行回應。