Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Użyj parametru moreLikeThis w interfejsie API wyszukiwania dokumentów , aby znaleźć dokumenty podobne do dokumentu już w indeksie. Parametr jest ogólnie dostępny w wersji 2026-10-01interfejsu API REST. Usługa Foundry IQ (Wyszukiwanie AI platformy Azure) generuje terminy zapytania z pól z możliwością wyszukiwania dokumentu źródłowego i wyklucza ten dokument z wyników.
Przykłady
W tych przykładach użyto indeksu czterech dokumentów z sekcji Tworzenie indeksu z polami filtru uprawnień i przepływem pracy indeksowania. Najpierw dokończ tę konfigurację.
Zastąp <SEARCH_SERVICE_ENDPOINT> swoim punktem końcowym, a <SEARCH_ACCESS_TOKEN> tokenem wywołującego upoważnionym do wykonywania zapytań do indeksu. Zastąp <USER_ACCESS_TOKEN> element nieprzetworzonym tokenem użytkownika delegowanym używanym <USER_OBJECT_ID> w przekazaniu.
Proste zapytanie
Pomiń search podczas korzystania z polecenia moreLikeThis. Dowolny tekst wyszukiwania, w tym "search": "*", powoduje konflikt z moreLikeThis i powoduje błąd żądania.
Następujące żądanie POST używa klucza dokumentu źródłowego 21 i przeszukiwalnego pola content najwyższego poziomu:
POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer <SEARCH_ACCESS_TOKEN>
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json
{
"moreLikeThis": "21",
"searchFields": "content",
"select": "id,content",
"top": 4,
"count": true
}
Odwołanie: Wyszukiwanie dokumentów (POST).
Rozwiązywanie problemów z pustymi wynikami podobieństwa
Podobieństwo nie gwarantuje niepustego wyniku. Jeśli żaden dokument o określonym kluczu nie istnieje, żądanie zwraca 200 OK pustą value tablicę.
Jeśli to zapytanie dodatnie jest puste, użyj przykładu zapytania , aby sprawdzić, czy dokument 21 źródłowy i kandydat 101 można wyszukiwać i odczytywać przy użyciu tych samych poświadczeń.
Nawet jeśli oba dokumenty są czytelne, mały korpus może nie spełniać wymagań dotyczących częstotliwości terminów zapytania podobieństwa. Dystrybucja dokumentów może mieć wpływ na to, czy te wymagania są spełnione.
Stosowanie filtrów
Połącz moreLikeThis z filtrem, aby ograniczyć wyniki kandydatów. To żądanie wybiera dokumenty ogrodnicze, z wyłączeniem kandydata do astronomii z pozytywnego zapytania:
POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer <SEARCH_ACCESS_TOKEN>
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json
{
"moreLikeThis": "21",
"searchFields": "content",
"select": "id,content",
"top": 4,
"count": true,
"filter": "category eq 'gardening'"
}
Informacje referencyjne: Wyszukiwanie dokumentów (POST).
Wybierz pola i ogranicz wyniki
Użyj polecenia top, aby ograniczyć liczbę wyników, a select, aby wybrać zwracane pola. Użyj parametru searchFields rozdzielanego przecinkami, aby wybrać pola z możliwością wyszukiwania. Jeśli pominiesz to, ma zastosowanie normalne rozpoznawanie pól z możliwością wyszukiwania. Ponieważ moreLikeThis nie obsługuje złożonych podpól, jawnie wybierz odpowiednie pola najwyższego poziomu z obsługą wyszukiwania, gdy indeks zawiera złożone pola.
W przykładach żąda się maksymalnie czterech wyników, a zwracane są id i content. Wyniki nadal wykluczają dokument źródłowy.
Uprawnienia dokumentu natywnego
W indeksie z włączonym natywnym filtrowaniem uprawnień moreLikeThis sprawdza uprawnienia dokumentu źródłowego przed użyciem jego zawartości. Filtruje również potencjalne dokumenty niezależnie za pomocą uprawnień listy ACL indeksu i zakresu RBAC.
W przypadku zapytań filtrowanych uprawnieniami przekaż token delegowanego użytkownika w x-ms-query-source-authorization. Nagłówek wymaga indeksu z włączonym filtrowaniem uprawnień. Aby uzyskać informacje o obsługiwanych przepływach uprawnień, zobacz Role tokenu w czasie wykonywania zapytania i przepływy uprawnień. W tym przykładzie użyto bezpośrednich uprawnień użytkownika dla dokumentów źródłowych i kandydatów.
Zapytania purview i agentyczne nie są obsługiwane za pomocą polecenia moreLikeThis.