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

# AMAZON.QinConnectIntent
<a name="built-in-intent-qinconnect"></a>

**注意**  
若要使用 Amazon Q In Connect 使用生成式 AI 功能，您必須完成下列先決條件：  
導覽至 Amazon Connect 主控台並建立執行個體，如果您還沒有執行個體，請參閱[開始使用 Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-get-started.html)。
為您的執行個體啟用 Amazon Q in Connect，請參閱[為您的執行個體啟用 Amazon Q in Connect](https://docs.aws.amazon.com/connect/latest/adminguide/enable-q.html)。

AMAZON.QinConnectIntent 使用 LLM 增強的 Amazon Connect Wisdom 演變來回應客戶問題，提供即時建議，以協助聯絡中心客戶和客服人員快速準確地解決客戶問題。當表達用語未分類為機器人中存在的任何其他意圖時，就會啟用此意圖。請注意，在引出槽值時，不會針對遺漏的表達用語啟用此意圖。一旦識別，AMAZON.QinConnectIntent 會使用指定的 Q in Connect 網域來搜尋設定的 Amazon Bedrock 知識庫並回應客戶問題。

**注意**  
您無法在相同的機器人地區設定中使用 AMAZON.QinConnectIntent 與 AMAZON.QnAIntent。
如果您選取美式英文以外的其他語言，則必須自訂自助式提示 (`SELF_SERVICE_PRE_PROCESSING` 和 `SELF_SERVICE_ANSWER_GENERATION`) 以指定語言回應。如需如何自訂提示的詳細資訊，請參閱[自訂 Amazon Q in Connect](https://docs.aws.amazon.com/connect/latest/adminguide/customize-q.html#ai-prompts-customize-q)。

如果您選取此意圖，則需要設定下列欄位，然後選取**儲存意圖**，將意圖新增至機器人。
+ Amazon Q In Connect 組態 - 提供 Amazon Q in Connect 助理的 Amazon Resource Name (ARN)。助理 ARN 模式：`^arn:[a-z-]*?:wisdom:[a-z0-9-]*?:[0-9]{12}:[a-z-]*?/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(?:/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}){0,2}$>`。

QinConnectIntent 的回應會存放在請求屬性中，如下所示：
+ `x-amz-lex:q-in-connect-response` – 從 QinConnectIntent 對問題或表達用語的回應。

**從 QinConnectIntent 傳回的工作階段屬性**

與 QinConnect 意圖的互動提供透過工作階段屬性進行對話的其他資料。

1. `x-amz-lex:q-in-connect:session-arn` – 對話期間使用 Amazon Q In Connect 建立之工作階段的唯一識別符。

1. `x-amz-lex:q-in-connect:conversation-status` – 與 QinConnect 助理或網域對話的目前狀態。此狀態可能有三個值：
   + `CLOSED`
   + `READY`
   + `PROCESSING`

1. `x-amz-lex:q-in-connect:conversation-status-reason` – 提供使用上述屬性報告目前狀態的原因。可能的原因如下：
   + `SUCCESS` – 表示客戶沒有問題可詢問，且問題已成功回答。
   + `FAILED` – 表示回答客戶的問題時失敗。這些主要是因為無法了解客戶的問題。
   + `REJECTED` – 表示助理拒絕回答客戶問題，並建議在機器人互動之外處理問題，例如與人員或客服人員交談，以取得更多資訊。

**注意**  
在 Amazon Connect 執行個體驅動的客戶互動期間調用具有 QinConnectIntent 的機器人時，需要建立工作階段 ARN，並從 Amazon Connect 執行個體傳遞。若要建立工作階段，可以使用 Amazon Connect Q in Connect 步驟來設定 Amazon Connect Flows。

**限制**
+ 您無法在相同機器人地區設定中使用 AMAZON.QinConnectIntent 搭配沒有特定表達用語的意圖，例如 AMAZON.QnAIntent、AMAZON.BedrockAgentIntent。
+ 在由 Amazon Connect 執行個體驅動的客戶互動期間調用具有 QinConnectIntent 的機器人時，需要建立工作階段 Arn 並從 Amazon Connect 執行個體傳遞。若要建立工作階段，可以使用 Amazon Connect Q In Connect 步驟設定 Amazon Connect 流程。
+ 每個機器人地區設定不能超過一個 AMAZON.QinConnectIntent。
+ 搭配 AMAZON.QinConnectIntent 使用的 Amazon Q in Connect 網域必須與 Amazon Lex V2 機器人位於相同的 AWS 區域。

**許可**

如果 QinConnect 意圖用於 Amazon Lex V2 機器人，且機器人使用服務連結角色 (SLR)，則 Amazon Lex V2 服務具有更新角色適當政策的許可，以將其與 Q in Connect 助理整合。如果機器人使用自訂 IAM 角色，則使用者將需要手動將這些許可新增至其 IAM 角色。

如果新增 QinConnect 意圖，服務連結角色將以下列許可進行更新。將新增 QinConnect 存取的新政策：

```
{
    "Version": "2012-10-17", 		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Sid": "QInConnectAssistantPolicy",
            "Action": [
                "wisdom:CreateSession",
                "wisdom:GetAssistant"
            ],
            "Resource": [
                "arn:aws:wisdom:*:accountId:assistant/assistantId",
                "arn:aws:wisdom:*:accountId:assistant/assistantId/*"
            ]
        },
        {
            "Effect": "Allow",
            "Sid": "QInConnectSessionsPolicy",
            "Action": [
                "wisdom:SendMessage",
                "wisdom:GetNextMessage"
            ],
            "Resource": [
                "arn:aws:wisdom:*:accountId:session/assistantId/*"
            ]
        },
        {
            "Sid": "QInConnectKmsCMKPolicy",
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey"
            ],
            "Resource": [
                "arn:aws:kms:region:accountId:key/keyId"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceAccount": "accountId",
                    "kms:ViaService": "wisdom.region.amazonaws.com",
                    "kms:EncryptionContext:aws:wisdom:assistant:arn": ["arn:aws:wisdom:region:accountId:assistant/assistantId"]
                }
            }
        }
    ]
}
```

**注意**  
只有在您使用客戶受管 KMS 金鑰搭配 Amazon Q in Connect 助理時，才需要 `QInConnectKmsCMKPolicy`陳述式。

**信任政策**

```
{
    "Effect": "Allow",
    "Sid": "LexV2InternalTrustPolicy",
    "Principal": {
        "Service": "lexv2.aws.internal"
    },
    "Action": "sts:AssumeRole",
    "Condition": {
        "StringEquals": {
            "aws:SourceAccount": "accountId"
        },
        "ArnLike": {
            "aws:SourceArn": "arn:aws:lex:*:accountId:bot-alias/botId/*"
        }
    }
}
```