AMAZON.QinConnectIntent

注記

Amazon Q In Connect を使用して生成 AI 機能を使用するには、次の前提条件を満たす必要があります。

1. Amazon Connect コンソールに移動してインスタンスを作成します。まだインスタンスがない場合は、Amazon Connect の開始方法」を参照してください。

2. インスタンスの Amazon Q in Connect を有効にするについては、「インスタンスの Amazon Q in Connect を有効にする」を参照してください。

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 をカスタマイズする」を参照してください。

このインテントを選択した場合は、次のフィールドを設定し、インテントの保存を選択してインテントをボットに追加する必要があります。

• 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 で作成されたセッションの一意の識別子。

2. x-amz-lex:q-in-connect:conversation-status – QinConnect アシスタントまたはドメインとの会話の現在のステータス。このステータスには 3 つの値があります。

   • CLOSED

   • READY

   • PROCESSING

3. x-amz-lex:q-in-connect:conversation-status-reason – 上記の属性で報告された現在のステータスの理由を提供します。考えられる理由は次のとおりです。

   • SUCCESS – 顧客が質問する余地がなく、質問への回答が成功したことを示します。

   • FAILED – 顧客の質問に回答する際の失敗を示します。これらは主に、顧客の質問を理解できないことが原因です。

   • REJECTED – アシスタントが顧客の質問に回答することを拒否し、詳細情報を取得するために、ユーザーやエージェントと話すなど、ボットとのやり取りの外で質問を処理することを推奨していることを示します。

注記

Amazon Connect インスタンスによるカスタマーインタラクション中に QinConnectIntent を持つボットが呼び出された場合、セッション ARN を作成して Amazon Connect インスタンスから渡す必要があります。セッションを作成するには、Amazon Connect Flows を Amazon Q in Connect ステップで設定できます。

制約事項

• 同じボットロケールで AMAZON.QnAIntent、AMAZON.BedrockAgentIntent などの特定の発話がないインテントと一緒に AMAZON.QinConnectIntent BedrockAgentIntent を使用することはできません。 QnAIntent

• Amazon Connect インスタンスによって駆動されるカスタマーインタラクション中に QinConnectIntent を持つボットが呼び出された場合、セッション ARN を作成して Amazon Connect インスタンスから渡す必要があります。セッションを作成するには、Amazon Connect Flows を Amazon Q In Connect ステップで設定できます。

• ボットロケールごとに 1 つ以上の 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 アクセス用の新しいポリシーが追加されます。

JSON

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

信頼ポリシー

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