Pantau Amazon Q di Connect dengan menggunakan CloudWatch Log - Amazon Connect
Diperlukan izin IAMMengaktifkan 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 AWS Support ketika Anda menghubungi mereka untuk meminta bantuan.

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

Diperlukan izin IAM

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 IAM peran contoh 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 file CloudWatch API. Selesaikan langkah-langkah berikut:

  1. Dapatkan Amazon Q di Connect assistant (juga dikenal sebagai domainnya). ARN Setelah membuat asisten, Anda bisa mendapatkannya ARN dari konsol Amazon Connect atau dengan menelepon GetAssistantAPI. ARNBerikut format ini:

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

  2. Panggilan PutDeliverySource: Gunakan ini CloudWatch API untuk membuat sumber pengiriman untuk asisten. ARNLewati asisten sebagairesourceArn. 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 ini CloudWatch API untuk mengkonfigurasi 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 salah satu opsi tujuan di mana log Anda akan 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 JSON format.

    {
    "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 ini CloudWatch API untuk menautkan sumber pengiriman ke tujuan pengiriman yang Anda buat di langkah sebelumnya. APIOperasi 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 melakukan panggilan terkait pengiriman CloudWatch Log. API 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"