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 AWS Support quando li contatti per ricevere assistenza.

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

Autorizzazioni richieste IAM

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 IAM ruolo di esempio con tutte le autorizzazioni richieste per la destinazione di registrazione specifica, vedere 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, usi il CloudWatch API. Completa questa procedura:

1. Ottieni il ARN tuo assistente Amazon Q in Connect (noto anche come dominio). Dopo aver creato un assistente, puoi ottenerlo ARN dalla console Amazon Connect o chiamando il GetAssistantAPI. ARNSegue questo formato:

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

2. Chiamata PutDeliverySource: usa questa CloudWatch API opzione per creare una fonte di consegna per l'assistente. Passa ARN l'assistente comeresourceArn. 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: usa questa opzione 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 una ARN delle opzioni di destinazione per la quale archiviare i log. È possibile scegliere tra i outputFormat registri uno dei seguenti:json,,, plainw3c,raw. parquet

   L'esempio seguente mostra come configurare i log da archiviare in un gruppo Amazon CloudWatch Logs e in JSON formato.

   {
       "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: usa questa CloudWatch API opzione per collegare la fonte di consegna alla destinazione di consegna che hai creato nei passaggi precedenti. Questa API operazione 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 CloudWatch chiamate relative alla consegna di Logs. API Le quote stabiliscono un numero massimo di volte in cui puoi chiamare o creare una risorsa. API 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"