Sdílet prostřednictvím


Předem připravená odpověď na otázky

Předem připravená odpověď na otázky poskytuje uživatelům možnost odpovědět na otázku v průběhu textu, aniž by bylo nutné vytvářet znalostní báze, udržovat páry otázek a odpovědí nebo účtují náklady na nedostatečně využitou infrastrukturu. Tato funkce je poskytována jako rozhraní API a dá se použít ke splnění požadavků na otázky a odpovědi, aniž byste se museli dozvědět podrobnosti o službě QnA Maker nebo dalším úložišti.

Poznámka:

Služba QnA Maker se vyřadí z provozu 31. března 2025. Novější verze funkce pro otázky a odpovědi je teď dostupná jako součást jazyka Azure AI. Možnosti odpovídání na otázky v rámci služby Language Service najdete v tématu odpovědi na otázky. Od 1. října 2022 nebudete moct vytvářet nové prostředky služby QnA Maker. Informace o migraci stávajících znalostní báze služby QnA Maker na zodpovězení otázek najdete v průvodci migrací.

Poznámka:

Tato dokumentace se nevztahuje na nejnovější verzi. Další informace o používání předem připraveného rozhraní API s nejnovější verzí najdete v článku s předem připraveným rozhraním API pro odpovědi na otázky.

Vzhledem k uživatelskému dotazu a bloku textu nebo průchodu rozhraní API vrátí odpověď a přesnou odpověď (pokud je k dispozici).

Příklad použití předem připravené odpovědi na otázky

Představte si, že máte jeden nebo více bloků textu, ze kterého chcete získat odpovědi na danou otázku. Obvykle byste museli vytvořit tolik zdrojů jako počet bloků textu. Teď ale s předem připravenými odpověďmi na otázky můžete dotazovat bloky textu, aniž byste museli definovat zdroje obsahu v znalostní báze.

Mezi další scénáře, ve kterých je možné použít předem připravené rozhraní API, patří:

  • Vyvíjíte aplikaci pro čtečku elektronických knih pro koncové uživatele, která jim umožňuje zvýraznit text, zadat otázku a najít odpovědi nad zvýrazněným textem.
  • Rozšíření prohlížeče, které uživatelům umožňuje položit otázku nad obsahem, který se právě zobrazuje na stránce prohlížeče
  • Robot stavu, který přijímá dotazy od uživatelů a poskytuje odpovědi na základě lékařského obsahu, který robot identifikuje jako nejrelevavantnější pro dotaz uživatele

Níže je příklad ukázkové žádosti:

Ukázkový požadavek

POST https://{Endpoint}/qnamaker/v5.0-preview.2/generateanswer

Ukázkový dotaz nad jedním blokem textu

Text požadavku

{
    "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"
}

Ukázková odezva

Ve výše uvedeném textu požadavku se dotazujeme na jeden blok textu. Níže je uvedena ukázková odpověď přijatá pro výše uvedený dotaz.

{
    "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
        }
    ]
}

Vidíme, že jako součást odpovědi rozhraní API se přijímá více odpovědí. Každá odpověď má konkrétní skóre spolehlivosti, které pomáhá pochopit celkovou důležitost odpovědi. Uživatelé můžou toto skóre spolehlivosti využít k zobrazení odpovědí na dotaz.

Předem připravené limity rozhraní API

Navštivte předem připravenou dokumentaci k limitům rozhraní API.

Předem připravené referenční informace k rozhraní API

Informace o vstupních a výstupních parametrech požadovaných pro volání rozhraní API najdete v referenční dokumentaci k rozhraní API s předem připravenými referenčními informacemi.