기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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는 콜 센터 고객과 에이전트가 고객 문제를 빠르고 정확하게 해결할 수 있도록 실시간 권장 사항을 제공하는 Amazon Connect Wisdom의 LLM 강화 진화를 사용하여 고객 질문에 응답합니다. 이 의도는 표현이 봇에 존재하는 다른 어떤 의도로도 분류되지 않을 때 활성화됩니다. 슬롯 값을 도출할 때 누락된 표현에 대해서는 이 의도가 활성화되지 않는다는 점에 유의하세요. 인식되면 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 리소스 이름(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 흐름은 Amazon Q in Connect 단계로 구성할 수 있습니다.

**제한 사항 **
+ 동일한 봇 로캘에서 AMAZON.QnAIntent, AMAZON.BedrockAgentIntent 등 특정 발화가 없는 의도와 함께 AMAZON.QinConnectIntent를 함께 사용할 수 없습니다.
+ Amazon Connect 인스턴스에 의해 구동되는 고객 상호 작용 중에 QinConnectIntent가 있는 봇이 간접 호출되면 세션 ARN을 생성하여 Amazon Connect 인스턴스에서 전달해야 합니다. 세션을 생성하기 위해 Amazon Connect 흐름은 Amazon Q in Connect 단계로 구성할 수 있습니다.
+ 봇 로캘당 AMAZON.QinConnectIntent는 1개 이하일 수 있습니다.
+ AMAZON.QinConnectIntent와 함께 사용되는 Amazon Q in Connect 도메인은 Amazon Lex V2 봇과 동일한 AWS 리전에 있어야 합니다.

**권한**

Amazon Lex V2 봇에서 QinConnect 의도를 사용하고 봇이 서비스 연결 역할(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"]
                }
            }
        }
    ]
}
```

**참고**  
`QInConnectKmsCMKPolicy` 문은 Amazon Q in Connect 어시스턴트와 함께 고객 관리형 KMS 키를 사용하는 경우에만 필요합니다.

**신뢰 정책**

```
{
    "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/*"
        }
    }
}
```