Pantau Amazon Q di Connect dengan menggunakan CloudWatch Log - Amazon Connect
Izin IAM yang diperlukanMengaktifkan pencatatanJenis log yang didukungPeriksa kuota CloudWatch LogContoh log asistenContoh kueri umum untuk men-debug log asisten

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

Pantau Amazon Q di Connect dengan menggunakan CloudWatch Log

Untuk mendapatkan visibilitas ke rekomendasi real-time yang diberikan Amazon Q in Connect kepada agen Anda, dan maksud pelanggan yang dideteksi melalui pemahaman bahasa alami, Anda dapat melakukan kueri Log. CloudWatch CloudWatch Log memberi Anda visibilitas ke seluruh perjalanan kontak: percakapan, pemicu, maksud, rekomendasi. Anda juga dapat menggunakan informasi ini untuk debugging, atau memberikannya Dukungan ketika Anda menghubungi mereka untuk meminta bantuan.

Topik ini menjelaskan cara mengaktifkan logging untuk Amazon Q di Connect.

Izin IAM yang diperlukan

Sebelum mengaktifkan pencatatan untuk Amazon Q di Connect assistant, periksa apakah Anda memiliki AWS Identity and Access Management izin berikut. Mereka diperlukan untuk akun pengguna yang masuk ke konsol Amazon Connect:

  • wisdom:AllowVendedLogDeliveryForResource: Diperlukan untuk mengizinkan log dikirimkan ke sumber daya asisten.

Untuk melihat contoh peran IAM dengan semua izin yang diperlukan untuk tujuan pencatatan tertentu, lihat Logging yang memerlukan izin tambahan [V2]. Topik tersebut berisi contoh untuk tujuan pencatatan yang berbeda, seperti log yang dikirim ke CloudWatch Log dan log yang dikirim ke Amazon S3 Contoh menunjukkan cara mengizinkan pembaruan ke sumber daya tujuan pencatatan tertentu.

Aktifkan pencatatan untuk Amazon Q di Connect

Untuk mengaktifkan pencatatan Amazon Q di Connect, Anda menggunakan CloudWatch API. Selesaikan langkah-langkah berikut:

  1. Dapatkan ARN Amazon Q Anda di Connect assistant (juga dikenal sebagai domainnya). Setelah membuat asisten, Anda dapat memperoleh ARN dari konsol Amazon Connect atau dengan memanggil API. GetAssistant ARN mengikuti format ini:

    arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id

  2. Panggilan PutDeliverySource: Gunakan CloudWatch API ini untuk membuat sumber pengiriman untuk asisten. Lewati ARN asisten sebagai. resourceArn UntuklogType, tentukan EVENT_LOGS untuk mengumpulkan log dari asisten Anda.

    {
    "logType": "EVENT_LOGS",
    "name": "your-assistant-delivery-source",
    "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id
}

  3. Panggilan PutDeliveryDestination: Gunakan CloudWatch API ini untuk mengonfigurasi di mana log akan disimpan. Anda dapat memilih CloudWatch Log, Amazon S3, atau Amazon Data Firehose sebagai tujuan untuk menyimpan log. Anda harus menentukan ARN dari salah satu opsi tujuan tempat log Anda disimpan. Anda dapat memilih log untuk menjadi salah satu dari yang berikut:json,plain,w3c,raw,parquet. outputFormat

    Contoh berikut menunjukkan cara mengkonfigurasi log yang akan disimpan dalam Amazon CloudWatch Logs Group dan dalam format JSON.

    {
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*"
    },
    "name": "string",
    "outputFormat": "json",
    "tags": {
        "key": "value"
    }
}

  4. Panggilan CreateDelivery: Gunakan CloudWatch API ini untuk menautkan sumber pengiriman ke tujuan pengiriman yang Anda buat di langkah sebelumnya. Operasi API ini mengaitkan sumber pengiriman dengan tujuan akhir.

    {
    "deliveryDestinationArn": "string",
    "deliverySourceName": "string",
    "tags": {
        "string": "string"
    }
}

Jenis log yang didukung

Amazon Q in Connect mendukung jenis log berikut:

  • EVENT_LOGS: Log yang melacak peristiwa Amazon Q di asisten Connect selama panggilan dan obrolan.

Periksa kuota CloudWatch Log

Sebaiknya periksa titik akhir dan kuota Amazon CloudWatch Logs untuk melihat apakah ada kuota untuk membuat panggilan API terkait pengiriman CloudWatch Log. Kuota menetapkan jumlah maksimum kali Anda dapat memanggil API atau membuat sumber daya. Melebihi batas menghasilkan ServiceQuotaExceededException kesalahan.

Contoh log asisten

Berikut ini adalah contoh log peristiwa. Mungkin ada lebih banyak bidang yang terlihat tergantung pada jenis acara.

{
    "assistant_id": "AssistantId",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION" | "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE" | "TRANSCRIPT_RECOMMENDATION" | "TRANSCRIPT_UTTERANCE" | "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION" | "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "SessionId",
    "session_name": "SessionName",
    "recommendation": "Recommendation",
    "intent": "Intent",
    "prompt": "Prompt",
    "utterance": "Utterance"
}

Mungkin ada lebih banyak bidang yang terlihat tergantung pada jenis acara. Misalnya, acara obrolan atau suara memiliki informasi yang berkaitan dengan ucapan tersebut. Peristiwa yang menghasilkan rekomendasi memiliki informasi tentang maksud, pemicu, atau rekomendasi itu sendiri.

Contoh kueri umum untuk men-debug log asisten

Anda dapat berinteraksi dengan log dengan menggunakan kueri. Misalnya, Anda dapat menanyakan semua peristiwa dalam sesi dengan menggunakanSESSION_NAME.

Berikut ini adalah dua query umum untuk mengembalikan semua log yang dihasilkan untuk sesi tertentu.

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"