Monitora Amazon Q in Connect utilizzando CloudWatch Logs

Per ottenere visibilità sui consigli in tempo reale che Amazon Q in Connect fornisce ai tuoi agenti e sulle intenzioni dei clienti che rileva attraverso la comprensione del linguaggio naturale, puoi interrogare CloudWatch Logs. CloudWatch I log ti danno visibilità sull'intero percorso di contatto: conversazione, fattori scatenanti, intenti, consigli. Puoi anche utilizzare queste informazioni per eseguire il debug o fornirle Supporto quando li contatti per ricevere assistenza.

Questo argomento spiega come abilitare la registrazione per Amazon Q in Connect.

Autorizzazioni IAM richieste

Prima di abilitare la registrazione per un assistente Amazon Q in Connect, verifica di disporre delle seguenti AWS Identity and Access Management autorizzazioni. Sono necessari per l'account utente che ha effettuato l'accesso alla console Amazon Connect:

• wisdom:AllowVendedLogDeliveryForResource: Necessario per consentire la consegna dei log per la risorsa assistente.

Per visualizzare un esempio di ruolo IAM con tutte le autorizzazioni richieste per la destinazione di registrazione specifica, consulta Registrazione che richiede autorizzazioni aggiuntive [V2]. Questo argomento contiene esempi per diverse destinazioni di registrazione, come i log inviati a CloudWatch Logs e i log inviati ad Amazon S3. Gli esempi mostrano come consentire gli aggiornamenti alla risorsa di destinazione di registrazione specifica.

Abilita la registrazione per Amazon Q in Connect

Per abilitare la registrazione per Amazon Q in Connect, utilizzi l' CloudWatch API. Completa questa procedura:

1. Ottieni l'ARN del tuo assistente Amazon Q in Connect (noto anche come dominio). Dopo aver creato un assistente, puoi ottenerne l'ARN dalla console Amazon Connect o chiamando l'GetAssistantAPI. L'ARN segue questo formato:

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

2. Chiamata PutDeliverySource: utilizza questa CloudWatch API per creare una fonte di consegna per l'assistente. Passa l'ARN dell'assistente come. resourceArn PerlogType, specifica EVENT_LOGS di raccogliere i log dal tuo assistente.

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

3. Chiamata PutDeliveryDestination: utilizza questa CloudWatch API per configurare dove archiviare i log. Puoi scegliere CloudWatch Logs, Amazon S3 o Amazon Data Firehose come destinazione per l'archiviazione dei log. È necessario specificare l'ARN di una delle opzioni di destinazione in cui archiviare i log. È possibile scegliere tra i outputFormat registri uno dei seguenti:json,,,plain,w3c. raw parquet

   L'esempio seguente mostra come configurare i log da archiviare in un Amazon CloudWatch Logs Group e in 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. Chiamata CreateDelivery: utilizza questa CloudWatch API per collegare l'origine di consegna alla destinazione di consegna creata nei passaggi precedenti. Questa operazione API associa la fonte di consegna alla destinazione finale.

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

Tipi di log supportati

Amazon Q in Connect supporta i seguenti tipi di log:

• EVENT_LOGS: registri che tengono traccia degli eventi di un assistente Amazon Q in Connect durante le chiamate e le chat.

Controlla le quote dei log CloudWatch

Ti consigliamo di controllare CloudWatch gli endpoint e le quote di Amazon Logs per vedere se esistono quote per effettuare chiamate API relative alla consegna di CloudWatch Logs. Le quote stabiliscono un numero massimo di volte in cui puoi chiamare un'API o creare una risorsa. Il superamento del limite genera un ServiceQuotaExceededException errore.

Esempi di registri degli assistenti

Di seguito è riportato un esempio di registro degli eventi. Potrebbero essere visibili più campi a seconda del tipo di 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"
}

Potrebbero essere visibili più campi a seconda del tipo di evento. Ad esempio, una chat o un evento vocale contiene informazioni relative all'enunciato. Un evento che ha generato una raccomandazione contiene informazioni sull'intento, sull'innesco o sulla raccomandazione stessa.

Esempi di query comuni per il debug dei log degli assistenti

È possibile interagire con i log utilizzando le query. Ad esempio, è possibile eseguire una query per tutti gli eventi all'interno di una sessione utilizzando. SESSION_NAME

Di seguito sono riportate due query comuni per restituire tutti i log generati per una sessione specifica.

• filter session_name = "SessionName"

• filter session_id = "SessionId"