Zasoby platformy Azure dla usługi QnA Maker
Usługa QnA Maker używa kilku źródeł platformy Azure, z których każda ma inny cel. Zrozumienie sposobu ich użycia indywidualnie umożliwia zaplanowanie i wybranie odpowiedniej warstwy cenowej lub określenie, kiedy zmienić warstwę cenową. Zrozumienie sposobu ich użycia w połączeniu pozwala znaleźć i rozwiązać problemy, gdy wystąpią.
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.
Planowanie zasobów
Podczas pierwszego tworzenia baza wiedzy usługi QnA Maker w fazie prototypu często istnieje jeden zasób usługi QnA Maker na potrzeby testowania i produkcji.
Podczas przechodzenia do fazy opracowywania projektu należy wziąć pod uwagę następujące kwestie:
- Ile języków będzie przechowywanych w systemie baza wiedzy?
- Ile regionów potrzebujesz, aby baza wiedzy był dostępny?
- Ile dokumentów w każdej domenie będzie przechowywanych w systemie?
Zaplanuj posiadanie jednego zasobu usługi QnA Maker zawierającego wszystkie baza wiedzy, które mają ten sam język, ten sam region i tę samą kombinację domeny podmiotu.
Zagadnienia dotyczące warstwy cenowej
Zazwyczaj istnieją trzy parametry, które należy wziąć pod uwagę:
Potrzebna przepływność z usługi:
- Wybierz odpowiedni plan aplikacji dla usługi App Service w zależności od potrzeb. Aplikację można skalować w górę lub w dół.
- Powinno to również mieć wpływ na wybór jednostki SKU usługi Azure Cognitive Search . Więcej szczegółów można znaleźć tutaj. Ponadto może być konieczne dostosowanie pojemności usługi Cognitive Search za pomocą replik.
Rozmiar i liczba baza wiedzy: wybierz odpowiednią jednostkę SKU usługi Azure Search dla danego scenariusza. Zazwyczaj decydujesz o liczbie baza wiedzy potrzebnych na podstawie liczby różnych domen podmiotów. Gdy domena podmiotu (dla pojedynczego języka) powinna znajdować się w jednym baza wiedzy.
Zasób usługi Azure usługa wyszukiwania musi zostać utworzony po styczniu 2019 r. i nie może znajdować się w warstwie Bezpłatna (współdzielona). Nie ma obsługi konfigurowania kluczy zarządzanych przez klienta w witrynie Azure Portal.
Ważne
Można opublikować baza wiedzy N-1 w określonej warstwie, gdzie N to maksymalne indeksy dozwolone w warstwie. Sprawdź również maksymalny rozmiar i liczbę dozwolonych dokumentów na warstwę.
Jeśli na przykład warstwa ma 15 dozwolonych indeksów, możesz opublikować 14 baza wiedzy (jeden indeks na opublikowaną baza wiedzy). Piętnasty indeks jest używany dla wszystkich baza wiedzy do tworzenia i testowania.
- Liczba dokumentów jako źródeł: bezpłatna jednostka SKU usługi zarządzania usługi QnA Maker ogranicza liczbę dokumentów, którymi można zarządzać za pośrednictwem portalu i interfejsów API do 3 (z 1 MB rozmiaru każdy). Jednostka SKU w warstwie Standardowa nie ma ograniczeń liczby dokumentów, którymi można zarządzać. Zobacz więcej szczegółów tutaj.
Poniższa tabela zawiera pewne ogólne wytyczne.
| Zarządzanie usługą QnA Maker | App Service | Azure AI Search | Ograniczenia | |
|---|---|---|---|---|
| Eksperymenty | Bezpłatna jednostka SKU | Warstwa Bezpłatna | Warstwa Bezpłatna | Publikowanie do 2 KB, rozmiar 50 MB |
| Środowisko deweloperskie/testowe | Standardowy SKU | Udostępniona | Podstawowy | Publikowanie do 14 KB, rozmiar 2 GB |
| Środowisko produkcyjne | Standardowy SKU | Podstawowa | Standardowa (Standard) | Publikowanie do 49 KB, rozmiar 25 GB |
Zalecane Ustawienia
| Docelowy QPS | App Service | Azure AI Search |
|---|---|---|
| 3 | S1, jedna replika | S1, jedna replika |
| 50 | S3, 10 replik | S1, 12 replik |
| 80 | S3, 10 replik | S3, 12 replik |
| 100 | P3V2, 10 replik | S3, 12 replik, 3 partycje |
| Od 200 do 250 | P3V2, 20 replik | S3, 12 replik, 3 partycje |
Kiedy zmienić warstwę cenową
| Uaktualnienie | Przyczyna |
|---|---|
| Uaktualnianie jednostki SKU zarządzania usługi QnA Maker | Chcesz mieć więcej par pytań i odpowiedzi lub źródeł dokumentów w baza wiedzy. |
| Uaktualnij jednostkę SKU usługi App Service i sprawdź warstwę usługi Azure AI Search i utwórz repliki usługi Cognitive Search | Twój baza wiedzy musi obsługiwać więcej żądań z aplikacji klienckiej, takich jak czatbot. |
| Uaktualnianie usługa wyszukiwania usługi Azure AI | Planujesz mieć wiele baza wiedzy. |
Pobierz najnowsze aktualizacje środowiska uruchomieniowego, aktualizując usługę App Service w witrynie Azure Portal.
Klucze w usłudze QnA Maker
Usługa QnA Maker zajmuje się dwoma rodzajami kluczy: tworzeniem kluczy i kluczami punktów końcowych zapytań używanymi w środowisku uruchomieniowym hostowanym w usłudze App Service.
Użyj tych kluczy podczas podejmowania żądań do usługi za pośrednictwem interfejsów API.
| Nazwisko | Lokalizacja | Przeznaczenie |
|---|---|---|
| Tworzenie/klucz subskrypcji | Witryna Azure Portal | Te klucze są używane do uzyskiwania dostępu do interfejsów API usługi zarządzania usługi QnA Maker. Te interfejsy API umożliwiają edytowanie pytań i odpowiedzi w baza wiedzy oraz publikowanie baza wiedzy. Te klucze są tworzone podczas tworzenia nowej usługi QnA Maker. Znajdź te klucze w zasobie usług Azure AI na stronie Klucze i punkt końcowy. |
| Klucz punktu końcowego zapytania | Portal usługi QnA Maker | Te klucze służą do wykonywania zapytań dotyczących opublikowanego punktu końcowego baza wiedzy w celu uzyskania odpowiedzi na pytanie użytkownika. Ten punkt końcowy zapytania zazwyczaj jest używany w czatbotze lub w kodzie aplikacji klienckiej, który łączy się z usługą QnA Maker. Te klucze są tworzone podczas publikowania baza wiedzy usługi QnA Maker. Znajdź te klucze na stronie Ustawienia usługi. Znajdź tę stronę z menu użytkownika w prawym górnym rogu strony w menu rozwijanym. |
Znajdowanie kluczy tworzenia w witrynie Azure Portal
Klucze tworzenia można wyświetlać i resetować w witrynie Azure Portal, w której utworzono zasób usługi QnA Maker.
Przejdź do zasobu usługi QnA Maker w witrynie Azure Portal i wybierz zasób, który ma typ usług Azure AI:
Przejdź do pozycji Klucze i punkt końcowy:
Znajdowanie kluczy punktu końcowego zapytania w portalu usługi QnA Maker
Punkt końcowy znajduje się w tym samym regionie co zasób, ponieważ klucze punktu końcowego są używane do wywołania baza wiedzy.
Klucze punktu końcowego można zarządzać za pomocą portalu usługi QnA Maker.
Zaloguj się do portalu usługi QnA Maker, przejdź do swojego profilu, a następnie wybierz pozycję Ustawienia usługi:
Wyświetlanie lub resetowanie kluczy:
Uwaga
Odśwież klucze, jeśli uważasz, że zostały naruszone. Może to wymagać odpowiednich zmian w aplikacji klienckiej lub kodzie bota.
Region usługi zarządzania
Usługa zarządzania usługi QnA Maker jest używana tylko dla portalu usługi QnA Maker i do początkowego przetwarzania danych. Ta usługa jest dostępna tylko w regionie Zachodnie stany USA . Żadne dane klienta nie są przechowywane w tej usłudze w regionie Zachodnie stany USA.
Zagadnienia dotyczące nazewnictwa zasobów
Nazwa zasobu usługi QnA Maker, taka jak qna-westus-f0-b, jest również używana do nazywania innych zasobów.
Okno tworzenia witryny Azure Portal umożliwia utworzenie zasobu usługi QnA Maker i wybranie warstw cenowych dla innych zasobów.
Po utworzeniu zasobów mają taką samą nazwę, z wyjątkiem opcjonalnego zasobu Application Szczegółowe informacje, który umieszcza znaki w nazwie.
Napiwek
Utwórz nową grupę zasobów podczas tworzenia zasobu usługi QnA Maker. Umożliwia to wyświetlenie wszystkich zasobów skojarzonych z zasobem usługi QnA Maker podczas wyszukiwania według grupy zasobów.
Napiwek
Użyj konwencji nazewnictwa, aby wskazać warstwy cenowe w nazwie zasobu lub grupy zasobów. W przypadku wystąpienia błędów podczas tworzenia nowego baza wiedzy lub dodawania nowych dokumentów limit warstwy cenowej usługi Cognitive Search jest typowym problemem.
Cele zasobów
Każdy zasób platformy Azure utworzony za pomocą usługi QnA Maker ma określony cel:
- Zasób usługi QnA Maker
- Zasób usługi Cognitive Search
- App Service
- App Plan Service
- Usługa Szczegółowe informacje aplikacji
Zasób usługi QnA Maker
Zasób usługi QnA Maker zapewnia dostęp do interfejsów API tworzenia i publikowania.
Ustawienia konfiguracji zasobów usługi QnA Maker
Podczas tworzenia nowej baza wiedzy w portalu usługi QnA Maker ustawienie Język jest jedynym ustawieniem, które jest stosowane na poziomie zasobu. Język należy wybrać podczas tworzenia pierwszego baza wiedzy dla zasobu.
Zasób usługi Cognitive Search
Zasób wyszukiwania poznawczego służy do:
- Przechowywanie par pytań i odpowiedzi
- Podaj początkową klasyfikację (ranker #1) par pytań i odpowiedzi w czasie wykonywania
Użycie indeksu
Zasób utrzymuje jeden indeks, który działa jako indeks testowy, a pozostałe indeksy są skorelowane z jednym opublikowanym baza wiedzy każdym.
Zasób wyceniony na 15 indeksów będzie przechowywać 14 opublikowanych baza wiedzy, a jeden indeks jest używany do testowania wszystkich baza wiedzy. Ten indeks testowy jest partycjonowany przez baza wiedzy, aby zapytanie korzystające z okienka testów interakcyjnych używało indeksu testowego, ale zwracało tylko wyniki z określonej partycji skojarzonej z określonym baza wiedzy.
Użycie języka
Pierwsza baza wiedzy utworzona w zasobie usługi QnA Maker służy do określania pojedynczego języka dla zasobu usługi Cognitive Search i wszystkich jego indeksów. Dla usługi QnA Maker można mieć tylko jeden zestaw języków.
Używanie pojedynczej usługa wyszukiwania Poznawczej
Jeśli tworzysz usługę pytań i odpowiedzi oraz jej zależności (takie jak wyszukiwanie) za pośrednictwem portalu, zostanie utworzona usługa wyszukiwania i połączona z usługą QnA Maker. Po utworzeniu tych zasobów możesz zaktualizować ustawienie usługi App Service, aby użyć wcześniej istniejącej usługa wyszukiwania i usunąć nowo utworzoną.
Dowiedz się , jak skonfigurować usługę QnA Maker tak, aby korzystała z innego zasobu usługi Azure AI niż utworzona w ramach procesu tworzenia zasobów usługi QnA Maker.
Plan usługi App Service i usługi App Service
Usługa App Service jest używana przez aplikację kliencą do uzyskiwania dostępu do opublikowanych baza wiedzy za pośrednictwem punktu końcowego środowiska uruchomieniowego. Usługa App Service obejmuje drugą warstwę klasyfikacji opartą na języku naturalnym (NLP) par QnA (ranker #2) par pytań i odpowiedzi w czasie wykonywania. Druga klasyfikacja stosuje inteligentne filtry, które mogą zawierać metadane i monity monitujące.
Aby wysłać zapytanie do opublikowanej baza wiedzy, wszystkie opublikowane baza wiedzy używają tego samego punktu końcowego adresu URL, ale określ identyfikator baza wiedzy w ramach trasy.
{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer
Szczegółowe dane dotyczące aplikacji
Szczegółowe informacje aplikacji służy do zbierania dzienników czatów i danych telemetrycznych. Przejrzyj typowe zapytania Kusto, aby uzyskać informacje o usłudze.
Udostępnianie usług za pomocą usługi QnA Maker
Usługa QnA Maker tworzy kilka zasobów platformy Azure. Aby zmniejszyć zarządzanie i korzystać z udostępniania kosztów, skorzystaj z poniższej tabeli, aby zrozumieć, co można i czego nie można udostępniać:
| Usługa | Udostępnij | Przyczyna |
|---|---|---|
| Usługi sztucznej inteligencji platformy Azure | X | Niemożliwa do projektowania |
| Plan usługi App Service | ✔ | Naprawiono miejsce na dysku przydzielone dla planu usługi App Service. Jeśli inne aplikacje, które współużytkują ten sam plan usługi App Service, używają znacznego miejsca na dysku, wystąpienie usługi App Service QnAMaker napotka problemy. |
| App Service | X | Niemożliwa do projektowania |
| Szczegółowe dane dotyczące aplikacji | ✔ | Może być współużytkowany |
| Search Service | ✔ | 1. testkb jest nazwą zarezerwowaną usługi QnAMaker; nie może być używana przez inne osoby.2. Mapa synonimów według nazwy synonym-map jest zarezerwowana dla usługi QnAMaker.3. Liczba opublikowanych baza wiedzy jest ograniczona przez warstwę usługa wyszukiwania. Jeśli są dostępne bezpłatne indeksy, inne usługi mogą ich używać. |
Następne kroki
- Dowiedz się więcej o baza wiedzy usługi QnA Maker
- Omówienie cyklu życia baza wiedzy
- Przeglądanie limitów usług i baza wiedzy