Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
- So erstellen Sie eine Suchindex-Wissensquelle (umschließt einen vorhandenen Index)
- So erstellen Sie eine Blob-Wissensquelle (generiert eine Indexerpipeline)
- Erstellen einer OneLake-Wissensquelle (generiert eine Indexerpipeline)
- Wie sie eine SharePoint (indizierte) Wissensquelle erstellen (generiert eine Indexerpipeline)
- Wie man eine SharePoint-Wissensquelle (remote) erstellt (fragt SharePoint direkt ab)
- So erstellen Sie eine Web Knowledge Source-Ressource (stellt eine Verbindung mit dem öffentlichen Endpunkt von Bing bereit)
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
alwaysQueryfestgelegt? Wenn ja, wird die Wissensquelle immer für jede Abfrage verwendet.Die
nameWissensquelle.Der
descriptioneines Indexes, vorausgesetzt, dass es sich um eine indizierte Wissensquelle handelt.Die
retrievalInstructionsangegebene 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.outputModeauf 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.