Ringkasan dengan bagian kustom

Ringkasan dengan bagian kustom menggunakan LLM untuk meringkas percakapan layanan pelanggan. Model ini mengambil percakapan dan bagian kustom, yang merupakan bagian dari perintah teks yang menentukan tugas yang dilakukan model, untuk kemudian membuat ringkasan.

Anda juga dapat menulis definisi tugas ringkasan Anda sendiri di bagian kustom. Bagian standar dan kustom dijelaskan dalam generator.

Bagian yang telah ditetapkan

Fitur ini menyediakan enam bagian yang telah ditentukan sebelumnya, yang dapat Anda pilih:

  • Situasi. Ini adalah hal yang memerlukan bantuan atau pertanyaan pelanggan.

  • Tindakan. Didefinisikan sebagai tindakan yang dilakukan agen untuk membantu pelanggan.

  • Resolusi. Ada empat opsi.

    • Y: Ya. Semua masalah dan kueri pelanggan telah diselesaikan.
    • P: Sebagian. Hanya beberapa dari beberapa masalah dan kueri pelanggan yang diselesaikan.
    • N: Tidak. Tidak ada masalah dan kueri pelanggan yang diselesaikan.
    • T/A: Tidak ada masalah atau kueri spesifik yang diajukan oleh pelanggan dalam percakapan.
  • Kepuasan pelanggan. Opsi yang tersedia adalah tidak puas atau tidak tidak puas.

    • D: Pelanggan tidak puas atau memiliki perasaan negatif di akhir percakapan.
    • N: Pelanggan bersikap netral atau memiliki perasaan positif di akhir percakapan.
  • Alasan pembatalan. Alasan pembatalan jika pelanggan meminta pembatalan. T/A jika tidak.

  • Entity. Pasangan nilai kunci entitas penting yang diekstrak dari percakapan.

Membuat generator ringkasan

Konsol

Untuk membuat generator ringkasan menggunakan Konsol Agent Assist, lakukan hal berikut:

  1. Di konsol, buka halaman Summarization, lalu pilih Generator.

    Buka Ringkasan

  2. Masukkan nama generator.

  3. Pilih versi generator.

  4. Pilih bahasa output.

  5. Pilih bagian di bagian Bagian standar.

  6. Tambahkan bagian di bagian Bagian kustom: Tentukan tugas ringkasan baru sesuai kebutuhan, secara opsional tambahkan contoh singkat untuk peningkatan.

  7. Klik Simpan.

REST

Untuk membuat generator ringkasan menggunakan API, lakukan hal berikut:

  1. Panggil metode CreateGenerator dari resource Generator.

  2. Masukkan nama generator di kolom description.

  3. Masukkan kode bahasa output generator di kolom output_language_code.

  4. Masukkan peristiwa pemicu MANUAL_CALL.

  5. Pilih bagian yang telah ditentukan sebelumnya dan tambahkan bagian kustom dengan contoh singkat di SummarizationContext.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Cloud Anda
  • LOCATION_ID: ID lokasi Anda

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/generators

Meminta isi JSON:

{
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID",
  "description": "test",
  "triggerEvent": "MANUAL_CALL",
  "summarizationContext": {
    "summarizationSections": [{
      "type": "SITUATION"
    }, {
      "type": "ENTITIES"
    }, {
      "key": "custom_section",
      "definition": "Describe what the customer needs help with or has questions about. If there is an order number mentioned in the conversation, INCLUDE the order number.",
      "type": "CUSTOMER_DEFINED"
    }],
    "version": "2.1",
    "outputLanguageCode": "en-US"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID",
  "description": "test",
  "inferenceParameter": {
    "maxOutputTokens": 1024,
    "temperature": 0.0,
    "topK": 40,
    "topP": 0.8
  },
  "triggerEvent": "MANUAL_CALL",
  "createTime": "2024-05-11T00:28:14.790937126Z",
  "updateTime": "2024-05-11T01:59:15.751724150Z",
  "summarizationContext": {
    "summarizationSections": [{
      "type": "SITUATION"
    }, {
      "type": "ENTITIES"
    }, {
      "key": "custom_section",
      "definition": "Describe what the customer needs help with or has questions about. If there is an order number mentioned in the conversation, INCLUDE the order number.",
      "type": "CUSTOMER_DEFINED"
    }],
    "version": "2.1",
    "outputLanguageCode": "en-US"
  }
}

Menguji generator ringkasan

Dalam konsol, Anda dapat menguji generator di bagian Test generator, seperti yang ditunjukkan pada gambar berikut.

Untuk menguji generator di konsol, lakukan hal berikut:

Konsol

  1. Transkrip percakapan. Anda dapat memasukkan ucapan secara manual atau mengupload transkrip dalam format JSON, seperti yang ditunjukkan pada gambar berikut.

  2. Klik Buat untuk menampilkan ringkasan.

Mengonfigurasi profil percakapan

Profil percakapan mengonfigurasi serangkaian parameter yang mengontrol saran yang diberikan kepada agen selama percakapan. Langkah-langkah berikut akan membuat ConversationProfile dengan objek HumanAgentAssistantConfig.

Contoh berikut menunjukkan cara membuat profil percakapan.

Konsol

  1. Di Konsol Agent Assist, buka halaman Profil percakapan.

  2. Masukkan nama tampilan.

  3. Pilih Ringkasan percakapan (generator) sebagai jenis saran.

  4. Pilih nama generator dari daftar.

REST

  1. Panggil metode create dari resource profil percakapan.

  2. Berikan nama untuk profil percakapan baru.

  3. Masukkan kode bahasa.

  4. Masukkan nama generator di human_agent_suggestion_config.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Cloud Anda
  • LOCATION_ID: ID lokasi Anda
  • CONVERSATION_PROFILE_ID: ID profil percakapan Anda
  • GENERATOR_ID: ID generator Anda

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles

Meminta isi JSON:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "displayName": "conversation-profile-with-generator",
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {
      "generators": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID"
    }
  },
  "languageCode": "en-US"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "displayName": "conversation-profile-with-generator",
  "humanAgentAssistantConfig": {
    "humanAgentSuggestionConfig": {
      "generators": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID"
    }
  },
  "languageCode": "en-US"
}

Memverifikasi dengan simulator

Anda dapat memverifikasi profil percakapan di simulator Bantuan Agen.

Percakapan saat runtime

Pada runtime, saat dialog dimulai antara pengguna dan agen, Anda membuat percakapan, yang merupakan interaksi antara agen (manusia atau virtual) dan pelanggan atau pengguna dukungan. Untuk melihat saran, buat peserta pengguna dan peserta agen, lalu tambahkan mereka ke percakapan.

Membuat percakapan

Untuk membuat percakapan, panggil metode create pada resource Conversation.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Cloud Anda
  • LOCATION_ID: ID lokasi Anda
  • CONVERSATION_PROFILE_ID: ID yang Anda terima saat membuat profil percakapan

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations

Meminta isi JSON:

{
  "conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID",
  "lifecycleState": "IN_PROGRESS",
  "conversationProfile": "projects/PROJECT_ID/locations/LOCATION_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "startTime": "2018-11-05T21:05:45.622Z"
}

Segmen jalur setelah conversations berisi ID percakapan baru Anda.

Membuat peserta pengguna

Untuk membuat peserta pengguna, panggil metode create pada resource Participant. Berikan ID percakapan dan END_USER untuk kolom role.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Cloud Anda
  • LOCATION_ID: ID lokasi Anda
  • CONVERSATION_ID: ID percakapan Anda

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants

Meminta isi JSON:

{
  "role": "END_USER",
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
  "role": "END_USER"
}

Segmen jalur setelah participants berisi ID peserta pengguna baru Anda.

Membuat peserta agen

Panggil metode create pada resource Participant. Berikan ID percakapan dan HUMAN_AGENT atau AUTOMATED_AGENT untuk kolom role.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Cloud Anda
  • LOCATION_ID: ID lokasi Anda
  • CONVERSATION_ID: ID percakapan Anda

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants

Meminta isi JSON:

{
  "role": "HUMAN_AGENT",
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/participants/PARTICIPANT_ID",
  "role": "HUMAN_AGENT"
}

Segmen jalur setelah participants berisi ID peserta agen baru Anda.

Menganalisis pesan

Ada dua cara untuk menganalisis pesan:

  • Selama percakapan. Untuk menambahkan dan menganalisis pesan agen untuk percakapan, panggil metode analyzeContent pada resource Participant. Berikan ID percakapan dan ID peserta agen. Untuk menambahkan dan menganalisis pesan pengguna untuk percakapan, panggil metode analyzeContent pada resource Participant. Berikan ID percakapan dan ID peserta pengguna. Jangan membuat panggilan duplikat ke metode analyzeContent jika dipanggil untuk fitur Dialogflow lainnya.

  • Setelah percakapan. Anda dapat menggunakan opsi ini jika tidak menggunakan metode analyzeContent selama percakapan. Sebagai gantinya, Anda dapat menggunakan metode batchCreate pada resource messages untuk menyerap pesan historis percakapan.

Membuat ringkasan

Anda dapat mendapatkan saran kapan saja untuk pesan terbaru dari salah satu peserta.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Cloud Anda
  • LOCATION_ID: ID lokasi Anda
  • GENERATOR_ID: ID generator Anda

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION_ID/statelessSuggestion:generate

Meminta isi JSON:

{
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID",
  "generatorName": "projects/PROJECT_ID/locations/LOCATION_ID/generators/GENERATOR_ID",
  "conversationContext" {
    "messageEntries": [{
      "role": "HUMAN_AGENT",
      "text": "Hi, this is ABC messaging, how can I help you today?",
      "languageCode": "en-US"
    }, {
      "role": "END_USER",
      "text": "I want to return my order, it is broken",
      "languageCode": "en-US"
    }]
  },
  "triggerEvents": [
    "MANUAL_CALL"
  ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "generatorSuggestion": {
    "summarySuggestion": {
      "summarySections": [
        {
          "section": "situation",
          "summary": "customer wants to return an order."
        },
        {
          "section": "resolution",
          "summary": "N"
        }
      ]
    }
  }
}

Responsnya berisi ringkasan.

Menyelesaikan percakapan

Untuk menyelesaikan percakapan, panggil metode complete pada resource conversations. Berikan ID percakapan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID GCP Anda
  • CONVERSATION_ID: ID yang Anda terima saat membuat percakapan

Metode HTTP dan URL:

POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/conversations/CONVERSATION_ID:complete

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/conversations/CONVERSATION_ID",
  "lifecycleState": "COMPLETED",
  "conversationProfile": "projects/PROJECT_ID/conversationProfiles/CONVERSATION_PROFILE_ID",
  "startTime": "2018-11-05T21:05:45.622Z",
  "endTime": "2018-11-06T03:50:26.930Z"
}

Versi sebelumnya