Konfigurowanie pamięci podręcznej wzbogacania (wersja zapoznawcza)

Note

Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te funkcje lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.

Ważne

Buforowanie wzbogacania jest w publicznej wersji zapoznawczej i podlega dodatkowym warunkom użytkowania Microsoft Azure wersji zapoznawczych. Aby zapoznać się z terminami wersji zapoznawczej specyficznymi dla tej funkcji, zobacz Funkcjonalność w wersji zapoznawczej.

W tym artykule wyjaśniono, jak dodać buforowanie do potoku zestawu umiejętności, aby można było modyfikować kroki wzbogacania podrzędnego bez ponownej kompilacji za każdym razem. Buforowanie wzbogacania (wersja zapoznawcza) wymaga interfejsu API REST w wersji zapoznawczej. Domyślnie zestaw umiejętności jest pozbawiony stanów, a zmiana dowolnej części jego struktury wymaga pełnej przebudowy indeksatora. W pamięci podręcznej wzbogacania indeksator określa, które części drzewa dokumentów muszą być odświeżane na podstawie zmian w definicji zestawu umiejętności lub indeksatora. Indeksator zachowuje i ponownie używa istniejących przetworzonych danych wyjściowych, jeśli to możliwe.

Zawartość buforowana jest umieszczana w Azure Storage przy użyciu podanej parametry połączenia. Indeksator tworzy te obiekty podczas jego uruchamiania. Pamięć podręczną wzbogacania należy traktować jako wewnętrzny składnik zarządzany przez usługę Foundry IQ (Wyszukiwanie AI platformy Azure), którego nie wolno modyfikować.

Ważne

Pamięć podręczna wzbogacania nie jest kopią zapasową danych wyjściowych zestawu umiejętności, stanu indeksatora ani indeksowanych dokumentów. Nie śledzi on, które dokumenty zakończą przetwarzanie. W przypadku dużych źródeł danych zapoznaj się z sekcją Ograniczenia przed włączeniem buforowania.

  • Kontener o nazwie ms-az-search-indexercache-<alpha-numeric-string>
  • Tabele o nazwie MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Wymagania wstępne

Należy zapoznać się z konfigurowaniem indeksatorów i zestawów umiejętności. Zacznij od przeglądu indeksatora , a następnie przejdź do zestawów umiejętności , aby dowiedzieć się więcej o potokach wzbogacania.

Ograniczenia

Ostrożność

Jeśli używasz indeksatora SharePoint, unikaj przyrostowego wzbogacania. W pewnych okolicznościach pamięć podręczna traci ważność. Aby go ponownie załadować, wykonaj resetowanie indeksatora i pełne ponowne kompilowanie.

Duże źródła danych mają dodatkowe ograniczenie pamięci podręcznej.

Ostrożność

W przypadku dużych źródeł danych pamięć podręczna wzbogacania może wydłużyć całkowity czas ponownego przetwarzania, gdy występują długotrwale wykonywane operacje, powtarzające się przerwy lub częste niepowodzenia umiejętności. Indeksator przedkłada poprawność nad minimalizowanie ponownego przetwarzania, dlatego zaległości w pamięci podręcznej spowodowane powtarzającymi się przerwaniami nasilają ponawianie prób. To zachowanie jest oczekiwane, a nie usterka.

Aby uporać się z rosnącymi zaległościami w pamięci podręcznej, podziel źródło danych na mniejsze kontenery lub foldery wirtualne. Następnie użyj indeksatorów równoległych wskazujących ten sam indeks. Aby usunąć powiązanie pamięci podręcznej, ustaw właściwość cache na null w indeksatorze. Aby uzyskać wskazówki dotyczące wzorca partycjonowania, zobacz Indeksowanie dużych zestawów danych .

Uprawnienia

Tożsamość Foundry IQ wymaga dostępu do zapisu w usłudze Azure Storage:

  • Współautor danych Storage Blob
  • Storage Table Data Contributor

Składnia parametry połączenia określa, czy jest używana tożsamość przypisana przez system, czy przypisana przez użytkownika. Aby uzyskać więcej informacji, zobacz Połączenie z Azure Storage przy użyciu tożsamości zarządzanej.

Ustawianie właściwości pamięci podręcznej

Użyj tej procedury zarówno dla nowych, jak i istniejących indeksatorów.

W definicji indeksatora określ cache za pomocą:

  • (Wymagane) storageConnectionString ustaw na ciąg połączenia Azure Storage.
  • (Opcjonalnie) enableReprocessing (true domyślnie). Ustaw na false, aby tymczasowo zawiesić wzbogacanie przyrostowe, i przełącz go później z powrotem na true.
  1. Po lewej stronie wybierz pozycję Indeksatory.

  2. Wybierz pozycję Dodaj indeksator , aby utworzyć nowy indeksator lub otworzyć istniejący w trybie edycji JSON.

  3. Włącz wzbogacanie przyrostowe, ustaw konto magazynu pamięci podręcznej wzbogacania i zapisz indeksator.

    Zrzut ekranu przedstawiający opcję portalu Azure dla pamięci podręcznej wzbogacania.

  4. Zresetuj indeksator, jeśli już istnieje.

  5. Uruchom indeksator. Ta jednorazowa pełna ponowna kompilacja powoduje nasiona pamięci podręcznej. Po załadowaniu ponowne użycie przyrostowe ma zastosowanie do kolejnych przebiegów.