الإجابة على الأسئلة المعدة مسبقا
توفر الإجابة على الأسئلة المعدة مسبقا للمستخدم القدرة على الإجابة على السؤال عبر مقطع من النص دون الحاجة إلى إنشاء قواعد معرفة أو الحفاظ على أزواج الأسئلة والأجوبة أو تكبد تكلفة للبنية التحتية غير المستغلة بشكل كاف. يتم توفير هذه الوظيفة كواجهة برمجة تطبيقات ويمكن استخدامها لتلبية احتياجات الأسئلة والإجابة دون الحاجة إلى معرفة التفاصيل حول QnA Maker أو التخزين الإضافي.
ملاحظة
سيتم إيقاف خدمة QnA Maker في 31 مارس 2025. يتوفر الآن إصدار أحدث من إمكانية طرح الأسئلة والإجابة عليها كجزء من Azure Cognitive Service for Language. للحصول على إمكانيات الإجابة على الأسئلة داخل خدمة اللغة، راجع الإجابة على الأسئلة. اعتبارا من 1 أكتوبر 2022 ، لن تتمكن من إنشاء موارد QnA Maker جديدة. للحصول على معلومات حول ترحيل قواعد معارف QnA Maker الحالية للإجابة على الأسئلة، راجع دليل الترحيل.
ملاحظة
لا تنطبق هذه الوثائق على أحدث إصدار. لمعرفة المزيد حول استخدام واجهة برمجة التطبيقات المعدة مسبقا مع أحدث إصدار، راجع مقالة واجهة برمجة التطبيقات التي تجيب على الأسئلة المعدة مسبقا.
بالنظر إلى استعلام المستخدم وكتلة من النص / المقطع ، ستعرض واجهة برمجة التطبيقات إجابة وإجابة دقيقة (إن وجدت).
مثال على استخدام الإجابة على الأسئلة المعدة مسبقا
تخيل أن لديك كتلة واحدة أو أكثر من النصوص التي ترغب في الحصول على إجابات لسؤال معين منها. تقليديا ، كان عليك إنشاء العديد من المصادر مثل عدد كتل النص. ومع ذلك ، الآن مع الإجابة على الأسئلة المعدة مسبقا ، يمكنك الاستعلام عن كتل النص دون الحاجة إلى تحديد مصادر المحتوى في قاعدة معارف.
بعض السيناريوهات الأخرى حيث يمكن استخدام واجهة برمجة التطبيقات المعدة مسبقا هي:
- أنت تقوم بتطوير تطبيق قارئ كتاب إلكتروني للمستخدمين النهائيين يسمح لهم بتمييز النص وإدخال سؤال والعثور على إجابات على النص المميز
- إضافة متصفح تسمح للمستخدمين بطرح سؤال حول المحتوى المعروض حاليا على صفحة المتصفح
- روبوت صحي يتلقى الاستفسارات من المستخدمين ويوفر إجابات استنادا إلى المحتوى الطبي الذي يحدده الروبوت على أنه الأكثر صلة باستعلام المستخدم
فيما يلي مثال على طلب عينة:
طلب عينة
POST https://{Endpoint}/qnamaker/v5.0-preview.2/generateanswer
نموذج استعلام عبر كتلة واحدة من النص
نص الطلب
{
"question": "How long it takes to charge surface pro 4?",
"documents": [
{
"text": "### The basics #### Power and charging It takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
"id": "doc1"
}
],
"Language": "en"
}
استجابة عينة
في نص الطلب أعلاه ، نستفسر عن كتلة واحدة من النص. يتم عرض نموذج الرد المستلم للاستعلام أعلاه أدناه ،
{
"answers": [
{
"answer": "### The basics #### Power and charging It takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
"answerSpan": {
"text": "two to four hours",
"score": 0.0,
"startIndex": 47,
"endIndex": 64
},
"score": 0.9599020481109619,
"id": "doc1",
"answerStartIndex": 0,
"answerEndIndex": 390
},
{
"answer": "It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it. You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
"score": 0.06749606877565384,
"id": "doc1",
"answerStartIndex": 129,
"answerEndIndex": 390
},
{
"answer": "You can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges.",
"score": 0.011389964260160923,
"id": "doc1",
"answerStartIndex": 265,
"answerEndIndex": 390
}
]
}
نرى أنه يتم تلقي إجابات متعددة كجزء من استجابة واجهة برمجة التطبيقات. تحتوي كل إجابة على درجة ثقة محددة تساعد على فهم الأهمية العامة للإجابة. يمكن للمستخدمين الاستفادة من درجة الثقة هذه لإظهار الإجابات على الاستعلام.
حدود واجهة برمجة التطبيقات المعدة مسبقا
تفضل بزيارة وثائق حدود واجهة برمجة التطبيقات المعدة مسبقا
مرجع واجهة برمجة التطبيقات الذي تم إنشاؤه مسبقا
تفضل بزيارة الوثائق المرجعية لواجهة برمجة التطبيقات المعدة مسبقا لفهم معلمات الإدخال والإخراج المطلوبة للاتصال بواجهة برمجة التطبيقات.