Rozwiązywanie problemów z usługą QnA Maker

Wyselekcjonowana lista najczęściej zadawanych pytań dotyczących usługi QnA Maker pomoże Ci szybciej wdrożyć usługę i uzyskać lepsze wyniki.

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.

Zarządzanie przewidywaniami

Jak mogę poprawić wydajność przepływności dla przewidywań zapytań?

Odpowiedź: Problemy z wydajnością przepływności wskazują, że musisz skalować w górę zarówno usługę App Service, jak i usługę Cognitive Search. Rozważ dodanie repliki do usługi Cognitive Search, aby zwiększyć wydajność.

Dowiedz się więcej o warstwach cenowych.

Jak uzyskać punkt końcowy usługi QnAMaker

Odpowiedź: Punkt końcowy usługi QnAMaker jest przydatny do celów debugowania podczas kontaktowania się z pomocą techniczną usługi QnAMaker lub UserVoice. Punkt końcowy jest adresem URL w tej formie: https://your-resource-name.azurewebsites.net.

  1. Przejdź do usługi QnAMaker (grupy zasobów) w witrynie Azure Portal

    QnAMaker Azure resource group in Azure portal

  2. Wybierz usługę App Service skojarzona z zasobem usługi QnA Maker. Zazwyczaj nazwy są takie same.

    Select QnAMaker App Service

  3. Adres URL punktu końcowego jest dostępny w sekcji Przegląd

    QnAMaker endpoint

Zarządzanie baza wiedzy

Przypadkowo usunięto część usługi QnA Maker, co należy zrobić?

Odpowiedź: Nie usuwaj żadnych usług platformy Azure utworzonych wraz z zasobem usługi QnA Maker, takim jak wyszukiwanie lub aplikacja internetowa. Są one niezbędne, aby usługa QnA Maker działała, jeśli usuniesz usługę QnA Maker, przestanie działać poprawnie.

Wszystkie usunięcia są trwałe, w tym pary pytań i odpowiedzi, pliki, adresy URL, niestandardowe pytania i odpowiedzi, baza wiedzy lub zasoby platformy Azure. Przed usunięciem dowolnej części baza wiedzy upewnij się, że wyeksportowasz baza wiedzy ze strony Ustawienia.

Dlaczego moje adresy URL/pliki nie wyodrębnia par odpowiedzi na pytania?

Odpowiedź: Istnieje możliwość, że usługa QnA Maker nie może automatycznie wyodrębnić zawartości pytań i odpowiedzi (QnA) z prawidłowych adresów URL często zadawanych pytań. W takich przypadkach możesz wkleić zawartość usługi QnA w pliku txt i sprawdzić, czy narzędzie może go pozyskać. Alternatywnie możesz dodawać zawartość do baza wiedzy za pośrednictwem portalu usługi QnA Maker.

Jak dużą bazę wiedzy można utworzyć?

Odpowiedź: Rozmiar baza wiedzy zależy od jednostki SKU usługi Azure Search wybranej podczas tworzenia usługi QnA Maker. Przeczytaj tutaj , aby uzyskać więcej informacji.

Dlaczego podczas próby utworzenia nowej bazy wiedzy nie widzę niczego na liście rozwijanej?

Odpowiedź: Nie utworzono jeszcze żadnych usług QnA Maker na platformie Azure. Przeczytaj tutaj , aby dowiedzieć się, jak to zrobić.

Jak mogę udostępnić bazę wiedzy innym osobom?

Odpowiedź: Udostępnianie działa na poziomie usługi QnA Maker, czyli wszystkie baza wiedzy w usłudze zostaną udostępnione. Przeczytaj tutaj, jak współpracować nad baza wiedzy.

Czy możesz udostępnić baza wiedzy współautorowi, który nie znajduje się w tej samej dzierżawie usługi AAD, aby zmodyfikować baza wiedzy?

Odpowiedź: Udostępnianie jest oparte na kontroli dostępu opartej na rolach na platformie Azure. Jeśli możesz udostępnić dowolny zasób na platformie Azure innemu użytkownikowi, możesz również udostępnić usługę QnA Maker.

Jeśli masz plan usługi App Service z 5 baza wiedzy QnAMaker. Czy można przypisać prawa do odczytu/zapisu do 5 różnych użytkowników, aby każdy z nich mógł uzyskać dostęp tylko do 1 QnAMaker baza wiedzy?

Odpowiedź: Możesz udostępnić całą usługę QnAMaker, a nie poszczególne baza wiedzy.

Jak mogę zmienić komunikat domyślny, gdy nie znaleziono dobrego dopasowania?

Odpowiedź: Komunikat domyślny jest częścią ustawień usługi App Service.

  • Przejdź do zasobu usługi App Service w witrynie Azure Portal

qnamaker appservice

  • Wybierz opcję Ustawienia

qnamaker appservice settings

  • Zmienianie wartości ustawienia DefaultAnswer
  • Uruchom ponownie usługę App Service

qnamaker appservice restart

Dlaczego mój link programu SharePoint nie jest wyodrębniany?

Odpowiedź: Aby uzyskać więcej informacji, zobacz Lokalizacje źródeł danych.

Aktualizacje wprowadzone w baza wiedzy nie są odzwierciedlane podczas publikowania. Dlaczego nie?

Odpowiedź: przed opublikowaniem każdej operacji edycji, niezależnie od tego, czy w tabeli jest aktualizowana, testowa czy ustawiana, musi zostać zapisana. Pamiętaj, aby wybrać przycisk Zapisz i wytrenuj po każdej operacji edycji.

Czy baza wiedzy obsługuje zaawansowane dane lub multimedia?

Odpowiedź:

Automatyczne wyodrębnianie multimediów dla plików i adresów URL

  • URLS — ograniczona możliwość konwersji html-to-Markdown.
  • Pliki — nieobsługiwane

Tekst odpowiedzi w języku znaczników markdown

Gdy pary pytań i odpowiedzi znajdują się w baza wiedzy, możesz edytować tekst markdown odpowiedzi, aby dołączyć linki do multimediów dostępnych z publicznych adresów URL.

Czy usługa QnA Maker obsługuje języki inne niż angielski?

Odpowiedź: Zobacz więcej szczegółów na temat obsługiwanych języków.

Jeśli masz zawartość w wielu językach, pamiętaj, aby utworzyć oddzielną usługę dla każdego języka.

Zarządzanie usługą

Kiedy należy ponownie uruchomić usługę App Service?

Odpowiedź: Odśwież usługę aplikacji, gdy ikona ostrożności znajduje się obok wartości wersji baza wiedzy w tabeli Klucze punktu końcowego na stronie Ustawienia Użytkownika.

Usunięto istniejącą usługa wyszukiwania. Jak rozwiązać ten problem?

Odpowiedź: Jeśli usuniesz indeks usługi Azure AI Search, operacja jest ostateczna i nie można odzyskać indeksu.

Usunięto indeks "testkb" w mojej usługa wyszukiwania. Jak rozwiązać ten problem?

Odpowiedź: Jeśli indeks został testkb usunięty w usługa wyszukiwania, możesz przywrócić dane z ostatniej opublikowanej bazy wiedzy. Użyj narzędzia odzyskiwania RestoreTestKBIndex dostępnego w witrynie GitHub.

Otrzymuję następujący błąd: Sprawdź, czy ustawienia mechanizmu CORS usługi QnA Maker app service są dozwolone https://www.qnamaker.ai lub czy istnieją jakiekolwiek ograniczenia sieciowe specyficzne dla organizacji. Jak rozwiązać ten problem?

Odpowiedź: W sekcji interfejsu API okienka usługi App Service zaktualizuj ustawienie MECHANIZMU CORS na * lub "https://www.qnamaker.ai". Jeśli problem nie zostanie rozwiązany, sprawdź ograniczenia specyficzne dla organizacji.

Kiedy należy odświeżyć klucze punktu końcowego?

Odpowiedź: Odśwież klucze punktu końcowego, jeśli podejrzewasz, że zostały naruszone.

Czy mogę użyć tego samego zasobu usługi Azure AI Search dla baza wiedzy przy użyciu wielu języków?

Odpowiedź: Aby użyć wielu języków i wielu baza wiedzy, użytkownik musi utworzyć zasób usługi QnA Maker dla każdego języka. Spowoduje to utworzenie oddzielnej usługi Azure Search dla każdego języka. Mieszanie różnych baza wiedzy językowych w jednej usłudze wyszukiwania platformy Azure spowoduje obniżenie istotności wyników.

Jak zmienić nazwę zasobu usługi Azure AI Search używanego przez usługę QnA Maker?

Odpowiedź: Nazwa zasobu usługi Azure AI Search to nazwa zasobu usługi QnA Maker z kilkoma losowymi literami dołączonymi na końcu. Utrudnia to rozróżnienie wielu zasobów wyszukiwania dla usługi QnA Maker. Utwórz oddzielną usługę wyszukiwania (nazewnictwo jej tak, jak chcesz) i połącz ją z usługą pytań i odpowiedzi. Kroki są podobne do kroków, które należy wykonać, aby uaktualnić usługę Azure Search.

Kiedy usługa QnA Maker zwraca komunikat "Rdzeń środowiska uruchomieniowego nie jest inicjowany", jak to naprawić?

Odpowiedź: Miejsce na dysku dla usługi App Service może być pełne. Procedura naprawiania miejsca na dysku:

  1. W witrynie Azure Portal wybierz usługę App Service usługi QnA Maker, a następnie zatrzymaj usługę.

  2. W usłudze App Service wybierz pozycję Narzędzia programistyczne, a następnie pozycję Narzędzia zaawansowane, a następnie przejdź. Zostanie otwarte nowe okno przeglądarki.

  3. Wybierz pozycję Konsola debugowania, a następnie cmD , aby otworzyć narzędzie wiersza polecenia.

  4. Przejdź do katalogu site/wwwroot/Data/QnAMaker/ .

  5. Usuń wszystkie foldery, których nazwa zaczyna się od rd.

    Nie usuwaj następujących elementów:

    • Plik KbIdToRankerMappings.txt
    • Plik EndpointSettings.json
    • Folder EndpointKeys
  6. Uruchom usługę App Service.

  7. Uzyskaj dostęp do baza wiedzy, aby sprawdzić, czy działa teraz.

Dlaczego moja aplikacja Szczegółowe informacje nie działa?

Odpowiedź: Sprawdź krzyżowo i zaktualizuj poniższe kroki, aby rozwiązać problem:

  1. W usłudze App Service —> grupa Ustawienia —> sekcja Konfiguracji —> Application Ustawienia —> parametry "UserApp Szczegółowe informacje Key" są prawidłowo skonfigurowane i ustawione na odpowiednią kartę Przegląd usługi Application Insights ("Klucz instrumentacji").

  2. W sekcji App Service —> grupa Ustawienia —> "Aplikacja Szczegółowe informacje" — upewnij się,> że usługa App Insights jest włączona i połączona z odpowiednim zasobem usługi Application Insights.

Moja aplikacja Szczegółowe informacje jest włączona, ale dlaczego nie działa prawidłowo?

Odpowiedź: Wykonaj poniższe kroki:

  1. Skopiuj wartość "nazwa APPINSIGHTS_INSTRUMENTATIONKEY" do nazwy "UserApp Szczegółowe informacje Key", przesłaniając, jeśli istnieje już jakaś wartość.

  2. Jeśli klucz "UserApp Szczegółowe informacje Key" nie istnieje w ustawieniach aplikacji, dodaj nowy klucz o tej nazwie i skopiuj wartość.

  3. Zapisz go i spowoduje to automatyczne ponowne uruchomienie usługi App Service. To powinno rozwiązać problem.

Integracja z innymi usługami, w tym botami

Czy muszę używać platformy Bot Framework w celu korzystania z usługi QnA Maker?

Odpowiedź: Nie, nie musisz używać platformy Bot Framework z usługą QnA Maker. Jednak usługa QnA Maker jest oferowana jako jeden z kilku szablonów w usłudze Azure AI Bot Service. Usługa Bot Service umożliwia szybkie tworzenie inteligentnych botów za pośrednictwem platformy Microsoft Bot Framework i działa w środowisku bezserwerowym.

Jak utworzyć nowego bota za pomocą usługi QnA Maker?

Odpowiedź: Postępuj zgodnie z instrukcjami w tej dokumentacji, aby utworzyć bota za pomocą usługi Azure AI Bot Service.

Jak mogę użyć innego baza wiedzy z istniejącą usługą Azure AI Bot Service?

Odpowiedź: Musisz mieć następujące informacje o baza wiedzy:

  • Identyfikator bazy wiedzy.
  • Opublikowana nazwa poddomeny niestandardowej bazy wiedzy, znana jako host, znajduje się na stronie Ustawienia po opublikowaniu.
  • Opublikowany klucz punktu końcowego bazy wiedzy — znajduje się na stronie Ustawienia po opublikowaniu.

Dzięki tym informacjom przejdź do usługi aplikacji bota w witrynie Azure Portal. W obszarze Ustawienia —> Konfiguracja —> Ustawienia aplikacji zmień te wartości.

Klucz punktu końcowego baza wiedzy jest oznaczony QnAAuthkey etykietą w usłudze ABS.

Czy co najmniej dwie aplikacje klienckie mogą współdzielić baza wiedzy?

Odpowiedź: Tak, baza wiedzy można wykonywać zapytania z dowolnej liczby klientów. Jeśli odpowiedź z baza wiedzy wydaje się być niska lub upłynął limit czasu, rozważ uaktualnienie warstwy usługi dla usługi App Service skojarzonej z baza wiedzy.

Jak mogę osadzić usługę QnA Maker w mojej witrynie internetowej?

Odpowiedź: Wykonaj następujące kroki, aby osadzić usługę QnA Maker jako kontrolkę czatu internetowego w witrynie internetowej:

  1. Utwórz bota często zadawanych pytań, postępując zgodnie z instrukcjami dostępnymi tutaj.
  2. Włącz czat internetowy, wykonując kroki opisane tutaj

Magazyn danych

Jakie dane są przechowywane i gdzie są przechowywane?

Odpowiedź:

Podczas tworzenia usługi QnA Maker wybrano region platformy Azure. Twoje baza wiedzy i pliki dziennika są przechowywane w tym regionie.