Fragmenty i formaty zawartości

Wyszukiwanie w Internecie i wyszukiwanie wiadomości zwracają zawartość każdego wyniku w polu content . Wybierasz, jaka ma być ta zawartość, za pomocą contentFormat i maxLength. Ustaw oba w każdym żądaniu. Do uziemienia należy użyć przewodów.

Fragmenty

Ustaw wartość contentFormat na passage, aby dla każdego wyniku uzyskać części dokumentu najbardziej istotne dla zapytania, maksymalnie do maxLength znaków. Web IQ przetwarza cały dokument po jego stronie i zwraca wyodrębnienie ukierunkowane na zapytanie, więc model nie musi czytać dalej przez niepowiązane akapity, aby znaleźć odpowiednie zdanie.

  • Oszczędność tokenów: model otrzymuje fragment dokumentu zamiast całego dokumentu.
  • Lepsza rzeczowość: przy mniejszej ilości treści niezwiązanych z tematem w kontekście model z mniejszym prawdopodobieństwem będzie opierać się na pobocznym akapicie.

Passages działają w każdej aplikacji. Dobrym punktem wyjścia jest maxResults = 10,passagecontentFormat = i maxLength = 3000. Następnie dostosuj do swojego przypadku użycia; zobacz Jak należy dostroić maxResults i maxLength?

Pełny dokument

Web IQ nie zwraca oryginalnej strony internetowej. Podczas indeksowania tworzy on ustrukturyzowany dokument z istotnej zawartości każdej strony, a fragmenty są wybierane z tego dokumentu. Aplikacje z pełnym dostępem do dokumentów mogą żądać całego dokumentu zamiast fragmentów:

contentFormat Returns
passage Części dokumentu najbardziej istotne dla zapytania, do maxLength znaków.
text Pełny dokument jako zwykły tekst, maksymalnie maxLength znaków.
html Pełny dokument w formacie HTML, maksymalnie do maxLength znaków.
markdown Pełny dokument w formacie Markdown, maksymalnie do maxLength znaków.

Dokumenty dłuższe niż maxLength są obcinane. Aby uzyskać pełny dokument, ustaw maxLength wystarczająco wysoko.

Jeśli aplikacja nie ma pełnego dostępu do dokumentów, żądanie, które ustawia text, html lub markdown, zwraca HTTP 403 z kodem błędu AuthContentFormatForbidden. Fragmenty pozostają zalecanym formatem osadzania.

Poproś o pełny dostęp do dokumentu

Aby zażądać pełnego dostępu do dokumentu, otwórz zgłoszenie do pomocy technicznej Web IQ za pośrednictwem Pomocy technicznej Azure i wybierz kategorię zawartość całej strony. Aplikacje, które już używają html lub text, nadal działają tak jak dziś.

Wartości domyślne i limity

To, co otrzymasz, zależy od tego, czy aplikacja ma pełny dostęp do dokumentów. Aby uzyskać te same wyniki za każdym razem, ustaw contentFormat i maxLength na każdym żądaniu.

Bez pełnego dostępu do dokumentu Z pełnym dostępem do dokumentów
Dostępne formaty passage passage, text, html, markdown
contentFormat jeśli go pominiesz passage html (Wyszukiwanie w Internecie), text (Wyszukiwanie wiadomości)
maxLength jeśli go pominiesz 3000 10000
Maksymalnie content na wynik 3000 znaków (większe maxLength wartości zwracają co najwyżej 3000 znaków) maxLength, do 500 000 znaków

Przeglądaj

Funkcja Browse zwraca pełny dokument dla wybranego adresu URL jako text, htmllub markdown, do maxLength znaków. Nie obsługuje passage, ponieważ nie ma zapytania do wyodrębnienia.