كيفية استخدام ملخص المحادثة
هام
تعرض منطقة المعاينة الخاصة بنا، سويد سنترال، أحدث تقنيات ضبط LLM المتطورة باستمرار استنادا إلى نماذج GPT. نرحب بتجربتها باستخدام مورد Language في منطقة وسط السويد.
لا يتوفر ملخص المحادثة إلا باستخدام:
- واجهة برمجة تطبيقات REST
- Python
- C#
جوانب تلخيص المحادثة
تم تصميم عنوان الفصل والسرد (المحادثة العامة) لتلخيص محادثة في عناوين الفصول، وتلخيص محتويات المحادثة. يعمل جانب التلخيص هذا على المحادثات مع أي عدد من الأطراف.
تم تصميم المشكلة والدقة (مركز الاتصال المركز عليه) لتلخيص سجلات الدردشة النصية بين العملاء ووكلاء خدمة العملاء. هذه الميزة قادرة على توفير كل من المشكلات والحلول الموجودة في هذه السجلات، والتي تحدث بين طرفين.
تم تصميم السرد لتلخيص سرد المحادثة.
تم تصميم خلاصة لتكاثف الاجتماعات أو المحادثات الطويلة في ملخص موجز من فقرة واحدة لتوفير نظرة عامة سريعة.
تم تصميم مهام المتابعة لتلخيص عناصر الإجراءات والمهام التي تنشأ أثناء الاجتماع.
يتم توفير نماذج الذكاء الاصطناعي التي تستخدمها API بواسطة الخدمة، ما عليك سوى إرسال المحتوى للتحليل.
لتسهيل التنقل، فيما يلي ارتباطات إلى الأقسام المقابلة لكل خدمة:
| الجانب | القسم |
|---|---|
| المشكلة والحل | المشكلة والحل |
| عنوان الفصل | عنوان الفصل |
| السرد | السرد |
| خلاصة ومتابعة | خلاصة ومتابعة |
الميزات
تستخدم واجهة برمجة تطبيقات تلخيص المحادثة تقنيات معالجة اللغة الطبيعية لتلخيص المحادثات في ملخصات أقصر لكل طلب. يمكن تلخيص المحادثة للمشكلات والحلول التي تمت مناقشتها في محادثة من طرفين أو تلخيص محادثة طويلة في فصول وسرد قصير لكل فصل.
هناك ميزة أخرى في لغة الذكاء الاصطناعي Azure المسماة تلخيص نصي أكثر ملاءمة لتلخيص المستندات في ملخصات موجزة. عندما تقرر بين تلخيص النص وتلخيص المحادثة، ضع في اعتبارك النقاط التالية:
- تنسيق الإدخال: يمكن أن يعمل ملخص المحادثة على كل من نص الدردشة ونصوص الكلام، والتي تحتوي على مكبرات صوت وأقوالها. يعمل تلخيص النص باستخدام نص بسيط أو تنسيقات Word أو PDF أو PowerPoint.
- الغرض من التلخيص: على سبيل المثال، ترجع مشكلة المحادثة وتلخيص الحل سببا ودقة الدردشة بين عميل ووكيل خدمة العملاء.
إرسال البيانات
إشعار
راجع مقالة Language Studio للحصول على معلومات حول تنسيق نص المحادثة لإرساله باستخدام Language Studio.
يمكنك إرسال المستندات إلى واجهة برمجة التطبيقات كسلاسل من النص. يتم إجراء التحليل عند استلام الطلب. نظرا لأن واجهة برمجة التطبيقات غير متزامنة، فقد يكون هناك تأخير بين إرسال طلب واجهة برمجة التطبيقات وتلقي النتائج. للحصول على معلومات حول حجم وعدد الطلبات التي يمكنك إرسالها في الدقيقة والثانية، راجع حدود البيانات أدناه.
عند استخدام هذه الميزة، تتوفر نتائج API لمدة 24 ساعة من وقت إدخال الطلب، ويُشار إليه في الرد. بعد هذه الفترة الزمنية، تُزال النتائج ولا تصبح متاحة للاسترجاع.
عند إرسال البيانات إلى ملخص المحادثة، نوصي بإرسال سجل دردشة واحد لكل طلب، للحصول على زمن انتقال أفضل.
الحصول على ملخصات من الدردشات النصية
يمكنك استخدام مشكلة المحادثة وتلخيص الحل للحصول على الملخصات كما تحتاج. للاطلاع على مثال باستخدام الدردشة النصية، راجع مقالة التشغيل السريع.
الحصول على ملخصات من كتابة الكلام
تمكنك أيضا مشكلة المحادثة وتلخيص الدقة من الحصول على ملخصات من نسخ الكلام باستخدام ميزة الكلام إلى النص الخاصة بخدمة الكلام. يوضح المثال التالي محادثة قصيرة قد تقوم بتضمينها في طلبات واجهة برمجة التطبيقات.
"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
}
]
}
}
]
}
]
الحصول على عناوين الفصول
يتيح لك ملخص عنوان فصل المحادثة الحصول على عناوين الفصول من محادثات الإدخال. يتم توفير سيناريو مثال إرشادي أدناه:
- انسخ الأمر أدناه إلى محرر نص. يستخدم
\مثال BASH حرف متابعة السطر. إذا كانت وحدة التحكم أو المحطة الطرفية تستخدم حرف متابعة سطر مختلف، فاستخدم هذا الحرف.
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"
]
}
}
]
}
'
قم بإجراء التغييرات التالية في الأمر عند الحاجة:
- استبدال القيمة
your-value-language-keyبمفتاحك. - استبدل الجزء الأول من عنوان URL للطلب
your-language-resource-endpointبعنوان URL لنقطة النهاية الخاص بك.
- استبدال القيمة
افتح نافذة موجه الأوامر (على سبيل المثال: BASH).
الصق الأمر من محرر النص في نافذة موجه الأوامر، ثم قم بتشغيل الأمر.
احصل على
operation-locationمن عنوان الاستجابة. تبدو القيمة مشابهة ل URL التالي:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- للحصول على نتائج الطلب، استخدم الأمر cURL التالي. تأكد من استبدال
<my-job-id>بقيمة GUID التي تلقيتها من عنوان الاستجابة السابقoperation-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>"
مثال على ملخص عنوان الفصل استجابة JSON:
{
"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"
}
}
]
}
}
للمحادثة الطويلة، قد يقوم النموذج بتقسيمه إلى أجزاء متعددة متماسكة، وتلخيص كل مقطع. هناك أيضا حقل طويل contexts لكل ملخص، والذي يوضح من أي نطاق من محادثة الإدخال أنشأنا الملخص.
الحصول على تلخيص سردي
يتيح لك ملخص المحادثة أيضا الحصول على ملخصات سردية من محادثات الإدخال. يتم توفير سيناريو مثال إرشادي أدناه:
- انسخ الأمر أدناه إلى محرر نص. يستخدم
\مثال BASH حرف متابعة السطر. إذا كانت وحدة التحكم أو المحطة الطرفية تستخدم حرف متابعة سطر مختلف، فاستخدم هذا الحرف.
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"
]
}
}
]
}
'
قم بإجراء التغييرات التالية في الأمر عند الحاجة:
- استبدال القيمة
your-language-resource-keyبمفتاحك. - استبدل الجزء الأول من عنوان URL للطلب
your-language-resource-endpointبعنوان URL لنقطة النهاية الخاص بك.
- استبدال القيمة
افتح نافذة موجه الأوامر (على سبيل المثال: BASH).
الصق الأمر من محرر النص في نافذة موجه الأوامر، ثم قم بتشغيل الأمر.
احصل على
operation-locationمن عنوان الاستجابة. تبدو القيمة مشابهة ل URL التالي:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- للحصول على نتائج الطلب، استخدم الأمر cURL التالي. تأكد من استبدال
<my-job-id>بقيمة GUID التي تلقيتها من عنوان الاستجابة السابقoperation-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>"
مثال على استجابة 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"
}
}
]
}
}
للمحادثة الطويلة، قد يقوم النموذج بتقسيمه إلى أجزاء متعددة متماسكة، وتلخيص كل مقطع. هناك أيضا حقل طويل contexts لكل ملخص، والذي يوضح من أي نطاق من محادثة الإدخال أنشأنا الملخص.
الحصول على ملخص مهمة الخلاصة والمتابعة
يتيح لك ملخص المحادثة أيضا الحصول على ملخصات ومهام المتابعة من محادثات الإدخال. يتم توفير سيناريو مثال إرشادي أدناه:
- انسخ الأمر أدناه إلى محرر نص. يستخدم
\مثال BASH حرف متابعة السطر. إذا كانت وحدة التحكم أو المحطة الطرفية تستخدم حرف متابعة سطر مختلف، فاستخدم هذا الحرف.
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"
]
}
}
]
}
'
قم بإجراء التغييرات التالية في الأمر عند الحاجة:
- استبدال القيمة
your-language-resource-keyبمفتاحك. - استبدل الجزء الأول من عنوان URL للطلب
your-language-resource-endpointبعنوان URL لنقطة النهاية الخاص بك.
- استبدال القيمة
افتح نافذة موجه الأوامر (على سبيل المثال: BASH).
الصق الأمر من محرر النص في نافذة موجه الأوامر، ثم قم بتشغيل الأمر.
احصل على
operation-locationمن عنوان الاستجابة. تبدو القيمة مشابهة ل URL التالي:
https://<your-language-resource-endpoint>/language/analyze-conversations/jobs/12345678-1234-1234-1234-12345678?api-version=2023-11-15-preview
- للحصول على نتائج الطلب، استخدم الأمر cURL التالي. تأكد من استبدال
<my-job-id>بقيمة GUID التي تلقيتها من عنوان الاستجابة السابقoperation-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>"
مثال على خلاصة استجابة JSON لملخص المتابعة والمتابعة:
{
"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"
}
}
]
}
}
للمحادثة الطويلة، قد يقوم النموذج بتقسيمه إلى أجزاء متعددة متماسكة، وتلخيص كل مقطع. هناك أيضا حقل طويل contexts لكل ملخص، والذي يوضح من أي نطاق من محادثة الإدخال أنشأنا الملخص.
الحصول على نتائج تلخيص حل ومشكلة المحادثة
النص التالي هو مثال على المحتوى الذي قد ترسله لمشكلة المحادثة وتلخيص الحل. هذا مثال فقط، يمكن لواجهة برمجة التطبيقات قبول نص إدخال أطول. راجع حدود البيانات لمزيد من المعلومات.
الوكيل: "مرحباً، كيف يمكنني مساعدتك؟"
العميل: "كيف يمكنني ترقية اشتراك Contoso الخاص بي؟ لقد حاولت فعل ذلك طوال اليوم."
العامل: "اضغط على زر الترقية ثم سجل الدخول واتبع الإرشادات."
يتم إجراء التلخيص عند استلام الطلب عن طريق إنشاء وظيفة للواجهة الخلفية لواجهة برمجة التطبيقات. إذا نجحت المهمة، فسيتم إرجاع إخراج واجهة برمجة التطبيقات. الإخراج متاح للاسترداد لمدة 24 ساعة. يُمسح الإخراج بعد هذا الوقت. نظرا لدعم اللغات المتعددة والرموز التعبيرية، قد تحتوي الاستجابة على إزاحات نصية. راجع كيفية معالجة التعويضات لمزيد من المعلومات.
في المثال أعلاه، قد تُرجع API الجمل الملخصة التالية:
| النص الملخص | الجانب |
|---|---|
| "يريد العميل ترقية اشتراكه. العميل لا يعرف كيف يفعل ذلك." | المشكلة |
| "يحتاج العميل إلى الضغط على زر الترقية، وتسجيل الدخول." | الدقة |
(راجع أيضًا )
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ