Memecahkan masalah layanan mandiri Amazon Q di Connect - Amazon Connect
Mengaktifkan pencatatanEskalasi tak terdugaPengakhiran tak terduga

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

Memecahkan masalah layanan mandiri Amazon Q di Connect

Gunakan topik ini untuk membantu mendiagnosis dan menyelesaikan masalah umum dengan Amazon Q di fungsionalitas layanan mandiri Connect.

Aktifkan pencatatan untuk Amazon Q dalam interaksi layanan mandiri Connect

Untuk memecahkan masalah layanan mandiri secara efektif, Anda perlu melihat log untuk Amazon Q di Interaksi swalayan Connect. Gunakan petunjuk berikut untuk mengaktifkan CloudWatch Logging, pencatatan Amazon Lex, dan pencatatan Amazon Connect.

  • CloudWatch Log: Aktifkan CloudWatch Logging untuk Amazon Q in Connect dengan mengikuti langkah-langkahnyaPantau Amazon Q di Connect.

    Interaksi swalayan 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}"
}

  • Amazon Lex logging: Aktifkan pencatatan Amazon Lex dengan mengikuti langkah-langkah kesalahan Logging 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.

Pelanggan tiba-tiba menerima “Eskalasi ke agen...”

Eskalasi agen yang tidak terduga terjadi ketika ada kesalahan selama interaksi bot swalayan atau ketika model tidak menghasilkan tool_use respons yang valid untuk. SELF_SERVICE_PRE_PROCESS

Langkah pemecahan masalah

  1. Periksa Amazon Q di log Connect: Periksa completion atribut di entri log terkait.

  2. Validasi alasan berhenti: Konfirmasikan bahwa stop_reason adatool_use.

  3. Verifikasi respons yang diuraikan: Periksa apakah parsed_response bidang diisi, karena ini mewakili respons yang akan Anda terima dari model.

Masalah yang diketahui dengan Claude 3 Haiku

Jika Anda menggunakan Claude 3 Haiku untuk pra-pemrosesan swalayan, ada masalah yang diketahui di mana ia menghasilkan tool_use JSON sebagai teks, menghasilkan teks dan bukan. stop_reason end_turn tool_use

Solusi: Perbarui prompt khusus Anda untuk membungkus string tool_use JSON di dalam <tool> tag dengan menambahkan instruksi ini:

You MUST enclose the tool_use JSON in the <tool> tag

Obrolan swalayan atau panggilan suara tiba-tiba berakhir

Masalah ini dapat terjadi karena batas waktu atau kesalahan dari Amazon Lex atau konfigurasi Amazon Nova Pro yang salah. Masalah-masalah ini dijelaskan di bawah ini.

Timeout dari Amazon Lex

  • Gejala: Log Amazon Connect menunjukkan “Kesalahan Server Internal” untuk Dapatkan masukan pelanggan blok

  • Penyebab: Bot swalayan Anda habis waktu sambil memberikan hasil dalam batas 10 detik. Kesalahan batas waktu tidak akan muncul di Amazon Q di log Connect.

  • Solusi: Sederhanakan prompt Anda dengan menghapus penalaran yang rumit untuk mengurangi waktu pemrosesan.

Kesalahan dari Amazon Lex

  • Amazon Q tidak ada di blok aliran Connect: Pastikan Anda telah menambahkan Amazon Q di Connect blok ke alur Amazon Connect. Pengawasan umum tidak ada blok ini, yang menghasilkan kesalahan berikut:

    com.amazonaws.services.lexruntimev2.model.ValidationException: Amazon Lex needs active session for Amazon Q in Connect. 
                            Please provide valid session attribute x-amz-lex:q-in-connect:session-arn

  • Kesalahan Umum Amazon Lex: Periksa log Amazon Lex untuk kesalahan apa pun dan atasi dengan tepat.

Konfigurasi Amazon Nova Pro

Jika Anda menggunakan Amazon Nova Pro untuk permintaan AI kustom Anda, pastikan bahwa contoh tool_use mengikuti format yang kompatibel dengan Python.