Registrazione e tracciamento per gli agenti Connect AI

ListSpans API (consigliata per gli agenti AI orchestratori): utilizza l'ListSpansAPI per recuperare le tracce di esecuzione degli agenti AI per una sessione. Questo è il punto di partenza consigliato per il debug delle interazioni con gli agenti AI dell'orchestratore, in quanto fornisce una visibilità granulare sui flussi di orchestrazione degli agenti, sulle interazioni LLM e sulle chiamate degli strumenti, consentendoti di tracciare il modo in cui l'agente AI ha risposto a una richiesta e quali strumenti ha selezionato ed eseguito.

CloudWatch Registri: abilita CloudWatch la registrazione per i tuoi agenti Connect AI seguendo la procedura riportata di seguito. Monitora gli agenti Connect AI

Le interazioni self-service precedenti generano voci di registro con il tipo di evento TRANSCRIPT_SELF_SERVICE_MESSAGE nel seguente formato:

{
    "assistant_id": "{UUID}",
    "event_timestamp": 1751414298692,
    "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE",
    "session_id": "{UUID}",
    "utterance": "[CUSTOMER]...",
    "prompt": "{prompt used}",
    "prompt_type": "SELF_SERVICE_PRE_PROCESS|SELF_SERVICE_ANSWER_GENERATION",
    "completion": "{Response from model}",
    "model_id": "{model id e.g.: us.amazon.nova-pro-v1:0}",
    "session_message_id": "{UUID}",
    "parsed_response": "{model response}"
}

Le interazioni self-service agentiche generano voci di registro con il tipo di evento. TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION Queste voci includono il contesto di orchestrazione completo, ad esempio il prompt con le configurazioni degli strumenti, la cronologia delle conversazioni con le chiamate e i risultati degli strumenti, il completamento del modello e la configurazione dell'agente AI. L'esempio seguente mostra i campi chiave:

{
    "assistant_id": "{UUID}",
    "event_timestamp": 1772748470993,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "{UUID}",
    "prompt": "{full prompt including system instructions, tool configs, and conversation history}",
    "prompt_type": "ORCHESTRATION",
    "completion": "{model response with message and tool use}",
    "model_id": "{model id e.g.: us.anthropic.claude-haiku-4-5-20251001-v1:0}",
    "parsed_response": "{parsed customer-facing message}",
    "generation_id": "{UUID}",
    "ai_agent_id": "{UUID}"
}

Registrazione Amazon Lex (solo self-service): abilita la registrazione di Amazon Lex seguendo i passaggi in Registrazione degli errori con i log degli errori in Amazon Lex V2.

Registrazione di log Amazon Connect: abilita la registrazione di log di Amazon Connect aggiungendo un blocco di flusso Imposta il comportamento di registrazione nel flusso di Amazon Connect.