View a markdown version of this page

Pencatatan dan penelusuran untuk agen Connect AI - Amazon Connect

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pencatatan dan penelusuran untuk agen Connect AI

Untuk memecahkan masalah agen Connect AI secara efektif, gunakan opsi pencatatan dan penelusuran berikut.

  • ListSpans API (direkomendasikan untuk agen AI orkestrator): Gunakan ListSpansAPI untuk mengambil jejak eksekusi agen AI untuk sesi. Ini adalah titik awal yang direkomendasikan untuk men-debug interaksi agen AI orkestrator, karena memberikan visibilitas granular ke dalam aliran orkestrasi agen, interaksi LLM, dan pemanggilan alat, memungkinkan Anda untuk melacak bagaimana agen AI beralasan melalui permintaan dan alat mana yang dipilih dan dijalankan.

  • CloudWatch Log: Aktifkan CloudWatch Logging untuk agen Connect AI Anda dengan mengikuti langkah-langkahnyaMonitor Connect agen AI.

    Interaksi swalayan lama menghasilkan entri log dengan jenis peristiwa TRANSCRIPT_SELF_SERVICE_MESSAGE dalam format berikut:

    {
    "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}"
}

    Interaksi layanan mandiri agen menghasilkan entri log dengan jenis peristiwa. TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION Entri ini mencakup konteks orkestrasi lengkap seperti prompt dengan konfigurasi alat, riwayat percakapan dengan panggilan dan hasil alat, penyelesaian model, dan konfigurasi agen AI. Contoh berikut menunjukkan bidang kunci:

    {
    "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}"
}

  • Pencatatan Amazon Lex (khusus layanan mandiri): Aktifkan pencatatan Amazon Lex dengan mengikuti langkah-langkah dalam kesalahan Pencatatan dengan log kesalahan di Amazon Lex V2.

  • Pencatatan Amazon Connect: Aktifkan pencatatan Amazon Connect dengan menambahkan blok Mengatur perilaku logging aliran di alur Amazon Connect Anda.