Was ist eine Wissensquelle?

Hinweis

Einige agentische Abruffunktionen sind in der Rest-API-Version 2026-04-01 über programmgesteuerten Zugriff allgemein verfügbar. Das Azure Portal und Microsoft Foundry-Portal bieten weiterhin Nur-Vorschau-Zugriff auf alle agentischen Abruffunktionen. Anleitungen für die Migration, einschließlich einer Aufschlüsselung der allgemein verfügbaren Informationen und was in der Vorschau verbleibt, finden Sie unter Migrieren von agentischem Abrufcode zur neuesten Version.

Eine Wissensquelle gibt den Inhalt an, der für den agentischen Abruf verwendet wird. Er kapselt entweder einen Suchindex, der von externen Daten aufgefüllt wird, oder es ist eine direkte Verbindung zu einem Remoteziel wie Bing oder SharePoint, die direkt abgefragt wird. Eine Wissensquelle ist eine erforderliche Definition in einer Wissensbasis.

  • Erstellen Sie eine Wissensquelle als Ressource auf oberster Ebene in Ihrem Suchdienst. Jede Wissensquelle verweist auf genau eine Datenstruktur, entweder auf einen Suchindex, der die Kriterien für den agentischen Abruf oder eine unterstützte externe Ressource erfüllt.

  • Verweisen Sie auf eine oder mehrere Wissensquellen in einer Wissensbasis. In einer agentischen Abrufpipeline können Sie mehrere Wissensquellen in einer einzigen Anforderung abfragen. Unterabfragen werden für jede Wissensquelle generiert. Die wichtigsten Ergebnisse werden in der Abrufantwort zurückgegeben.

  • Für bestimmte Wissensquellen können Sie eine Wissensquellendefinition verwenden, um eine vollständige Indexerpipeline (Datenquelle, Skillset, Indexer und Index) zu generieren, die für den agentischen Abruf funktioniert. Anstatt mehrere Objekte manuell zu erstellen, werden die Informationen in der Wissensquelle verwendet, um alle Objekte zu generieren, einschließlich eines aufgefüllten, geblockten und durchsuchbaren Indexes.

Stellen Sie sicher, dass Sie mindestens eine Wissensquelle haben, bevor Sie eine Wissensbasis erstellen. Die vollständige Spezifikation für Wissensquellen und Wissensdatenbanken finden Sie in der REST-API-Referenz.

Arbeiten mit einer Wissensquelle

  • Erstellungspfad: Erstellen Sie zuerst eine Wissensquelle, und erstellen Sie dann eine Wissensbasis.

  • Löschpfad: Aktualisieren oder löschen Sie Wissensdatenbanken, um Verweise auf eine Wissensquelle zu entfernen, und löschen Sie dann die Wissensquelle zuletzt.

  • Eine Wissensquelle, ihr Index und die Wissensbasis müssen alle auf demselben Suchdienst vorhanden sein. Auf externe Inhalte wird entweder über das öffentliche Internet (Bing) oder innerhalb eines Microsoft-Mandanten (Remote SharePoint) zugegriffen.

Unterstützte Wissensquellen

Sie können die folgenden Wissensquellen erstellen:

Art Indiziert oder Remote
"searchIndex" DIE API umschließt einen vorhandenen Index. Indexiert
"azureBlob" API generiert eine Indexerpipeline, die von einem Blobcontainer abgerufen wird. Indiziert
"indexedOneLake" DIE API generiert eine Indexerpipeline, die von einem Seehaus abgerufen wird. Indexiert
"indexedSharePoint" API (Vorschau) generiert eine Indexerpipeline, die von einer SharePoint Website abgerufen wird. Indiziert
"remoteSharePoint" API (Vorschau) ruft Inhalte direkt aus SharePoint ab. Fernzugriff
"web"-API ruft Echtzeit-Erdungsdaten aus Microsoft Bing ab. Fernzugriff

Indizierte Wissensquellen verweisen auf einen Zielindex für Azure KI-Suche. Die Abfrageausführung erfolgt lokal bei der Suchmaschine Ihres Suchdiensts. Schlüsselwort (Volltextsuche), Vektor- und Hybridabfragefunktionen werden zum Abrufen von Daten aus indizierten Wissensquellen verwendet.

Sie greifen zur Abfragezeit auf Remote-Wissensquellen zu. Das agentische Abrufmodul ruft die Abruf-APIs auf, die für die Plattform (Bing oder SharePoint-APIs) nativ sind.

Alle abgerufenen Inhalte, unabhängig davon, ob indiziert oder remote, werden in die Rangfolge-Pipeline von Azure KI-Suche eingefügt, wo sie auf Relevanz bewertet, bei mehreren Abfragen zusammengeführt, neu eingestuft und in der Abrufantwort zurückgegeben werden.

Erstellen von Wissensquellen

Erstellen Sie Wissensquellen als eigenständige Objekte. Geben Sie sie dann in einer Wissensbasis in einem "knowledgeSources"-Array an.

Zum Erstellen von Objekten in einem Suchdienst benötigen Sie Berechtigungen für den Suchdienstmitwirkender. Wenn Sie eine Wissensquelle verwenden, die eine Indexerpipeline erstellt, benötigen Sie zum Laden eines Indexes auch Suchindexdatenmitwirkende-Berechtigungen . Alternativ können Sie anstelle von Rollen einen API-Administratorschlüssel verwenden .

Verwenden Sie das Azure Portal, die REST-API oder ein Azure SDK-Paket, um eine Wissensquelle zu erstellen. Die folgenden Links enthalten Anweisungen zum Erstellen einer Wissensquelle:

Nachdem Sie die Wissensquelle erstellt haben, verweisen Sie darauf in einer Wissensbasis.

Verwenden von Wissensquellen

Sie können die Nutzung von Wissensquellen explizit steuern, indem Sie die Definition der Wissensquelle oder die Steuerungsanweisungen festlegen alwaysQuery , die während der Abfrageplanung verwendet werden. Steuerungsanweisungen beziehen sich auf Beschreibungen eines Indexes oder explizite Abrufanweisungen in der Wissensquelle, die Anleitungen zur Verwendung des Indexes liefern. Die Abfrageplanung erfolgt, wenn Sie einen geringen oder mittleren Aufwand für die Abruflogik des LLM verwenden. Für einen geringen Aufwand sind alle in der Wissensdatenbank aufgeführten Wissensquellen für jede Abfrage relevant. Für niedrige und mittlere Ebenen können die Wissensbasis und das LLM zum Abfragezeitpunkt ermitteln, welche Wissensquellen wahrscheinlich als beste Suchbasis dienen.

Die Logik für die Auswahl von Wissensquellen basiert auf diesen Faktoren:

  • Ist alwaysQuery festgelegt? Wenn ja, wird die Wissensquelle immer für jede Abfrage verwendet.

  • Die name Wissensquelle.

  • Der description eines Indexes, vorausgesetzt, dass es sich um eine indizierte Wissensquelle handelt.

  • Die retrievalInstructions angegebene Abrufen-Aktion oder Knowledge Base-Definition liefert Anleitungen, die Wissensquellen einschließen oder ausschließen. Es ähnelt einer Eingabeaufforderung. Sie können Kürze, Ton und Formatierung als Abrufanweisungen angeben.

  • outputMode auf einer Wissensbasis wirkt sich auch auf die Abfrageergebnisse aus und darauf, was in der Antwort enthalten ist.

Verwenden eines Abrufüberlegungsansatzes zur Steuerung der LLM-Nutzung

Nicht alle Lösungen profitieren von der LLM-Abfrageplanung und -ausführung. Wenn Einfachheit und Geschwindigkeit die Vorteile der LLM-Abfrageplanung und des Kontext-Engineerings überwiegen, geben Sie einen minimalen Denkaufwand an, um die LLM-Verarbeitung in Ihrer Pipeline zu reduzieren.

Bei niedrigem und mittlerem Niveau ist der LLM-Prozess entweder ein ausgewogenes oder maximales Vorgehen, das die Relevanz verbessert. Weitere Informationen finden Sie unter Festlegen des Aufwands für das Abrufdenken.

Hinweis

Wenn Sie attemptFastPath in der vorherigen Vorschau verwendet haben, wird dieser Ansatz jetzt durch retrievalReasoningEffort, das auf minimal gesetzt ist, ersetzt.