Erstellen einer Web-Wissensquelle

Hinweis

Diese agentische Abruffunktion ist in der Rest-API 2026-04-01 allgemein über programmgesteuerten Zugriff verfügbar. Das Azure Portal und Microsoft Foundry-Portal bieten weiterhin Nur-Vorschau-Zugriff auf alle agentischen Abruffunktionen. Anleitungen zur Migration finden Sie unter Migrieren des agentischen Abrufcodes zur neuesten Version.

Wenn Sie eine Vorschau-REST-API verwenden, können Sie auf Funktionen zugreifen, die für dieses Feature noch nicht allgemein verfügbar sind. Vorschaufunktionen werden ohne Service-Level-Vereinbarung bereitgestellt und sind für Produktionsworkloads nicht empfohlen. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Wichtig

Diese Features und Funktionen sind Teil der REST-API 2026-05-01-Preview. Die 2026-05-01-preview wird Ihnen als Teil Ihres Azure-Abonnements zur Verfügung gestellt und unterliegt den für „Previews“ geltenden Bestimmungen in den Microsoft-Produktbestimmungen, dem Nachtrag zum Datenschutz für Microsoft-Produkte und -Dienste („DPA“) und den Ergänzenden Nutzungsbedingungen für Microsoft Azure-Vorschauen.

Die Vorschauversion 2026-05-01 unterstützt Verbindungen mit anderen Microsoft-Diensten und Diensten von Drittanbietern. Die Nutzung dieser Dienste unterliegt den jeweiligen Bestimmungen und kann dazu führen, dass Daten außerhalb der Azure-Compliancegrenze verarbeitet oder gespeichert werden und dass Daten in die Azure-Compliancegrenze fließen.

Es liegt in Ihrer Verantwortung, zu verwalten, ob Ihre Daten außerhalb der Compliance- und geografischen Grenzen Ihrer Organisation und alle damit verbundenen Auswirkungen fließen und dass entsprechende Berechtigungen, Grenzen und Genehmigungen bereitgestellt werden.

Sie sind dafür verantwortlich, Anwendungen, die Sie im Kontext Ihrer spezifischen Anwendungsfälle erstellen, sorgfältig zu überprüfen und zu testen und alle geeigneten Entscheidungen und Anpassungen zu treffen. Dazu gehört die Implementierung ihrer eigenen verantwortungsvollen KI-Entschärfungen, wie Metaprompts, Inhaltsfilter oder andere Sicherheitssysteme, und sicherzustellen, dass Ihre Anwendungen angemessene Qualität, Zuverlässigkeit, Sicherheit und Vertrauenswürdigkeitsstandards erfüllen. Weitere Informationen finden Sie im Azure KI-Suche Transparenzhinweis.

Wichtig

Web Knowledge Source, die das Grounding mit Bing Search und/oder Grounding mit Bing Custom Search verwendet, ist ein First Party Consumption Service, der den Grounding mit Bing-Nutzungsbedingungen und der Microsoft-Datenschutzerklärung unterliegt.
Das Microsoft Data Protection Addendum gilt nicht für Daten, die an die Web Knowledge Source gesendet werden. Wenn Kunde Web Knowledge Source verwendet, fließen Kundendaten außerhalb der Azure Compliance- und Geo-Grenze. Dies bedeutet auch, dass die Verwendung von Web Knowledge Source alle erhöhten Sicherheits- und Compliance-Verpflichtungen der Government Community Cloud aufhebt, einschließlich der Verpflichtungen in Bezug auf Datenhoheit und der Unterstützung, die auf einer Prüfung oder der Staatsbürgerschaft basiert, sofern zutreffend.
Die Nutzung von Web Knowledge Source verursacht Kosten; erfahren Sie mehr über die Preise.
Erfahren Sie mehr darüber, wie Azure Administratoren Zugriff auf die Verwendung von Web Knowledge Source verwalten können.

Web Knowledge Source ermöglicht das Abrufen von Echtzeitwebdaten aus Microsoft Bing in einer agentischen Abrufpipeline. Wissensquellen werden unabhängig erstellt, in einer Wissensbasis referenziert und als Erdungsdaten verwendet, wenn die Wissensbasis zur Laufzeit abgefragt wird.

Bing Custom Search ist immer der Suchanbieter für Web Knowledge Source. Obwohl Sie keine alternativen Suchanbieter oder Suchmaschinen angeben können, können Sie bestimmte Domänen wie z https://learn.microsoft.com. B. einschließen oder ausschließen. Wenn keine Domänen angegeben sind, hat Web Knowledge Source uneingeschränkten Zugriff auf das gesamte öffentliche Internet.

Web Knowledge Source funktioniert am besten zusammen mit anderen Wissensquellen. Verwenden Sie sie, wenn Ihre proprietären Inhalte keine vollständigen, up-to-Datumsantworten bereitstellen oder wenn Sie Ergebnisse mit Informationen aus einer kommerziellen Suchmaschine ergänzen möchten.

Verwendungsunterstützung

Azure Portal	Microsoft Foundry Portal	.NET SDK	Python SDK	Java SDK	JavaScript SDK	REST-API
✔️	✔️	✔️	✔️	✔️	✔️	✔️

Voraussetzungen

Ein Azure-Abonnement mit Access to Web Knowledge Source. Standardmäßig ist der Zugriff aktiviert. Wenden Sie sich an Ihren Administrator, wenn der Zugriff deaktiviert ist.
Ein Azure KI-Suche-Suchdienst in jeder öffentlichen Region, die Abrufe durch Agents ermöglicht. Web Knowledge Source wird in privaten oder souveränen Clouds nicht unterstützt.
Berechtigungen zum Erstellen von Wissensquellen. Konfigurieren Sie die schlüssellose Authentifizierung mit der Rolle "Mitwirkender des Suchdiensts ", die Ihrem Benutzerkonto zugewiesen ist (empfohlen), oder verwenden Sie einen API-Schlüssel.

Erforderliches Azure.Search.Documents-Paket:
- Für 2026-05-01-preview-Funktionen: das neueste Vorschaupaket dotnet add package Azure.Search.Documents --prerelease
- Für 2026-04-01-Features das neueste stabile Paket: dotnet add package Azure.Search.Documents

Erforderliches azure-search-documents-Paket:
- Für 2026-05-01-preview-Funktionen: das neueste Vorschaupaket pip install --pre azure-search-documents
- Für 2026-04-01-Features das neueste stabile Paket: pip install azure-search-documents

Erforderliche REST-API-Version:
- Für Vorschaufunktionen: Search Service 2026-05-01-preview
- Für allgemein verfügbare Features: Suchdienst 2026-04-01

Einschränkungen und Überlegungen

Webinhalte werden immer von einem LLM zusammengefasst, bevor sie in die Abrufergebnisse einbezogen werden. Die Ergebnisse sind zitierte Zusammenfassungen, nicht wortwörtlicher Webtext.
Für die API-Version 2026-04-01 muss die Knowledge Base einen Modellverweis enthalten, um die LLM für die Webinhaltszusammenfassung bereitzustellen. Der Abruf ist immer extrahierend (zitierte Zusammenfassungen). Die Antwortsynthese und der konfigurierbare Schlussfolgerungsaufwand sind in dieser Version nicht verfügbar.
Für die 2026-05-01-Vorschau-API-Version ermöglicht die Knowledge Base-Modellreferenz auch die Antwortsynthese, die eine einzelne LLM-formulierte Antwort anstelle extrahierter Zitate erzeugt.

Überprüfen auf vorhandene Wissensquellen

Eine Wissensquelle ist ein wiederverwendbares Objekt auf oberster Ebene. Das Wissen über vorhandene Wissensquellen ist hilfreich, um neue Objekte wiederzuverwenden oder zu benennen.

Führen Sie den folgenden Code aus, um Wissensquellen nach Namen und Typ auflisten.

// List knowledge sources by name and type
using Azure.Search.Documents.Indexes;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeSources = indexClient.GetKnowledgeSourcesAsync();

Console.WriteLine("Knowledge Sources:");

await foreach (var ks in knowledgeSources)
{
    Console.WriteLine($"  Name: {ks.Name}, Type: {ks.GetType().Name}");
}

Reference:SearchIndexClient

# List knowledge sources by name and type
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

for ks in index_client.list_knowledge_sources():
    print(f"  - {ks.name} ({ks.kind})")

Reference:SearchIndexClient

### List knowledge sources by name and type
GET {{search-url}}/knowledgesources?api-version={{api-version}}&$select=name,kind
api-key: {{api-key}}

Referenz:Wissensquellen - Liste

Sie können auch eine einzelne Wissensquelle anhand des Namens zurückgeben, um die JSON-Definition zu überprüfen.

using Azure.Search.Documents.Indexes;
using System.Text.Json;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

// Specify the knowledge source name to retrieve
string ksNameToGet = "earth-knowledge-source";

// Get its definition
var knowledgeSourceResponse = await indexClient.GetKnowledgeSourceAsync(ksNameToGet);
var ks = knowledgeSourceResponse.Value;

// Serialize to JSON for display
var jsonOptions = new JsonSerializerOptions 
{ 
    WriteIndented = true,
    DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.Never
};
Console.WriteLine(JsonSerializer.Serialize(ks, ks.GetType(), jsonOptions));

Reference:SearchIndexClient

# Get a knowledge source definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
import json

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

ks = index_client.get_knowledge_source("knowledge_source_name")
print(json.dumps(ks.as_dict(), indent = 2))

Reference:SearchIndexClient

### Get a knowledge source definition
GET {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version={{api-version}}
api-key: {{api-key}}

Referenz:Wissensquellen - Abrufen

Der folgende JSON-Code ist eine Beispielantwort für eine Web Knowledge Source-Ressource.

{
  "name": "my-web-ks",
  "kind": "web",
  "description": "A sample Web Knowledge Source.",
  "encryptionKey": null,
  "webParameters": {
    "domains": null
  }
}

Erstellen einer Wissensquelle

Führen Sie den folgenden Code aus, um eine Webwissensquelle zu erstellen.

2026-05-01-Vorschau
2026-04-01

// Create Web Knowledge Source
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
using Azure;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new AzureKeyCredential(apiKey));

var knowledgeSource = new WebKnowledgeSource(name: "my-web-ks")
{
    Description = "A sample Web Knowledge Source.",
    WebParameters = new WebKnowledgeSourceParameters
    {
        Domains = new WebKnowledgeSourceDomains
        {
            AllowedDomains = 
            {
                new WebKnowledgeSourceDomain(address: "learn.microsoft.com") { IncludeSubpages = true }
            },
            BlockedDomains = 
            {
                new WebKnowledgeSourceDomain(address: "bing.com") { IncludeSubpages = false }
            }
        }
    }
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Console.WriteLine($"Knowledge source '{knowledgeSource.Name}' created or updated successfully.");

Reference:SearchIndexClient, WebKnowledgeSource

// Create Web Knowledge Source
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
using Azure;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), new AzureKeyCredential(apiKey));

var knowledgeSource = new WebKnowledgeSource(name: "my-web-ks")
{
    Description = "A sample Web Knowledge Source.",
    WebParameters = new WebKnowledgeSourceParameters
    {
        Domains = new WebKnowledgeSourceDomains
        {
            AllowedDomains = 
            {
                new WebKnowledgeSourceDomain(address: "learn.microsoft.com") { IncludeSubpages = true }
            },
            BlockedDomains = 
            {
                new WebKnowledgeSourceDomain(address: "bing.com") { IncludeSubpages = false }
            }
        }
    }
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(knowledgeSource);
Console.WriteLine($"Knowledge source '{knowledgeSource.Name}' created or updated successfully.");

Reference:SearchIndexClient, WebKnowledgeSource

2026-05-01-Vorschau
2026-04-01

# Create Web Knowledge Source
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import WebKnowledgeSource, WebKnowledgeSourceParameters, WebKnowledgeSourceDomains, WebKnowledgeSourceDomain

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

knowledge_source = WebKnowledgeSource(
    name = "my-web-ks",
    description = "A sample Web Knowledge Source.",
    encryption_key = None,
    web_parameters = WebKnowledgeSourceParameters(
        domains = WebKnowledgeSourceDomains(
            allowed_domains = [ WebKnowledgeSourceDomain(address="learn.microsoft.com", include_subpages=True) ],
            blocked_domains = [ WebKnowledgeSourceDomain(address="bing.com", include_subpages=False) ]
        )
    )
)

index_client.create_or_update_knowledge_source(knowledge_source)
print(f"Knowledge source '{knowledge_source.name}' created or updated successfully.")

Reference:SearchIndexClient

# Create Web Knowledge Source
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import WebKnowledgeSource, WebKnowledgeSourceParameters, WebKnowledgeSourceDomains, WebKnowledgeSourceDomain

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

knowledge_source = WebKnowledgeSource(
    name = "my-web-ks",
    description = "A sample Web Knowledge Source.",
    encryption_key = None,
    web_parameters = WebKnowledgeSourceParameters(
        domains = WebKnowledgeSourceDomains(
            allowed_domains = [ WebKnowledgeSourceDomain(address="learn.microsoft.com", include_subpages=True) ],
            blocked_domains = [ WebKnowledgeSourceDomain(address="bing.com", include_subpages=False) ]
        )
    )
)

index_client.create_or_update_knowledge_source(knowledge_source)
print(f"Knowledge source '{knowledge_source.name}' created or updated successfully.")

Reference:SearchIndexClient

2026-05-01-Vorschau
2026-04-01

### Create Web Knowledge Source
PUT {{search-url}}/knowledgesources/my-web-ks?api-version=2026-05-01-preview
Content-Type: application/json
api-key: {{api-key}}

{
  "name": "my-web-ks",
  "kind": "web",
  "description": "This knowledge source pulls content from the web.",
  "encryptionKey": null,
  "webParameters": {
    "domains": {
      "allowedDomains": [ { "address": "learn.microsoft.com", "includeSubpages": true } ],
      "blockedDomains": [ { "address": "bing.com", "includeSubpages": false } ]
    }
  }
}

Referenz:Wissensquellen – Erstellen oder Aktualisieren

### Create Web Knowledge Source
PUT {{search-url}}/knowledgesources/my-web-ks?api-version=2026-04-01
Content-Type: application/json
api-key: {{api-key}}

{
  "name": "my-web-ks",
  "kind": "web",
  "description": "This knowledge source pulls content from the web.",
  "encryptionKey": null,
  "webParameters": {
    "domains": {
      "allowedDomains": [ { "address": "learn.microsoft.com", "includeSubpages": true } ],
      "blockedDomains": [ { "address": "bing.com", "includeSubpages": false } ]
    }
  }
}

Referenz:Wissensquellen – Erstellen oder Aktualisieren

Quellspezifische Eigenschaften

Die folgenden Eigenschaften gelten für Webwissensquellen.

Namen	Beschreibung	Typ	Bearbeitbar	Erforderlich
`Name`	Der Name der Wissensquelle, die innerhalb der Wissensquellensammlung eindeutig sein muss und den richtlinien für naming für Objekte in Azure KI-Suche entsprechen muss.	Schnur	Nein	Ja
`Description`	Eine Beschreibung der Wissensquelle. Wenn nicht angegeben, wendet Azure KI-Suche eine Standardbeschreibung an.	Schnur	Ja	Nein
`EncryptionKey`	Ein vom Kunden verwalteter Schlüssel zum Verschlüsseln vertraulicher Informationen in der Wissensquelle.	Objekt	Ja	Nein
`WebParameters`	Spezifische Parameter für die Web-Wissensquelle. Derzeit ist dies nur `Domains`.	Objekt	Ja	Nein
`Domains`	Domänen, die im Suchbereich zugelassen oder blockiert werden sollen. Standardmäßig verwendet die Wissensquelle Grounding mit Bing Search, um das gesamte öffentliche Internet zu durchsuchen. Wenn Sie Domänen angeben, verwendet die Wissensquelle "Grounding" mit der benutzerdefinierten Bing-Suche , um Ergebnisse auf die angegebenen Domänen einzuschränken. In beiden Fällen ist Bing Custom Search der Suchanbieter.	Objekt	Ja	Nein
`AllowedDomains`	Domänen, die in den Suchbereich eingeschlossen werden sollen. Für jede Domäne müssen Sie deren `address` im `website.com` Format angeben. Sie können auch angeben, ob die Unterseiten der Domäne eingeschlossen werden sollen, indem Sie `IncludeSubpages` auf `true` oder `false` festlegen.	Array	Ja	Nein
`BlockedDomains`	Domänen, die aus dem Suchbereich ausgeschlossen werden sollen. Für jede Domäne müssen Sie deren `address` im `website.com` Format angeben. Sie können auch angeben, ob die Unterseiten der Domäne eingeschlossen werden sollen, indem Sie `IncludeSubpages` auf `true` oder `false` festlegen.	Array	Ja	Nein

Namen	Beschreibung	Typ	Bearbeitbar	Erforderlich
`name`	Der Name der Wissensquelle, die innerhalb der Wissensquellensammlung eindeutig sein muss und den richtlinien für naming für Objekte in Azure KI-Suche entsprechen muss.	Schnur	Nein	Ja
`description`	Eine Beschreibung der Wissensquelle. Wenn nicht angegeben, wendet Azure KI-Suche eine Standardbeschreibung an.	Schnur	Ja	Nein
`encryption_key`	Ein vom Kunden verwalteter Schlüssel zum Verschlüsseln vertraulicher Informationen in der Wissensquelle.	Objekt	Ja	Nein
`web_parameters`	Spezifische Parameter für die Web-Wissensquelle. Derzeit ist dies nur `domains`.	Objekt	Ja	Nein
`domains`	Domänen, die im Suchbereich zugelassen oder blockiert werden sollen. Standardmäßig verwendet die Wissensquelle Grounding mit Bing Search, um das gesamte öffentliche Internet zu durchsuchen. Wenn Sie Domänen angeben, verwendet die Wissensquelle "Grounding" mit der benutzerdefinierten Bing-Suche , um Ergebnisse auf die angegebenen Domänen einzuschränken. In beiden Fällen ist Bing Custom Search der Suchanbieter.	Objekt	Ja	Nein
`allowed_domains`	Domänen, die in den Suchbereich eingeschlossen werden sollen. Für jede Domäne müssen Sie deren `address` im `website.com` Format angeben. Sie können auch angeben, ob die Unterseiten der Domäne eingeschlossen werden sollen, indem Sie `include_subpages` auf `true` oder `false` festlegen.	Array	Ja	Nein
`blocked_domains`	Domänen, die aus dem Suchbereich ausgeschlossen werden sollen. Für jede Domäne müssen Sie deren `address` im `website.com` Format angeben. Sie können auch angeben, ob die Unterseiten der Domäne eingeschlossen werden sollen, indem Sie `include_subpages` auf `true` oder `false` festlegen.	Array	Ja	Nein

Namen	Beschreibung	Typ	Bearbeitbar	Erforderlich
`name`	Der Name der Wissensquelle, die innerhalb der Wissensquellensammlung eindeutig sein muss und den richtlinien für naming für Objekte in Azure KI-Suche entsprechen muss.	Schnur	Nein	Ja
`kind`	Die Art der Wissensquelle, die in diesem Fall `web` ist.	Schnur	Nein	Ja
`description`	Eine Beschreibung der Wissensquelle. Wenn nicht angegeben, wendet Azure KI-Suche eine Standardbeschreibung an.	Schnur	Ja	Nein
`encryptionKey`	Ein vom Kunden verwalteter Schlüssel zum Verschlüsseln vertraulicher Informationen in der Wissensquelle.	Objekt	Ja	Nein
`webParameters`	Spezifische Parameter für die Web-Wissensquelle. Derzeit ist dies nur `domains`.	Objekt	Ja	Nein
`domains`	Domänen, die im Suchbereich zugelassen oder blockiert werden sollen. Standardmäßig verwendet die Wissensquelle Grounding mit Bing Search, um das gesamte öffentliche Internet zu durchsuchen. Wenn Sie Domänen angeben, verwendet die Wissensquelle "Grounding" mit der benutzerdefinierten Bing-Suche , um Ergebnisse auf die angegebenen Domänen einzuschränken. In beiden Fällen ist Bing Custom Search der Suchanbieter.	Objekt	Ja	Nein
`allowedDomains`	Domänen, die in den Suchbereich eingeschlossen werden sollen. Für jede Domäne müssen Sie deren `address` im `website.com` Format angeben. Sie können auch angeben, ob die Unterseiten der Domäne eingeschlossen werden sollen, indem Sie `includeSubpages` auf `true` oder `false` festlegen.	Array	Ja	Nein
`blockedDomains`	Domänen, die aus dem Suchbereich ausgeschlossen werden sollen. Für jede Domäne müssen Sie deren `address` im `website.com` Format angeben. Sie können auch angeben, ob die Unterseiten der Domäne eingeschlossen werden sollen, indem Sie `includeSubpages` auf `true` oder `false` festlegen.	Array	Ja	Nein

Zuweisen zu einer Wissensbasis

Wenn Sie mit der Wissensquelle zufrieden sind, fügen Sie sie einer Wissensbasis hinzu.

Abfragen einer Wissensbasis

Wenn Sie eine Knowledge Base abfragen, die Web Knowledge Source enthält, kann das Abfrageantwortarray activity zwei webbezogene Datensätze enthalten:

Ein web Datensatz, der die für die Anforderung verwendeten Laufzeitparameter erfasst.
Ein modelWebSummarization Datensatz, der die Tokenverwendung für den LLM-Zusammenfassungsschritt erfasst.

{
  "activity": [
    {
      "id": 1,
      "type": "web",
      "knowledgeSourceName": "my-web-ks",
      "elapsedMs": 212,
      "webArguments": {
        "search": "What is the latest news about AI in education?",
        "language": "en",
        "market": "en-US",
        "count": 10,
        "freshness": "2026-03-01..2026-03-31"
      }
    },
    {
      "id": 2,
      "type": "modelWebSummarization",
      "elapsedMs": 87,
      "inputTokens": 1234,
      "outputTokens": 256
    }
  ]
}

Löschen einer Wissensquelle

Bevor Sie eine Wissensquelle löschen können, müssen Sie alle Knowledge Basen löschen, die darauf verweisen, oder die Knowledge Base-Definition aktualisieren, um den Verweis zu entfernen. Für Wissensquellen, die eine Index- und Indexerpipeline generieren, werden auch alle generierten Objekte gelöscht. Wenn Sie jedoch einen vorhandenen Index zum Erstellen einer Wissensquelle verwendet haben, wird Ihr Index nicht gelöscht.

Wenn Sie versuchen, eine verwendete Wissensquelle zu löschen, schlägt die Aktion fehl und gibt eine Liste der betroffenen Wissensdatenbanken zurück.

So löschen Sie eine Wissensquelle:

Erhalten Sie eine Liste aller Wissensdatenbanken für Ihren Suchdienst.

using Azure.Search.Documents.Indexes;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeBases = indexClient.GetKnowledgeBasesAsync();

Console.WriteLine("Knowledge Bases:");

await foreach (var kb in knowledgeBases)
{
    Console.WriteLine($"  - {kb.Name}");
}

Reference:SearchIndexClient

Eine Beispielantwort könnte wie folgt aussehen:

 {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

Rufen Sie eine individuelle Wissensbasisdefinition ab, um nach Wissensquellenverweise zu suchen.

using Azure.Search.Documents.Indexes;
using System.Text.Json;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

// Specify the knowledge base name to retrieve
string kbNameToGet = "earth-knowledge-base";

// Get a specific knowledge base definition
var knowledgeBaseResponse = await indexClient.GetKnowledgeBaseAsync(kbNameToGet);
var kb = knowledgeBaseResponse.Value;

// Serialize to JSON for display
string json = JsonSerializer.Serialize(kb, new JsonSerializerOptions { WriteIndented = true });
Console.WriteLine(json);

Reference:SearchIndexClient

Eine Beispielantwort könnte wie folgt aussehen:

 {
   "Name": "earth-knowledge-base",
   "KnowledgeSources": [
     {
       "Name": "earth-knowledge-source"
     }
   ],
   "Models": [
     {}
   ],
   "RetrievalReasoningEffort": {},
   "OutputMode": {},
   "ETag": "\u00220x8DE278629D782B3\u0022",
   "EncryptionKey": null,
   "Description": null,
   "RetrievalInstructions": null,
   "AnswerInstructions": null
 }

Löschen Sie entweder die Wissensdatenbank, oder aktualisieren Sie, wenn Sie über mehrere Wissensquellen verfügen, die Wissensbasis, um die Quelle zu entfernen. In diesem Beispiel wird das Löschen gezeigt.

using Azure.Search.Documents.Indexes;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

await indexClient.DeleteKnowledgeBaseAsync(knowledgeBaseName);
System.Console.WriteLine($"Knowledge base '{knowledgeBaseName}' deleted successfully.");

Reference:SearchIndexClient

Löschen Sie die Wissensquelle.

await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName);
System.Console.WriteLine($"Knowledge source '{knowledgeSourceName}' deleted successfully.");

Reference:SearchIndexClient

Erhalten Sie eine Liste aller Wissensdatenbanken für Ihren Suchdienst.

# Get knowledge bases
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

print("Knowledge Bases:")
for kb in index_client.list_knowledge_bases():
    print(f"  - {kb.name}")

Reference:SearchIndexClient

Eine Beispielantwort könnte wie folgt aussehen:

 {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

Rufen Sie eine individuelle Wissensbasisdefinition ab, um nach Wissensquellenverweise zu suchen.

# Get a knowledge base definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
kb = index_client.get_knowledge_base("knowledge_base_name")
print(kb)

Reference:SearchIndexClient

Eine Beispielantwort könnte wie folgt aussehen:

 {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks",
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

# Delete a knowledge base
from azure.core.credentials import AzureKeyCredential 
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
index_client.delete_knowledge_base("knowledge_base_name")
print(f"Knowledge base deleted successfully.")

Reference:SearchIndexClient

Löschen Sie die Wissensquelle.

# Delete a knowledge source
from azure.core.credentials import AzureKeyCredential 
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
index_client.delete_knowledge_source("knowledge_source_name")
print(f"Knowledge source deleted successfully.")

Reference:SearchIndexClient

Erhalten Sie eine Liste aller Wissensdatenbanken für Ihren Suchdienst.

### Get knowledge bases
GET {{search-url}}/knowledgebases?api-version={{api-version}}&$select=name
api-key: {{api-key}}

Referenz:Wissensdatenbanken - Liste

Eine Beispielantwort könnte wie folgt aussehen:

 {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

Rufen Sie eine individuelle Wissensbasisdefinition ab, um nach Wissensquellenverweise zu suchen.

### Get a knowledge base definition
GET {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
api-key: {{api-key}}

Referenz:Wissensdatenbanken - Abrufen

Eine Beispielantwort könnte wie folgt aussehen:

 {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks",
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

Löschen Sie entweder die Wissensdatenbank, oder aktualisieren Sie, wenn Sie über mehrere Wissensquellen verfügen, die Wissensbasis, um die Quelle zu entfernen. In diesem Beispiel wird das Löschen gezeigt.
```
### Delete a knowledge base
DELETE {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
api-key: {{api-key}}
```
Referenz:Knowledge Basen - Löschen

Löschen Sie die Wissensquelle.

### Delete a knowledge source
DELETE {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version={{api-version}}
api-key: {{api-key}}

Referenz:Wissensquellen - Löschen

Feedback

War diese Seite hilfreich?

Last updated on 2026-06-03

Erstellen einer Web-Wissensquelle

Verwendungsunterstützung

Voraussetzungen

Einschränkungen und Überlegungen

Überprüfen auf vorhandene Wissensquellen

Erstellen einer Wissensquelle

Quellspezifische Eigenschaften

Zuweisen zu einer Wissensbasis

Abfragen einer Wissensbasis

Löschen einer Wissensquelle

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen