本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

**注意**  
要通过 Amazon Q In Connect 使用生成式人工智能功能，必须满足以下先决条件：  
导航到 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)。

亚马逊。 QinConnectIntent 使用 Amazon Connect Wisdom 的 LLM 增强版回复客户的问题，该版本可提供实时建议，帮助联络中心的客户和客服人员快速准确地解决客户问题。当某个言语未被归类为机器人中存在的任何其他意图时，就会激活此意图。请注意，引发槽位值时，不会因为错过的言语而激活此意图。一旦被识别，亚马逊。 QinConnectIntent，使用指定的 Q in Connect 域搜索已配置的 Amazon Bedrock 知识库并回答客户的问题。

**注意**  
您不能使用亚马逊。 QinConnectIntent 以及 Amazon.qn AIntent 位于同一个机器人区域中。
如果您选择除美国英语之外的另一种语言，则必须自定义自助服务提示（`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 资源名称（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 机器人时，需要从 Amazon Connect 实例创建并传递您的会话 arn。要创建会话，可以在 Amazon Q in Connect 步骤中配置 Amazon Connect 流。

**限制**
+ 您不能使用亚马逊。 QinConnectIntent 以及没有具体言论的意图，例如 Amazon.qn、亚马逊AIntent。 BedrockAgentIntent 在同一个机器人区域中。
+ 在由 Amazon Connect 实例驱动的客户互动期间调用 QinConnectIntent 机器人时，需要从 Amazon Connect 实例创建并传递您的会话 arn。要创建会话，可以在 Amazon Q In Connect 步骤中配置 Amazon Connect 流。
+ 亚马逊不能超过一个。 QinConnectIntent 按机器人区域划分。
+ 与亚马逊一起使用的 Amazon Q in Connect 域名。 QinConnectIntent 必须与 Amazon Lex V2 机器人位于相同的 AWS 区域。

**权限**

如果在 Amazon Lex V2 机器人中使用 QinConnect 意图，而该机器人使用的是服务关联角色 (SLR)，则 Amazon Lex V2 服务有权更新该角色的相应策略，使其与 Q in Connect 助手集成。如果机器人使用自定义 IAM 角色，则用户需要手动将这些权限添加到其 IAM 角色。

如果添加了 QinConnect Intent，则服务关联角色将使用以下权限进行更新。将添加新的 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/*"
        }
    }
}
```