Konuşma özetlemeyi kullanma
Önemli
Önizleme bölgemiz olan Sweden Central, GPT modellerini temel alan en son ve sürekli gelişen LLM ince ayar tekniklerimizi gösterir. Bunları İsveç Orta bölgesindeki bir Dil kaynağıyla deneyebilirsiniz.
Konuşma özetlemesi yalnızca şu şekilde kullanılabilir:
- REST API
- Python
- C#
Konuşma özetleme özellikleri
Bölüm başlığı ve anlatı (genel konuşma), bir konuşmayı bölüm başlıkları halinde özetlemek ve konuşma içeriğini özetlemek için tasarlanmıştır. Bu özetleme özelliği, herhangi bir sayıda tarafla yapılan konuşmalar üzerinde çalışır.
Sorun ve çözüm (çağrı merkezi odaklı), müşterilerle müşteri hizmetleri aracıları arasındaki metin sohbeti günlüklerini özetlemek için tasarlanmıştır. Bu özellik, bu günlüklerde bulunan ve iki taraf arasında oluşan hem sorunları hem de çözümleri sağlayabilmektedir.
Anlatı, bir konuşmanın anlatımını özetlemek için tasarlanmıştır.
Özet, hızlı bir genel bakış sağlamak üzere uzun toplantıları veya konuşmaları kısa bir tek paragraflık özet halinde daraltmak için tasarlanmıştır.
İzleme görevleri, toplantı sırasında ortaya çıkan eylem öğelerini ve görevleri özetlemek için tasarlanmıştır.
API tarafından kullanılan yapay zeka modelleri hizmet tarafından sağlanır, yalnızca analiz için içerik göndermeniz gerekir.
Daha kolay gezinmek için, her hizmet için ilgili bölümlerin bağlantıları aşağıdadır:
| Görünüş | Section |
|---|---|
| Sorun ve Çözüm | Sorun ve Çözüm |
| Bölüm Başlığı | Bölüm Başlığı |
| Açıklama | Anlatı |
| Özet ve İzleme | Özetleme ve izleme |
Özellikler
Konuşma özetleme API'sinde konuşmaları istek başına daha kısa özetler halinde özetlemek için doğal dil işleme teknikleri kullanılır. Konuşma özetlemesi, iki taraflı bir konuşmada ele alınan sorunlar ve çözümler için özetlenebilir veya uzun bir konuşmayı bölümler ve her bölüm için kısa bir anlatı halinde özetleyebilir.
Azure AI Language'de belge özetleme adlı ve belgeleri kısa özetlere ayırmaya daha uygun olan başka bir özellik vardır. Belge özetlemesi ve konuşma özetlemesi arasında karar verirken aşağıdaki noktaları göz önünde bulundurun:
- Giriş biçimi: Konuşma özetlemesi hem sohbet metni hem de konuşma transkriptleri üzerinde çalışabilir ve bunlar konuşmacılar ve konuşmaları içerir. Belge özetlemesi basit metin veya Word, PDF veya PowerPoint biçimleri kullanılarak çalışır.
- Özetlemenin amacı: Örneğin, konuşma sorunu ve çözüm özetleme, bir müşteri ile müşteri hizmetleri aracısı arasındaki sohbetin nedenini ve çözümünü döndürür.
Veri gönderme
Not
Language Studio kullanarak göndermek üzere konuşma metnini biçimlendirme hakkında bilgi için Language Studio makalesine bakın.
Belgeleri API'ye metin dizesi olarak gönderirsiniz. İstek alındığında analiz gerçekleştirilir. API zaman uyumsuz olduğundan, API isteği gönderme ile sonuçları alma arasında bir gecikme olabilir. Dakika ve saniye başına gönderebileceğiniz isteklerin boyutu ve sayısı hakkında bilgi için aşağıdaki veri sınırlarına bakın.
Bu özelliği kullandığınızda API sonuçları, isteğin alındığı zamandan itibaren 24 saat boyunca kullanılabilir ve yanıtta belirtilir. Bu zaman aralığından sonra sonuçlar temizlenir ve artık alınamayacaktır.
Konuşma özetlemesine veri gönderdiğinizde, daha iyi gecikme süresi için istek başına bir sohbet günlüğü göndermenizi öneririz.
Metin sohbetlerinden özetler alma
İhtiyacınız olan özetleri almak için konuşma sorununu ve çözüm özetlemeyi kullanabilirsiniz. Metin sohbetlerini kullanan bir örneği görmek için hızlı başlangıç makalesine bakın.
Konuşma transkripsiyonlarından özetleri alma
Konuşma sorunu ve çözüm özetlemesi, Konuşma hizmetinin konuşmayı metne dönüştürme özelliğini kullanarak konuşma transkriptlerinden özetler almanıza da olanak tanır. Aşağıdaki örnekte, API isteklerinize dahil edebileceğiniz kısa bir konuşma gösterilmektedir.
"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
}
]
}
}
]
}
]
Bölüm başlıklarını alma
Konuşma bölümü başlığı özetlemesi, giriş konuşmalarından bölüm başlıkları almanıza olanak tanır. Aşağıda kılavuzlu bir örnek senaryo verilmiştir:
- Aşağıdaki komutu bir metin düzenleyicisine kopyalayın. BASH örneği satır devamlılığı karakterini kullanır
\. Konsolunuz veya terminaliniz farklı bir satır devamlılığı karakteri kullanıyorsa bu karakteri kullanın.
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"
]
}
}
]
}
'
Gerektiğinde komutta aşağıdaki değişiklikleri yapın:
- değerini
your-value-language-keyanahtarınız ile değiştirin. - İstek URL'sinin ilk bölümünü uç nokta URL'nizle
your-language-resource-endpointdeğiştirin.
- değerini
Bir komut istemi penceresi açın (örneğin: BASH).
Metin düzenleyicisindeki komutu komut istemi penceresine yapıştırın ve ardından komutunu çalıştırın.
operation-locationYanıt üst bilgisinden öğesini alın. Değer aşağıdaki URL'ye benzer:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- İsteğin sonuçlarını almak için aşağıdaki cURL komutunu kullanın. değerini önceki
operation-locationyanıt üst bilgisinden aldığınız GUID değeriyle değiştirdiğinizden<my-job-id>emin olun:
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>"
Örnek bölüm başlığı özetleme JSON yanıtı:
{
"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"
}
}
]
}
}
Uzun konuşmalar için model bunu birden çok uyumlu bölüme ayırabilir ve her segmenti özetler. Ayrıca her özet için, özeti hangi giriş konuşma aralığından oluşturduğumuza ilişkin bilgi veren uzun contexts bir alan vardır.
Anlatı özetlemeyi alma
Konuşma özetleme, giriş konuşmalarından anlatı özetleri almanıza da olanak tanır. Aşağıda kılavuzlu bir örnek senaryo verilmiştir:
- Aşağıdaki komutu bir metin düzenleyicisine kopyalayın. BASH örneği satır devamlılığı karakterini kullanır
\. Konsolunuz veya terminaliniz farklı bir satır devamlılığı karakteri kullanıyorsa bu karakteri kullanın.
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"
]
}
}
]
}
'
Gerektiğinde komutta aşağıdaki değişiklikleri yapın:
- değerini
your-language-resource-keyanahtarınız ile değiştirin. - İstek URL'sinin ilk bölümünü uç nokta URL'nizle
your-language-resource-endpointdeğiştirin.
- değerini
Bir komut istemi penceresi açın (örneğin: BASH).
Metin düzenleyicisindeki komutu komut istemi penceresine yapıştırın ve ardından komutunu çalıştırın.
operation-locationYanıt üst bilgisinden öğesini alın. Değer aşağıdaki URL'ye benzer:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- bir isteğin sonuçlarını almak için aşağıdaki cURL komutunu kullanın. değerini önceki
operation-locationyanıt üst bilgisinden aldığınız GUID değeriyle değiştirdiğinizden<my-job-id>emin olun:
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>"
Örnek anlatı özetleme JSON yanıtı:
{
"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"
}
}
]
}
}
Uzun konuşmalar için model bunu birden çok uyumlu bölüme ayırabilir ve her segmenti özetler. Ayrıca her özet için, özeti hangi giriş konuşma aralığından oluşturduğumuza ilişkin bilgi veren uzun contexts bir alan vardır.
Özetleme ve izleme görevi özetlemeyi alma
Konuşma özetleme, giriş konuşmalarından özetlemeler ve izleme görevleri almanıza da olanak tanır. Aşağıda kılavuzlu bir örnek senaryo verilmiştir:
- Aşağıdaki komutu bir metin düzenleyicisine kopyalayın. BASH örneği satır devamlılığı karakterini kullanır
\. Konsolunuz veya terminaliniz farklı bir satır devamlılığı karakteri kullanıyorsa bu karakteri kullanın.
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"
]
}
}
]
}
'
Gerektiğinde komutta aşağıdaki değişiklikleri yapın:
- değerini
your-language-resource-keyanahtarınız ile değiştirin. - İstek URL'sinin ilk bölümünü uç nokta URL'nizle
your-language-resource-endpointdeğiştirin.
- değerini
Bir komut istemi penceresi açın (örneğin: BASH).
Metin düzenleyicisindeki komutu komut istemi penceresine yapıştırın ve ardından komutunu çalıştırın.
operation-locationYanıt üst bilgisinden öğesini alın. Değer aşağıdaki URL'ye benzer:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- bir isteğin sonuçlarını almak için aşağıdaki cURL komutunu kullanın. değerini önceki
operation-locationyanıt üst bilgisinden aldığınız GUID değeriyle değiştirdiğinizden<my-job-id>emin olun:
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>"
Örnek özetleme ve izleme özetleme JSON yanıtı:
{
"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"
}
}
]
}
}
Uzun konuşmalar için model bunu birden çok uyumlu bölüme ayırabilir ve her segmenti özetler. Ayrıca her özet için, özeti hangi giriş konuşma aralığından oluşturduğumuza ilişkin bilgi veren uzun contexts bir alan vardır.
Konuşma sorununu ve çözüm özetleme sonuçlarını alma
Aşağıdaki metin, konuşma sorunu ve çözüm özetlemesi için gönderebileceğin bir içerik örneğidir. Bu yalnızca bir örnektir; API daha uzun giriş metni kabul edebilir. Daha fazla bilgi için bkz . veri sınırları .
Aracı: "Merhaba, size nasıl yardımcı olabilirim?"
Müşteri: "Contoso aboneliğimi nasıl yükseltebilirim? Bütün gün denedim."
Aracı: "Yükseltme düğmesine basın, sonra oturum açın ve yönergeleri izleyin."
Özetleme, isteğin alınması üzerine API arka ucu için bir iş oluşturularak gerçekleştirilir. İş başarılı olursa API'nin çıkışı döndürülür. Çıkış 24 saat boyunca alınabilir. Bu süreden sonra çıkış temizlenir. Çok dilli ve emoji desteği nedeniyle yanıtta metin uzaklıkları olabilir. Daha fazla bilgi için bkz . uzaklıkları işleme.
Yukarıdaki örnekte API aşağıdaki özetlenmiş cümleleri döndürebilir:
| Özetlenmiş metin | Görünüş |
|---|---|
| "Müşteri aboneliğini yükseltmek istiyor. Müşteri nasıl yapılacağını bilmiyor." | Sorunu |
| "Müşterinin yükseltme düğmesine basması ve oturum açması gerekiyor." | çözüm |