Supervise Amazon Q en Connect mediante CloudWatch registros - Amazon Connect
Permisos de IAM necesariosHabilitar el registroTipos de registro admitidosComprueba las cuotas CloudWatch de registrosEjemplos de registros de asistentesEjemplos de consultas habituales para depurar los registros de los asistentes

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.

Supervise Amazon Q en Connect mediante CloudWatch registros

Para obtener visibilidad de las recomendaciones en tiempo real que Amazon Q in Connect proporciona a sus agentes y de las intenciones de los clientes que detecta mediante la comprensión del lenguaje natural, puede consultar CloudWatch los registros. CloudWatch Los registros le permiten ver todo el recorrido del contacto: la conversación, los factores desencadenantes, las intenciones y las recomendaciones. También puedes usar esta información para depurar errores o proporcionársela Soporte cuando te pongas en contacto con ellos para solicitar ayuda.

En este tema se explica cómo habilitar el registro de Amazon Q en Connect.

Permisos de IAM necesarios

Antes de activar el registro de un asistente de Amazon Q in Connect, comprueba que tienes los siguientes AWS Identity and Access Management permisos. Son necesarios para la cuenta de usuario con la que se ha iniciado sesión en la consola de Amazon Connect:

  • wisdom:AllowVendedLogDeliveryForResource: necesario para permitir la entrega de registros para el recurso asistente.

Para ver un ejemplo de rol de IAM con todos los permisos necesarios para su destino de registro específico, consulte Logging that requires additional permissions [V2]. Este tema contiene ejemplos de diferentes destinos de registro, como los registros enviados a CloudWatch Logs y los registros enviados a Amazon S3. Los ejemplos muestran cómo permitir las actualizaciones de su recurso de destino de registro específico.

Habilitación del registro en Amazon Q en Connect

Para habilitar el registro de Amazon Q en Connect, usa la CloudWatch API. Siga estos pasos:

  1. Obtenga el ARN de su asistente de Amazon Q en Connect (también conocido como su dominio). Tras crear un asistente, puede obtener su ARN en la consola de Amazon Connect o llamando a la GetAssistantAPI. El ARN tiene el siguiente formato:

    arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id

  2. Llamada PutDeliverySource: utilice esta CloudWatch API para crear una fuente de entrega para el asistente. Pase el ARN del asistente como resourceArn. Para logType, especifique EVENT_LOGS para recopilar los registros de su asistente.

    {
    "logType": "EVENT_LOGS",
    "name": "your-assistant-delivery-source",
    "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id
}

  3. Llamada PutDeliveryDestination: utilice esta CloudWatch API para configurar dónde se almacenarán los registros. Puede elegir CloudWatch Logs, Amazon S3 o Amazon Data Firehose como destino para almacenar los registros. Debe especificar el nombre del recurso de Amazon de una de las opciones de destino en las que se almacenarán sus registros. El outputFormat de los registros puede ser uno de los siguientes: json, plain, w3c, raw, parquet.

    El siguiente ejemplo muestra cómo configurar los registros para que se almacenen en un grupo de Amazon CloudWatch Logs y en formato JSON.

    {
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*"
    },
    "name": "string",
    "outputFormat": "json",
    "tags": {
        "key": "value"
    }
}

  4. Llamada CreateDelivery: utilice esta CloudWatch API para vincular la fuente de entrega al destino de entrega que creó en los pasos anteriores. Esta operación de la API asocia el origen de la entrega con el destino final.

    {
    "deliveryDestinationArn": "string",
    "deliverySourceName": "string",
    "tags": {
        "string": "string"
    }
}

Tipos de registro admitidos

Amazon Q en Connect admite los siguientes tipos de registro:

  • EVENT_LOGS: registros que rastrean los eventos de un asistente de Amazon Q en Connect durante las llamadas y los chats.

Comprueba las cuotas CloudWatch de registros

Recomendamos comprobar los puntos de enlace y las cuotas de Amazon CloudWatch Logs para comprobar si hay alguna cuota para realizar CloudWatch llamadas a la API relacionadas con la entrega de Logs. Los límites de cuota establecen un número máximo de veces que puede llamar a una API o crear un recurso. Si se supera el límite de la política de bucket, se produce un error de ServiceQuotaExceededException.

Ejemplos de registros de asistentes

A continuación, se muestra un ejemplo de un registro de evento. Es posible que haya más campos visibles en función del tipo de evento.

{
    "assistant_id": "AssistantId",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION" | "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE" | "TRANSCRIPT_RECOMMENDATION" | "TRANSCRIPT_UTTERANCE" | "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION" | "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "SessionId",
    "session_name": "SessionName",
    "recommendation": "Recommendation",
    "intent": "Intent",
    "prompt": "Prompt",
    "utterance": "Utterance"
}

Es posible que haya más campos visibles en función del tipo de evento. Por ejemplo, un chat o un evento de voz contienen información relacionada con el enunciado. Un evento que generó una recomendación contiene información sobre la intención, el desencadenante o la propia recomendación.

Ejemplos de consultas habituales para depurar los registros de los asistentes

Puede interactuar con los registros realizando consultas. Por ejemplo, puede consultar todos los eventos de una sesión mediante SESSION_NAME.

Las siguientes son dos consultas comunes para devolver todos los registros generados para una sesión específica.

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"