Wstępnie utworzone odpowiadanie na pytania

Wstępnie utworzone odpowiadanie na pytania zapewnia użytkownikowi możliwość odpowiadania na pytania w ramach fragmentu tekstu bez konieczności tworzenia baz wiedzy, utrzymywania par pytań i odpowiedzi lub ponoszenia kosztów nie w pełni wykorzystywanej infrastruktury. Ta funkcja jest udostępniana jako interfejs API i może służyć do spełnienia wymagań dotyczących pytań i odpowiedzi bez konieczności poznawania szczegółów usługi QnA Maker lub dodatkowego magazynu.

Uwaga

Usługa QnA Maker jest wycofywana 31 marca 2025 r. Nowsza wersja funkcji pytań i odpowiedzi jest teraz dostępna w ramach języka sztucznej inteligencji platformy Azure. Aby uzyskać informacje na temat możliwości odpowiadania na pytania w usłudze językowej, zobacz odpowiadanie na pytania. Od 1 października 2022 r. nie będzie można tworzyć nowych zasobów usługi QnA Maker. Aby uzyskać informacje na temat migrowania istniejących baz wiedzy usługi QnA Maker do odpowiadania na pytania, zapoznaj się z przewodnikiem migracji.

Uwaga

Ta dokumentacja nie dotyczy najnowszej wersji. Aby dowiedzieć się więcej o korzystaniu ze wstępnie utworzonego interfejsu API z najnowszą wersją, zapoznaj się z artykułem dotyczącym wstępnie utworzonego interfejsu API odpowiedzi na pytania.

Biorąc pod uwagę zapytanie użytkownika i blok tekstu/fragmentu, interfejs API zwróci odpowiedź i dokładną odpowiedź (jeśli jest dostępna).

Przykładowe użycie wstępnie utworzonej odpowiedzi na pytanie

Załóżmy, że masz co najmniej jeden blok tekstu, z którego chcesz uzyskać odpowiedzi dla danego pytania. Konwencjonalnie należałoby utworzyć tyle źródeł, ile bloków tekstu. Jednak teraz przy użyciu wstępnie utworzonej odpowiedzi na pytanie można wykonywać zapytania dotyczące bloków tekstu bez konieczności definiowania źródeł zawartości w baza wiedzy.

Niektóre inne scenariusze, w których można użyć wstępnie utworzonego interfejsu API, to:

  • Opracowujesz aplikację czytnika książek elektronicznych dla użytkowników końcowych, która umożliwia im wyróżnianie tekstu, wprowadzanie pytania i znajdowanie odpowiedzi na wyróżniony tekst
  • Rozszerzenie przeglądarki umożliwiające użytkownikom zadawanie pytań dotyczących zawartości aktualnie wyświetlanej na stronie przeglądarki
  • Bot kondycji, który pobiera zapytania od użytkowników i udostępnia odpowiedzi na podstawie zawartości medycznej, którą bot identyfikuje jako najbardziej istotne dla zapytania użytkownika

Poniżej przedstawiono przykładowe żądanie:

Przykładowe żądanie

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

Przykładowe zapytanie dotyczące pojedynczego bloku tekstu

Treść żądania

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

Przykładowa odpowiedź

W powyższej treści żądania wysyłamy zapytanie dotyczące pojedynczego bloku tekstu. Poniżej przedstawiono przykładową odpowiedź odebraną dla powyższego zapytania.

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

Widzimy, że w odpowiedzi interfejsu API otrzymano wiele odpowiedzi. Każda odpowiedź ma określony współczynnik ufności, który pomaga zrozumieć ogólne znaczenie odpowiedzi. Użytkownicy mogą używać tego wskaźnika ufności, aby pokazać odpowiedzi na zapytanie.

Wstępnie utworzone limity interfejsu API

Zapoznaj się z dokumentacją wstępnie utworzonych limitów interfejsu API

Dokumentacja wstępnie utworzonego interfejsu API

Zapoznaj się z dokumentacją referencyjną wstępnie utworzonego interfejsu API , aby poznać parametry wejściowe i wyjściowe wymagane do wywoływania interfejsu API.