الإجابة عن السؤال مسبقة الصنع

توفر الإجابة عن الأسئلة التي تم إنشاؤها مسبقًا للمستخدم القدرة على الإجابة عن السؤال عبر مرور النص دون الحاجة إلى إنشاء قاعدة معارف، أو الحفاظ على أزواج الأسئلة والأجوبة أو تكبد تكلفة للبنية الأساسية غير المستغلة بشكل جيد. يتم توفير هذه الوظيفة كواجهة برمجة تطبيقات ويمكن استخدامها لتلبية احتياجات الأسئلة والإجابة دون الحاجة إلى معرفة تفاصيل حول QnA Maker أو التخزين الإضافي.

ملاحظة

سيتم إنهاء خدمة QnA Maker في 31 مارس 2025. يتوفر الآن إصدار أحدث من إمكانية السؤال والإجابة كجزء من Azure الذكاء الاصطناعي 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
        }
    ]
}

نرى أنه يتم تلقي إجابات متعددة كجزء من استجابة واجهة برمجة التطبيقات. تحتوي كل إجابة على درجة ثقة محددة تساعد على فهم الأهمية العامة للإجابة. يمكن للمستخدمين الاستفادة من درجة الثقة هذه لإظهار إجابات الاستعلام.

حدود واجهة برمجة التطبيقات التي تم إنشاؤها مسبقًا

قم بزيارة وثائق حدود واجهة برمجة التطبيقات التي تم إنشاؤها مسبقا

مرجع واجهة برمجة التطبيقات مسبقة الإنشاء

قم بزيارة الوثائق المرجعية لواجهة برمجة التطبيقات التي تم إنشاؤها مسبقًا لفهم معلمات الإدخال والإخراج المطلوبة لاستدعاء واجهة برمجة التطبيقات.