翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 リソースネーム (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 アシスタントまたはドメインとの会話の現在のステータス。このステータスに可能な値は以下の 3 つです。
   + `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.QinConnectIntent を特定の発話のないインテント (AMAZON.QnAIntent、AMAZON.BedrockAgentIntent など) と共に使用することはできません。
+ Amazon Connect インスタンスによって生じた顧客とのやり取り中に QinConnectIntent を持つボットが呼び出された場合、セッション ARN を作成して Amazon Connect インスタンスから渡す必要があります。セッションを作成するには、Amazon Connect フローを Amazon Q In Connect ステップで設定できます。
+ ボットロケールごとに 2 つ以上の AMAZON.QinConnectIntent を含めることはできません。
+ AMAZON.QinConnectIntent で使用する Amazon Q in Connect ドメインは、Amazon Lex V2 ボットと同じ AWS リージョンに存在する必要があります。

**アクセス許可**

QinConnect Intent が 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"]
                }
            }
        }
    ]
}
```

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