AMAZON.QinConnectIntent - Amazon Lex

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AMAZON.QinConnectIntent

nota

Para utilizar las capacidades de IA generativa con Amazon Q In Connect, debe cumplir los siguientes requisitos previos:

  1. Diríjase a la consola de Amazon Connect y cree su instancia; si aún no tiene una, consulte Comenzar a utilizar Amazon Connect.

  2. Habilita Amazon Q en Connect para tu instancia; consulta Habilitar Amazon Q en Connect para tu instancia.

AMAZON. QinConnectIntent responde a las preguntas de los clientes mediante la evolución mejorada por LLM de Amazon Connect Wisdom, que ofrece recomendaciones en tiempo real para ayudar a los clientes y agentes del centro de contacto a resolver los problemas de los clientes de forma rápida y precisa. Esta intención se activa cuando un enunciado no está clasificado en ninguna de las otras intenciones presentes en el bot. Tenga en cuenta que esta intención no se activará en el caso de enunciados omitidos cuando se obtenga un valor de slot. Una vez reconocido, el AMAZON. QinConnectIntent, utiliza el dominio Q in Connect especificado para buscar en la base de conocimientos configurada y responder a la pregunta del cliente.

nota

  • No puedes usar AMAZON. QinConnectIntent junto con Amazon.qn AIntent en la misma configuración regional del bot.

  • Si seleccionas otro idioma además del inglés estadounidense, debes personalizar las instrucciones del autoservicio (SELF_SERVICE_PRE_PROCESSINGySELF_SERVICE_ANSWER_GENERATION) para que respondan en el idioma especificado. Para obtener más información sobre cómo personalizar tu mensaje, consulta Cómo personalizar Amazon Q en Connect.

Si seleccionas esta intención, tendrás que configurar los siguientes campos y, a continuación, seleccionar Guardar intención para añadir la intención al bot.

  • Configuración de Amazon Q In Connect: proporcione el nombre de recurso de Amazon (ARN) del asistente Amazon Q in Connect. Patrón ARN auxiliar:. ^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}$>

Las respuestas del se QinConnectIntent almacenarán en los atributos de la solicitud, como se muestra a continuación:

  • x-amz-lex:q-in-connect-response— La respuesta QinConnectIntent a la pregunta o al enunciado.

Atributos de sesión devueltos desde QinConnectIntent

La interacción con la QinConnect intención proporciona datos adicionales sobre la conversación a través de los atributos de la sesión.

  1. x-amz-lex:q-in-connect:session-arn— Un identificador único para la sesión creada con Amazon Q In Connect durante la conversación.

  2. x-amz-lex:q-in-connect:conversation-status— El estado actual de la conversación con el QinConnect asistente o el dominio. Hay tres valores posibles para este estado:

    • CLOSED

    • READY

    • PROCESSING

  3. x-amz-lex:q-in-connect:conversation-status-reason— Proporciona el motivo del estado actual informado con el atributo anterior. Los posibles motivos son los siguientes:

    • SUCCESS— Indica que al cliente no le queda nada que preguntar y que la pregunta se ha respondido correctamente.

    • FAILED— Indica un error al responder a la pregunta del cliente. En su mayoría, se deben a la falta de comprensión de la pregunta del cliente.

    • REJECTED— Indica que el asistente se niega a responder a la pregunta del cliente y recomienda que la pregunta se aborde fuera de la interacción del bot, por ejemplo, hablando con una persona o un agente, para obtener más información.

nota

Cuando QinConnectIntent se invoca un bot con durante las interacciones con los clientes impulsadas por una instancia de Amazon Connect, es necesario crear el arn de sesión y pasarlo desde la instancia de Amazon Connect. Para crear una sesión, Amazon Connect Flows se puede configurar con Amazon Q en el paso Connect.

Limitaciones

  • No puede utilizar AMAZON. QinConnectIntent junto con intenciones sin expresiones específicas, como AMAZON.QN, AMAZON. AIntent BedrockAgentIntent en la misma configuración regional del bot.

  • Cuando QinConnectIntent se invoca un bot con durante una interacción con un cliente impulsada por una instancia de Amazon Connect, es necesario crear el arn de sesión y pasarlo desde la instancia de Amazon Connect. Para crear una sesión, Amazon Connect Flows se puede configurar con el paso Amazon Q In Connect.

  • No puede haber más de un AMAZON. QinConnectIntent por configuración regional del bot.

  • El dominio Amazon Q in Connect utilizado con AMAZON. QinConnectIntent debe estar en la misma región de AWS que el bot Amazon Lex V2.

Permisos

Si el QinConnect Intent se utiliza en un bot de Amazon Lex V2 y el bot utiliza un rol vinculado a servicios (SLR), el servicio Amazon Lex V2 tiene los permisos para actualizar las políticas correspondientes del rol e integrarlo con el asistente Q in Connect. Si el bot utiliza una función de IAM personalizada, el usuario tendrá que añadir estos permisos manualmente a su función de IAM.

El rol vinculado al servicio se actualizará con los siguientes permisos si se añade la QinConnect intención. Se agregará una nueva política de QinConnect acceso:

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

Política de confianza

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