View a markdown version of this page

Pencatatan dan pelacakan untuk agen AI - Pelanggan Amazon Connect

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

Pencatatan dan pelacakan untuk agen AI

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

  • ListSpans API (direkomendasikan untuk agen AI orkestrator): Gunakan ListSpans API untuk mengambil jejak eksekusi agen AI untuk sesi. Ini adalah titik awal yang disarankan untuk men-debug interaksi agen AI orkestrator, karena memberikan visibilitas terperinci 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: Akti CloudWatch fkan Logging untuk agen AI Anda dengan mengikuti langkah-langkah diMemantau agen AI menggunakan CloudWatch.

    Interaksi layanan mandiri lama menghasilkan entri log dengan jenis acara 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 swalayan agentic menghasilkan entri log dengan jenis acara. TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION Entri ini mencakup konteks orkestrasi lengkap seperti prompt dengan konfigurasi alat, riwayat percakapan dengan panggilan alat dan hasil, 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 di Penc atatan kesalahan dengan log kesalahan di Amazon Lex V2.

  • Hubungkan pencatatan Pel anggan: Aktifkan Log Hubungkan Pelanggan dengan Mengatur perilaku pencatatan menambahkan blok alur di alur Connect Customer Anda.