Udostępnij za pośrednictwem


Wstępnie utworzone odpowiedzi na pytania

Wstępnie utworzone odpowiadanie na pytania zapewnia użytkownikowi możliwość odpowiadania na pytanie w ramach fragmentu tekstu bez konieczności tworzenia baz wiedzy, utrzymywania par pytań i odpowiedzi lub ponoszenia kosztów niedostatecznie 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ć odpowiedzi 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 baza wiedzy usługi QnA Maker do odpowiadania na pytania, zapoznaj się z przewodnikiem migracji.

Uwaga

Ta dokumentacja nie ma zastosowania do najnowszej wersji. Aby dowiedzieć się więcej o używaniu 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

Wyobraź sobie, że masz co najmniej jeden blok tekstu, z którego chcesz uzyskać odpowiedzi na podane pytanie. 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:

  • Tworzysz aplikację czytnika książek elektronicznych dla użytkowników końcowych, która pozwala im wyróżniać tekst, wprowadzać pytanie i znajdować odpowiedzi na wyróżniony tekst
  • Rozszerzenie przeglądarki, które umożliwia użytkownikom zadawanie pytań dotyczących zawartości, która jest obecnie wyświetlana 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ą korzystać z tego wskaźnika ufności, aby wyświetlić 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łania interfejsu API.