Cara menggunakan ringkasan percakapan
Penting
Wilayah pratinjau kami, Swedia Tengah, menampilkan teknik penyetelan halus LLM terbaru dan terus berkembang berdasarkan model GPT. Anda dipersilakan untuk mencobanya dengan sumber daya Bahasa di wilayah Swedia Tengah.
Ringkasan percakapan hanya tersedia dengan:
- REST API
- Python
- C#
Aspek ringkasan percakapan
Judul bab dan narasi (percakapan umum) dirancang untuk meringkas percakapan ke dalam judul bab, dan ringkasan konten percakapan. Aspek ringkasan ini berfungsi pada percakapan dengan sejumlah pihak.
Masalah dan resolusi (pusat panggilan berfokus) dirancang untuk meringkas log obrolan teks antara pelanggan dan agen layanan pelanggan. Fitur ini mampu menyediakan masalah dan resolusi yang ada dalam log ini, yang terjadi antara dua pihak.
Narasi dirancang untuk meringkas narasi percakapan.
Rekap dirancang untuk mengembun rapat atau percakapan yang panjang ke dalam ringkasan satu paragraf ringkas untuk memberikan gambaran umum singkat.
Tugas tindak lanjut dirancang untuk meringkas item tindakan dan tugas yang muncul selama rapat.
Model AI yang digunakan oleh API disediakan oleh layanan, Anda hanya perlu mengirim konten untuk analisis.
Untuk navigasi yang lebih mudah, berikut adalah tautan ke bagian yang sesuai untuk setiap layanan:
| Aspek | Bagian |
|---|---|
| Masalah dan Resolusi | Masalah dan Resolusi |
| Judul Bab | Judul Bab |
| Narasi | Narasi |
| Rekap dan Tindak Lanjut | Rekap dan tindak lanjut |
Fitur
API ringkasan percakapan menggunakan teknik pemrosesan bahasa alami untuk meringkas percakapan menjadi ringkasan yang lebih pendek per permintaan. Ringkasan percakapan dapat meringkas masalah dan resolusi yang dibahas dalam percakapan dua pihak atau meringkas percakapan panjang menjadi bab dan narasi singkat untuk setiap bab.
Ada fitur lain dalam Ringkasan dokumen bernama Bahasa Azure AI yang lebih cocok untuk meringkas dokumen menjadi ringkasan ringkasan ringkas. Saat Anda akan memilih antara ringkasan dokumen dan ringkasan percakapan, pertimbangkan hal berikut:
- Format input: Ringkasan percakapan dapat beroperasi pada transkrip teks obrolan dan ucapan, yang memiliki pembicara dan ucapannya. Ringkasan dokumen beroperasi menggunakan format teks sederhana, atau Word, PDF, atau PowerPoint.
- Tujuan ringkasan: misalnya, masalah percakapan dan ringkasan resolusi mengembalikan alasan dan resolusi untuk obrolan antara pelanggan dan agen layanan pelanggan.
Mengirimkan data
Catatan
Lihat artikel Language Studio untuk informasi tentang memformat teks percakapan untuk dikirim menggunakan Language Studio.
Anda mengirimkan dokumen ke API sebagai string teks. Analisis dilakukan setelah permintaan diterima. Karena API tidak sinkron, mungkin ada penundaan antara mengirim permintaan API dan menerima hasilnya. Untuk informasi tentang ukuran dan jumlah permintaan yang dapat Anda kirim per menit dan detik, lihat batas data di bawah ini.
Saat Anda menggunakan fitur ini, hasil API tersedia selama 24 jam sejak permintaan diolah, dan hasil tersebut ditunjukkan dalam respons. Setelah jangka waktu ini, hasilnya akan dihapus menyeluruh dan tidak lagi tersedia untuk diambil.
Saat Anda mengirimkan data ke ringkasan percakapan, sebaiknya kirim satu catatan obrolan per permintaan, untuk latensi yang lebih baik.
Dapatkan ringkasan dari obrolan teks
Anda dapat menggunakan ringkasan masalah dan resolusi percakapan untuk mendapatkan ringkasan sesuai kebutuhan Anda. Untuk melihat contoh menggunakan obrolan teks, lihat artikel mulai cepat.
Dapatkan ringkasan dari transkripsi ucapan
Ringkasan masalah dan resolusi percakapan juga memungkinkan Anda mendapatkan ringkasan dari transkrip ucapan dengan menggunakan fitur ucapan ke teks layanan Ucapan. Contoh berikut menunjukkan percakapan singkat yang mungkin Anda sertakan dalam permintaan API Anda.
"conversations":[
{
"id":"abcdefgh-1234-1234-1234-1234abcdefgh",
"language":"en",
"modality":"transcript",
"conversationItems":[
{
"modality":"transcript",
"participantId":"speaker",
"id":"12345678-abcd-efgh-1234-abcd123456",
"content":{
"text":"Hi.",
"lexical":"hi",
"itn":"hi",
"maskedItn":"hi",
"audioTimings":[
{
"word":"hi",
"offset":4500000,
"duration":2800000
}
]
}
}
]
}
]
Mendapatkan judul bab
Ringkasan judul bab percakapan memungkinkan Anda mendapatkan judul bab dari percakapan input. Contoh skenario terpandu disediakan di bawah ini:
- Salin perintah di bawah ini ke editor teks. Contoh BASH menggunakan karakter kelanjutan
\baris. Jika konsol atau terminal Anda menggunakan karakter kelanjutan baris yang berbeda, silakan gunakan karakter tersebut.
curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-conversations/jobs?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
"displayName": "Conversation Task Example",
"analysisInput": {
"conversations": [
{
"conversationItems": [
{
"text": "Hello, you’re chatting with Rene. How may I help you?",
"id": "1",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Hi, I tried to set up wifi connection for Smart Brew 300 espresso machine, but it didn’t work.",
"id": "2",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m sorry to hear that. Let’s see what we can do to fix this issue. Could you please try the following steps for me? First, could you push the wifi connection button, hold for 3 seconds, then let me know if the power light is slowly blinking on and off every second?",
"id": "3",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Yes, I pushed the wifi connection button, and now the power light is slowly blinking.",
"id": "4",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "Great. Thank you! Now, please check in your Contoso Coffee app. Does it prompt to ask you to connect with the machine? ",
"id": "5",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "No. Nothing happened.",
"id": "6",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m very sorry to hear that. Let me see if there’s another way to fix the issue. Please hold on for a minute.",
"id": "7",
"role": "Agent",
"participantId": "Agent_1"
}
],
"modality": "text",
"id": "conversation1",
"language": "en"
}
]
},
"tasks": [
{
"taskName": "Conversation Task 1",
"kind": "ConversationalSummarizationTask",
"parameters": {
"summaryAspects": [
"chapterTitle"
]
}
}
]
}
'
JIka diperlukan, buat perubahan berikut dalam perintah:
- Ganti nilai
your-value-language-keydengan kunci Anda. - Ganti bagian pertama URL permintaan
your-language-resource-endpointdengan URL titik akhir Anda sendiri.
- Ganti nilai
Buka jendela prompt perintah (misalnya: BASH).
Tempelkan perintah dari editor teks ke jendela prompt perintah, lalu jalankan perintah .
Dapatkan
operation-locationdari header respon. Nilainya terlihat mirip dengan URL berikut:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- Untuk mendapatkan hasil permintaan, gunakan perintah cURL berikut. Pastikan untuk mengganti
<my-job-id>dengan nilai GUID yang Anda terima dari header respons sebelumnyaoperation-location:
curl -X GET https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/<my-job-id>?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>"
Contoh respons JSON ringkasan judul bab:
{
"jobId": "b01af3b7-1870-460a-9e36-09af28d360a1",
"lastUpdatedDateTime": "2023-11-15T18:24:26Z",
"createdDateTime": "2023-11-15T18:24:23Z",
"expirationDateTime": "2023-11-16T18:24:23Z",
"status": "succeeded",
"errors": [],
"displayName": "Conversation Task Example",
"tasks": {
"completed": 1,
"failed": 0,
"inProgress": 0,
"total": 1,
"items": [
{
"kind": "conversationalSummarizationResults",
"taskName": "Conversation Task 1",
"lastUpdateDateTime": "2023-11-15T18:24:26.3433677Z",
"status": "succeeded",
"results": {
"conversations": [
{
"summaries": [
{
"aspect": "chapterTitle",
"text": "\"Discussing the Problem of Smart Blend 300 Espresso Machine's Wi-Fi Connectivity\"",
"contexts": [
{
"conversationItemId": "1",
"offset": 0,
"length": 53
},
{
"conversationItemId": "2",
"offset": 0,
"length": 94
},
{
"conversationItemId": "3",
"offset": 0,
"length": 266
},
{
"conversationItemId": "4",
"offset": 0,
"length": 85
},
{
"conversationItemId": "5",
"offset": 0,
"length": 119
},
{
"conversationItemId": "6",
"offset": 0,
"length": 21
},
{
"conversationItemId": "7",
"offset": 0,
"length": 109
}
]
}
],
"id": "conversation1",
"warnings": []
}
],
"errors": [],
"modelVersion": "latest"
}
}
]
}
}
Untuk percakapan panjang, model mungkin mensegmentasinya menjadi beberapa bagian kohesif, dan meringkas setiap segmen. Ada juga bidang panjang contexts untuk setiap ringkasan, yang memberi tahu dari rentang percakapan input mana yang kami buat ringkasannya.
Dapatkan ringkasan narasi
Ringkasan percakapan juga memungkinkan Anda mendapatkan ringkasan narasi dari percakapan input. Contoh skenario terpandu disediakan di bawah ini:
- Salin perintah di bawah ini ke editor teks. Contoh BASH menggunakan karakter kelanjutan
\baris. Jika konsol atau terminal Anda menggunakan karakter kelanjutan baris yang berbeda, silakan gunakan karakter tersebut.
curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-conversations/jobs?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
"displayName": "Conversation Task Example",
"analysisInput": {
"conversations": [
{
"conversationItems": [
{
"text": "Hello, you’re chatting with Rene. How may I help you?",
"id": "1",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Hi, I tried to set up wifi connection for Smart Brew 300 espresso machine, but it didn’t work.",
"id": "2",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m sorry to hear that. Let’s see what we can do to fix this issue. Could you please try the following steps for me? First, could you push the wifi connection button, hold for 3 seconds, then let me know if the power light is slowly blinking on and off every second?",
"id": "3",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Yes, I pushed the wifi connection button, and now the power light is slowly blinking.",
"id": "4",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "Great. Thank you! Now, please check in your Contoso Coffee app. Does it prompt to ask you to connect with the machine? ",
"id": "5",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "No. Nothing happened.",
"id": "6",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m very sorry to hear that. Let me see if there’s another way to fix the issue. Please hold on for a minute.",
"id": "7",
"role": "Agent",
"participantId": "Agent_1"
}
],
"modality": "text",
"id": "conversation1",
"language": "en"
}
]
},
"tasks": [
{
"taskName": "Conversation Task 1",
"kind": "ConversationalSummarizationTask",
"parameters": {
"summaryAspects": [
"narrative"
]
}
}
]
}
'
JIka diperlukan, buat perubahan berikut dalam perintah:
- Ganti nilai
your-language-resource-keydengan kunci Anda. - Ganti bagian pertama URL permintaan
your-language-resource-endpointdengan URL titik akhir Anda sendiri.
- Ganti nilai
Buka jendela prompt perintah (misalnya: BASH).
Tempelkan perintah dari editor teks ke jendela prompt perintah, lalu jalankan perintah .
Dapatkan
operation-locationdari header respon. Nilainya terlihat mirip dengan URL berikut:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- Untuk mendapatkan hasil permintaan, gunakan perintah cURL berikut. Pastikan untuk mengganti
<my-job-id>dengan nilai GUID yang Anda terima dari header respons sebelumnyaoperation-location:
curl -X GET https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/<my-job-id>?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>"
Contoh ringkasan narasi respons JSON:
{
"jobId": "d874a98c-bf31-4ac5-8b94-5c236f786754",
"lastUpdatedDateTime": "2022-09-29T17:36:42Z",
"createdDateTime": "2022-09-29T17:36:39Z",
"expirationDateTime": "2022-09-30T17:36:39Z",
"status": "succeeded",
"errors": [],
"displayName": "Conversation Task Example",
"tasks": {
"completed": 1,
"failed": 0,
"inProgress": 0,
"total": 1,
"items": [
{
"kind": "conversationalSummarizationResults",
"taskName": "Conversation Task 1",
"lastUpdateDateTime": "2022-09-29T17:36:42.895694Z",
"status": "succeeded",
"results": {
"conversations": [
{
"summaries": [
{
"aspect": "narrative",
"text": "Agent_1 helps customer to set up wifi connection for Smart Brew 300 espresso machine.",
"contexts": [
{ "conversationItemId": "1", "offset": 0, "length": 53 },
{ "conversationItemId": "2", "offset": 0, "length": 94 },
{ "conversationItemId": "3", "offset": 0, "length": 266 },
{ "conversationItemId": "4", "offset": 0, "length": 85 },
{ "conversationItemId": "5", "offset": 0, "length": 119 },
{ "conversationItemId": "6", "offset": 0, "length": 21 },
{ "conversationItemId": "7", "offset": 0, "length": 109 }
]
}
],
"id": "conversation1",
"warnings": []
}
],
"errors": [],
"modelVersion": "latest"
}
}
]
}
}
Untuk percakapan panjang, model mungkin mensegmentasinya menjadi beberapa bagian kohesif, dan meringkas setiap segmen. Ada juga bidang panjang contexts untuk setiap ringkasan, yang memberi tahu dari rentang percakapan input mana yang kami buat ringkasannya.
Dapatkan ringkasan tugas rekap dan tindak lanjut
Ringkasan percakapan juga memungkinkan Anda mendapatkan rekap dan tugas tindak lanjut dari percakapan input. Contoh skenario terpandu disediakan di bawah ini:
- Salin perintah di bawah ini ke editor teks. Contoh BASH menggunakan karakter kelanjutan
\baris. Jika konsol atau terminal Anda menggunakan karakter kelanjutan baris yang berbeda, silakan gunakan karakter tersebut.
curl -i -X POST https://<your-language-resource-endpoint>/language/analyze-conversations/jobs?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>" \
-d \
'
{
"displayName": "Conversation Task Example",
"analysisInput": {
"conversations": [
{
"conversationItems": [
{
"text": "Hello, you’re chatting with Rene. How may I help you?",
"id": "1",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Hi, I tried to set up wifi connection for Smart Brew 300 espresso machine, but it didn’t work.",
"id": "2",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m sorry to hear that. Let’s see what we can do to fix this issue. Could you please try the following steps for me? First, could you push the wifi connection button, hold for 3 seconds, then let me know if the power light is slowly blinking on and off every second?",
"id": "3",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "Yes, I pushed the wifi connection button, and now the power light is slowly blinking.",
"id": "4",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "Great. Thank you! Now, please check in your Contoso Coffee app. Does it prompt to ask you to connect with the machine? ",
"id": "5",
"role": "Agent",
"participantId": "Agent_1"
},
{
"text": "No. Nothing happened.",
"id": "6",
"role": "Customer",
"participantId": "Customer_1"
},
{
"text": "I’m very sorry to hear that. Let me see if there’s another way to fix the issue. Please hold on for a minute.",
"id": "7",
"role": "Agent",
"participantId": "Agent_1"
}
],
"modality": "text",
"id": "conversation1",
"language": "en"
}
]
},
"tasks": [
{
"taskName": "Conversation Task 1",
"kind": "ConversationalSummarizationTask",
"parameters": {
"summaryAspects": [
"recap",
"follow-up tasks"
]
}
}
]
}
'
JIka diperlukan, buat perubahan berikut dalam perintah:
- Ganti nilai
your-language-resource-keydengan kunci Anda. - Ganti bagian pertama URL permintaan
your-language-resource-endpointdengan URL titik akhir Anda sendiri.
- Ganti nilai
Buka jendela prompt perintah (misalnya: BASH).
Tempelkan perintah dari editor teks ke jendela prompt perintah, lalu jalankan perintah .
Dapatkan
operation-locationdari header respon. Nilainya terlihat mirip dengan URL berikut:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- Untuk mendapatkan hasil permintaan, gunakan perintah cURL berikut. Pastikan untuk mengganti
<my-job-id>dengan nilai GUID yang Anda terima dari header respons sebelumnyaoperation-location:
curl -X GET https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/<my-job-id>?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-language-resource-key>"
Contoh respons JSON ringkasan rekap dan tindak lanjut:
{
"jobId": "e585d097-c19a-466e-8f99-a9646e55b1f5",
"lastUpdatedDateTime": "2023-11-15T18:19:56Z",
"createdDateTime": "2023-11-15T18:19:53Z",
"expirationDateTime": "2023-11-16T18:19:53Z",
"status": "succeeded",
"errors": [],
"displayName": "Conversation Task Example",
"tasks": {
"completed": 1,
"failed": 0,
"inProgress": 0,
"total": 1,
"items": [
{
"kind": "conversationalSummarizationResults",
"taskName": "Conversation Task 1",
"lastUpdateDateTime": "2023-11-15T18:19:56.1801785Z",
"status": "succeeded",
"results": {
"conversations": [
{
"summaries": [
{
"aspect": "recap",
"text": "The customer contacted the service agent, Rene, regarding an issue with setting up a wifi connection for their Smart Brew 300 espresso machine. The agent guided the customer through several steps, including pushing the wifi connection button and checking if the power light was blinking. However, the customer reported that no prompts were received in the Contoso Coffee app to connect with the machine. The agent then decided to look for another solution.",
"contexts": [
{
"conversationItemId": "1",
"offset": 0,
"length": 53
},
{
"conversationItemId": "2",
"offset": 0,
"length": 94
},
{
"conversationItemId": "3",
"offset": 0,
"length": 266
},
{
"conversationItemId": "4",
"offset": 0,
"length": 85
},
{
"conversationItemId": "5",
"offset": 0,
"length": 119
},
{
"conversationItemId": "6",
"offset": 0,
"length": 21
},
{
"conversationItemId": "7",
"offset": 0,
"length": 109
}
]
},
{
"aspect": "Follow-Up Tasks",
"text": "@Agent_1 will ask the customer to push the wifi connection button, hold for 3 seconds, then check if the power light is slowly blinking on and off every second."
},
{
"aspect": "Follow-Up Tasks",
"text": "@Agent_1 will ask the customer to check in the Contoso Coffee app if it prompts to connect with the machine."
},
{
"aspect": "Follow-Up Tasks",
"text": "@Agent_1 will investigate another way to fix the issue."
}
],
"id": "conversation1",
"warnings": []
}
],
"errors": [],
"modelVersion": "latest"
}
}
]
}
}
Untuk percakapan panjang, model mungkin mensegmentasinya menjadi beberapa bagian kohesif, dan meringkas setiap segmen. Ada juga bidang panjang contexts untuk setiap ringkasan, yang memberi tahu dari rentang percakapan input mana yang kami buat ringkasannya.
Mendapatkan hasil ringkasan masalah dan resolusi percakapan
Teks berikut adalah contoh konten yang mungkin Anda kirimkan untuk masalah percakapan dan ringkasan resolusi. Ini hanya contoh, API dapat menerima teks input yang lebih panjang. Lihat batas data untuk informasi selengkapnya.
Agen: "Halo, bagaimana saya bisa membantu Anda?"
Pelanggan: "Bagaimana cara meningkatkan langganan Contoso saya? Aku sudah berusaha sepanjang hari."
Agen: "Tekan tombol peningkatan lalu masuk dan ikuti instruksi."
Ringkasan dijalankan setelah menerima permintaan dengan membuat pekerjaan untuk backend API. Jika pekerjaan berhasil, output dari API akan dikembalikan. Output tersedia untuk pengambilan selama 24 jam. Setelah waktu ini, output akan dihapus secara menyeluruh. Karena dukungan multibahasa dan emoji, respons mungkin berisi offset teks. Lihat cara memproses offsets untuk informasi lebih lanjut.
Dalam contoh di atas, API mungkin mengembalikan kalimat ringkasan berikut:
| Teks yang diringkas | Aspek |
|---|---|
| "Pelanggan ingin meningkatkan langganan mereka. Pelanggan tidak tahu caranya." | masalah |
| "Pelanggan perlu menekan tombol peningkatan, dan masuk." | resolusi |