moreLikeThis in Foundry IQ (Azure KI-Suche)

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

Verwenden Sie den Parameter moreLikeThis in der Search Documents API, um Dokumente zu finden, die einem Dokument ähneln, das sich bereits in Ihrem Index befindet. Der Parameter ist in der REST-API-Version 2026-10-01 allgemein verfügbar. Foundry IQ (Azure KI-Suche) leitet Abfragebegriffe aus den durchsuchbaren Feldern des Quelldokuments ab und schließt dieses Dokument aus den Ergebnissen aus.

Beispiele

In diesen Beispielen wird der Vier-Dokument-Index aus Einen Index mit Berechtigungsfilterfeldern erstellen und dem zugehörigen Indizierungsworkflow verwendet. Schließen Sie zuerst das Setup ab.

Ersetzen Sie <SEARCH_SERVICE_ENDPOINT> durch Ihren Endpunkt und <SEARCH_ACCESS_TOKEN> durch ein zum Abfragen des Indexes autorisiertes Aufrufertoken. Ersetzen Sie <USER_ACCESS_TOKEN> durch das unformatierte delegierte Benutzertoken für den im Upload verwendeten <USER_OBJECT_ID>.

Einfache Abfrage

Lassen Sie search aus, wenn Sie moreLikeThis verwenden. Jeder Suchtext, der nicht null ist, einschließlich "search": "*", steht in Konflikt mit moreLikeThis und führt zu einem Anforderungsfehler.

Die folgende POST-Anforderung verwendet den Quelldokumentschlüssel 21 und das durchsuchbare content Feld der obersten Ebene:

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
}

Referenz: Dokumente durchsuchen (POST)

Behandeln von Problemen mit leeren Ähnlichkeitsergebnissen

Ähnlichkeit garantiert kein nichtleeres Ergebnis. Wenn kein Dokument mit dem angegebenen Schlüssel vorhanden ist, wird die Anforderung mit einem leeren value Array zurückgegeben200 OK.

Wenn diese positive Abfrage leer ist, verwenden Sie das Abfragebeispiel , um zu überprüfen, ob das Quelldokument 21 und der Kandidat 101 mit denselben Anmeldeinformationen durchsuchbar und lesbar sind.

Auch wenn beide Dokumente lesbar sind, erfüllt ein kleiner Korpus möglicherweise nicht die Anforderungen der Ähnlichkeitsabfrage an die Termfrequenz. Die Dokumentverteilung kann sich darauf auswirken, ob diese Anforderungen erfüllt sind.

Anwenden von Filtern

Kombinieren Sie moreLikeThis mit einem Filter, um Kandidatenergebnisse einzuschränken. Diese Anfrage wählt Gartendokumente aus, mit Ausnahme des Astronomiekandidaten aus der positiven Abfrage:

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'"
}

Referenz: Dokumente durchsuchen (POST)

Auswählen von Feldern und Einschränken von Ergebnissen

Verwenden Sie top, um die Anzahl der Ergebnisse einzuschränken und select, um zurückgegebene Felder auszuwählen. Verwenden Sie den durch Kommas getrennten searchFields Parameter, um durchsuchbare Felder auszuwählen. Wenn Sie es weglassen, gilt die normale durchsuchbare Feldauflösung. Da moreLikeThiskomplexe Unterfelder nicht unterstützt werden, wählen Sie explizit geeignete durchsuchbare Felder auf oberster Ebene aus, wenn Ihr Index komplexe Felder enthält.

Die Beispiele fordern höchstens vier Ergebnisse an und geben id und content zurück. Die Ergebnisse schließen das Quelldokument weiterhin aus.

Native Dokumentberechtigungen

Bei einem Index mit aktivierter systemeigener Berechtigungsfilterung überprüft moreLikeThis die Berechtigungen des Quelldokuments, bevor er dessen Inhalt verwendet. Außerdem werden Kandidatendokumente unabhängig über die ACL- und RBAC-Bereichsberechtigungen des Indexes gefiltert.

Übergeben Sie für mit Berechtigungen gefilterte Abfragen das Token des delegierten Benutzers in x-ms-query-source-authorization. Für den Header ist ein Index mit aktivierter Berechtigungsfilterung erforderlich. Unterstützte Berechtigungsflüsse finden Sie unter Abfragezeittokenrollen und Berechtigungsflüsse. Im Beispiel werden direkte Benutzerberechtigungen für die Quell- und Kandidatendokumente verwendet.

Purview- und agentische Abfragen werden mit moreLikeThis nicht unterstützt.

Nächste Schritte