Monitore o Amazon Q no Connect usando CloudWatch registros - Amazon Connect
Permissões obrigatórias do IAMHabilitar registro em log Tipos de log compatíveisVerifique as cotas CloudWatch de registrosExemplos de logs do assistenteExemplos de consultas comuns para depurar logs do assistente

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitore o Amazon Q no Connect usando CloudWatch registros

Para obter visibilidade das recomendações em tempo real que o Amazon Q in Connect fornece aos seus agentes e das intenções do cliente que ele detecta por meio da compreensão da linguagem natural, você pode consultar CloudWatch os registros. CloudWatch Os registros oferecem visibilidade de toda a jornada de contato: a conversa, os gatilhos, as intenções e as recomendações. Você também pode usar essas informações para depuração ou fornecê-las Suporte ao entrar em contato com eles para obter ajuda.

Este tópico explica como habilitar o registro em log do Amazon Q no Connect.

Permissões obrigatórias do IAM

Antes de ativar o registro em um assistente Amazon Q in Connect, verifique se você tem as seguintes AWS Identity and Access Management permissões. Elas são necessárias para a conta de usuário que está conectada ao console do Amazon Connect:

  • wisdom:AllowVendedLogDeliveryForResource: necessário para permitir a entrega de logs para o recurso de assistente.

Consulte um exemplo de perfil do IAM com todas as permissões necessárias para seu destino de registro em log específico em Logging that requires additional permissions [V2]. Esse tópico contém exemplos de diferentes destinos de registro, como registros enviados para CloudWatch Logs e logs enviados para o Amazon S3. Os exemplos mostram como permitir atualizações em seu recurso de destino de registro específico.

Habilitar o registro em log do Amazon Q no Connect

Para ativar o registro no Amazon Q no Connect, você usa a CloudWatch API. Execute as etapas a seguir.

  1. Obtenha o ARN do assistente do Amazon Q no Connect (também conhecido como seu domínio). Depois de criar um assistente, você pode obter seu ARN no console do Amazon Connect ou chamando a GetAssistantAPI. O ARN segue este formato:

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

  2. Chamada PutDeliverySource: use essa CloudWatch API para criar uma fonte de entrega para o assistente. Passe o ARN do assistente como o resourceArn. Para logType, especifique EVENT_LOGS a fim de coletar logs do assistente.

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

  3. Chamada PutDeliveryDestination: use essa CloudWatch API para configurar onde os registros devem ser armazenados. Você pode escolher CloudWatch Logs, Amazon S3 ou Amazon Data Firehose como destino para armazenar registros. Você deve especificar o ARN de uma das opções de destino de onde seus logs serão armazenados. Você pode escolher o outputFormat dos logs como um destes: json, plain, w3c, raw ou parquet.

    O exemplo a seguir mostra como configurar registros para serem armazenados em um grupo de CloudWatch registros da Amazon e no 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. Chamada CreateDelivery: use essa CloudWatch API para vincular a fonte de entrega ao destino de entrega que você criou nas etapas anteriores. Essa operação de API associa a fonte de entrega ao destino final.

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

Tipos de log compatíveis

O Amazon Q no Connect é compatível com o seguinte tipo de log:

  • EVENT_LOGS: logs que rastreiam eventos de um assistente do Amazon Q no Connect durante chamadas e chats.

Verifique as cotas CloudWatch de registros

Recomendamos verificar CloudWatch os endpoints e as cotas do Amazon Logs para ver se há alguma cota para fazer CloudWatch chamadas de API relacionadas à entrega do Logs. As cotas definem um número máximo de vezes que você pode chamar uma API ou criar um recurso. Exceder o limite resulta em um erro ServiceQuotaExceededException.

Exemplos de logs do assistente

Veja a seguir um exemplo de um log de evento. Pode haver mais campos visíveis dependendo do 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"
}

Pode haver mais campos visíveis dependendo do tipo de evento. Por exemplo, um chat ou evento de voz tem informações relacionadas ao enunciado. Um evento que gerou uma recomendação tem informações sobre a intenção, o gatilho ou a própria recomendação.

Exemplos de consultas comuns para depurar logs do assistente

Você pode interagir com logs usando consultas. Por exemplo, você pode consultar todos os eventos em uma sessão usando SESSION_NAME.

A seguir estão duas consultas comuns para retornar todos os logs gerados para uma sessão específica.

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"