Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
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.
Indice
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:
-
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 -
Chiamata PutDeliverySource: utilizza questa CloudWatch API per creare una fonte di consegna per l'assistente. Passa l'ARN dell'assistente come.
resourceArnPerlogType, specificaEVENT_LOGSdi 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} -
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
outputFormatregistri uno dei seguenti:json,,,plain,w3c.rawparquetL'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" } } -
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.
Documentazione degli CloudWatch eventi utilizzando Interactive Handler
Definizioni dei tipi di evento
La tabella seguente descrive ogni tipo di evento. Tieni presente che tipi di eventi diversi contengono campi diversi. Consulta la Definizioni dei campi sezione per informazioni dettagliate su ciascun campo.
| EventType | Definizione |
|---|---|
| TRANSCRIPT_CREATE_SESSION | Registrato quando viene creata una nuova sessione Amazon Q in Connect. Questo segna l'inizio di una conversazione. |
| TRANSCRIPT_INTENT_TRIGGERING_REFERENCE | Registrato quando nella conversazione viene rilevata l'intenzione specifica del cliente, il che può attivare risposte o flussi di lavoro automatici. |
| TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION | Registrato quando viene richiamato un modello di linguaggio di grandi dimensioni (LLM) per generare risposte o elaborare il contenuto della conversazione. Registra gli input e gli output del LLM. |
| TRANSCRIPT_QUERY_ASSISTANT | Registrato quando viene effettuata una ricerca manuale o una query diretta su Amazon Q in Connect |
| TRASCRITTO_RACCOMANDAZIONE | Registrato quando il sistema fornisce una raccomandazione a un agente o a un cliente, che può includere articoli informativi, risposte generate o azioni suggerite. |
| TRANSCRIPT_RESULT_FEEDBACK | Registrato quando viene fornito un feedback sull'utilità o la pertinenza dei risultati di una ricerca o di una query. |
| TRANSCRIPT_SELF_SERVICE_MESSAGE | Registrato quando un cliente interagisce con i componenti self-service di Amazon Q in Connect |
| TRANSCRIPT_SESSION_POLLED | Registrato quando il sistema rileva che un agente è connesso a una sessione (una sessione viene interrogata quando viene effettuata una chiamata API) GetRecommendations |
| TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION | Registrato quando il modello di rilevamento del trigger viene richiamato per determinare se una conversazione ha degli intenti |
| TRANSCRIPT_UTTERANCE | Registrato quando un messaggio viene inviato da un partecipante alla conversazione, registrando il contenuto effettivo della conversazione. |
Definizioni dei campi
La tabella seguente descrive ogni campo.
| Campo | Definizione |
|---|---|
| ai_agent_id | Identificatore univoco per la risorsa agente Amazon Q in Connect AI. |
| assistant_id | Identificatore univoco per la risorsa dell'assistente Amazon Q in Connect. |
| completamento | Il testo di completamento non elaborato restituito dal LLM o generato per il messaggio. |
| connect_user_arn | Amazon Resource Name (ARN) dell'utente Connect che accede alla sessione. |
| event_timestamp | Timestamp Unix (in millisecondi) in cui si è verificato l'evento. |
| event_type | Tipo di evento, che indica l'azione o il processo che si è verificato nel sistema. |
| generation_id | Identificatore univoco per una risposta specifica generata dall'intelligenza artificiale. |
| intento | Il testo o la descrizione dell'intento. |
| intent_clicked | Booleano che indica se la raccomandazione è stata attivata da un intento cliccato. |
| intent_id | Identificatore univoco per l'intento rilevato. |
| probabilità_problema | Probabilità numerica (0,0—1,0) che sia stato rilevato un problema nella conversazione (una probabilità maggiore di 0,5 richiamerà la generazione dell'intento) |
| è_raccomandazione_utile | Booleano che indica se l'utente ha trovato utile il risultato. |
| is_valid_trigger | Valore booleano che indica se l'analisi del modello di rilevamento ha prodotto un trigger valido. |
| model_id | Identificatore del modello di intelligenza artificiale utilizzato per richiamare l'LLM. |
| parsed_response | La processed/parsed versione del modello linguistico response, spesso in formato strutturato. |
| immediato | Il prompt di input utilizzato per richiamare l'LLM. |
| prompt_type | Tipo di prompt di Amazon Q in Connect utilizzato per elaborare il messaggio o la richiesta. |
| raccomandazione | Il contenuto effettivo del testo di raccomandazione fornito all'utente |
| recommendation_id | Identificatore univoco per la raccomandazione. |
| response | Il testo di risposta finale generato per l'utente dopo l'elaborazione. |
| session_event_id | Identificatore univoco per un evento specifico all'interno della sessione. |
| session_event_ids | Elenco degli identificatori degli eventi di sessione. |
| session_id | Identificatore univoco per la sessione Amazon Q in Connect. |
| session_message_id | Identificatore univoco per un messaggio self-service all'interno di una sessione. |
| nome_sessione | Nome della sessione. |
| enunciato | Il testo effettivo del messaggio scambiato durante la conversazione. |
Esempi di registri degli assistenti
Di seguito sono riportati alcuni esempi di registri eventi diversi per ogni tipo di evento. Fate riferimento alla Definizioni dei tipi di evento sezione per spiegazioni dettagliate su ciascun tipo di evento.
CreateSession
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173612, "event_type": "TRANSCRIPT_CREATE_SESSION", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "session_name": "nabbccdd-9999-4b23-aaee-112233445566" }
IntentTriggeringReference
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173623, "event_type": "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE", "intent": "To learn about how to autoscale DynamoDB.", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
LargeLanguageModelInvocation
Riformulazione delle interrogazioni
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "<query>The customer is asking for information on how to autoscale DynamoDB.</query>", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5" "model_id": "us.amazon.nova-lite-v1:0", "parsed_response": "The customer is asking for information on how to autoscale DynamoDB.", "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}", "prompt_type": "BEDROCK_KB_QUERY_REFORMULATION", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Rilevamento degli intenti
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "no</malice>\n - Step 2. <specific>yes</specific>\n - Step 3. <intent>To learn how to autoscale DynamoDB.</intent>", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5" "model_id": "us.amazon.nova-lite-v1:0", "parsed_response": "To learn how to autoscale DynamoDB.", "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}", "prompt_type": "GENERATIVE_INTENT_DETECTION", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Generazione di risposte intenti
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "{\"citations\":[{\"citation\":{\"generatedResponsePart\":{\"textResponsePart\":{\"span\":{\"end\":1065,\"start\":0},\"text\":\"\\nDynamoDB auto s\"}}}}]}", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0", "parsed_response": "DynamoDB auto scaling works by creating CloudWatch alarms that monitor your table's activity. When the...", "prompt": "{\"input\":{\"text\":\"The customer is seeking information on how to autoscale DynamoDB. Key utterance: \\\"How can \"}}", "prompt_type": "BEDROCK_KB_GENERATIVE_ANSWER", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Generazione di ricerca manuale
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "no</malice>\n - Step 2. <specific>yes</specific>\n - Step 3. <intent>To learn how to autoscale DynamoDB.</intent>", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0", "parsed_response": "DynamoDB auto scaling works by creating CloudWatch alarms that monitor...", "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}", "prompt_type": "BEDROCK_KB_GENERATIVE_ANSWER", "session_id": "******************-*****************" }
QueryAssistant
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173667, "event_type": "TRANSCRIPT_QUERY_ASSISTANT", "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Raccomandazione
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173656, "event_type": "TRANSCRIPT_RECOMMENDATION", "intent_clicked": 1, "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
ResultFeedback
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173667, "event_type": "TRANSCRIPT_RESULT_FEEDBACK", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "is_recommendation_useful": 1, "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff" }
SelfServiceMessage
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "{\"citations\":[{\"generatedResponsePart\":{\"textResponsePart\":{\"span\":{\"end\":276,\"start\":0},\"text\":\"To autoscale Amazon DynamoDB...\"}}]}", "event_timestamp": 1729530173678, "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE", "model_id": "us.amazon.nova-pro-v1:0", "parsed_response": "To autoscale Amazon DynamoDB, follow these steps:...", "prompt": "{\"input\":{\"text\":\"how to autoscale dynamodb\"},\"retrieveAndGenerateConfiguration\":...}", "prompt_type": "SELF_SERVICE_ANSWER_GENERATION", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "session_message_id": "mdee1234-5678-4eab-9333-ffeebb998877", "utterance": "[Customer] How can I autoscale DyanmoDB?" }
TranscriptSessionPolled
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "connect_user_arn": "arn:aws:connect:us-east-1:204585150770:instance/seaa9988-2233-4f44-8899-abcabcabcabc/agent/agbbccdd-9999-4b23-aaee-112233445566", "event_timestamp": 1729530173623, "event_type": "TRANSCRIPT_SESSION_POLLED", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "session_name": "nabbccdd-9999-4b23-aaee-112233445566" }
TriggerDetectionModelInvocation
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173634, "event_type": "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION", "is_valid_trigger": 1, "issue_probability": "0.87", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_event_ids": ["seaa9988-2233-4f44-8899-abcabcabcabc"], "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Utterance
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173623, "event_type": "TRANSCRIPT_UTTERANCE", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "utterance": "[Customer] My laptop won't connect to WiFi after the recent update" }
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"
