Delen via

Een webkennisbronresource maken

Belangrijk

Opmerking

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview wordt geleverd zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.

Web Knowledge Source maakt het mogelijk om realtime webgegevens van Microsoft Bing op te halen in een agent-gebaseerde ophaalpijplijn. Kennisbronnen worden onafhankelijk gemaakt, waarnaar wordt verwezen in een knowledge base en worden gebruikt als basisgegevens wanneer een agent of chatbot een ophaalactie aanroept tijdens het uitvoeren van query's.

Bing Custom Search is altijd de zoekprovider voor webkennisbron. Hoewel u geen alternatieve zoekproviders of engines kunt opgeven, kunt u specifieke domeinen opnemen of uitsluiten, zoals https://learn.microsoft.com. Wanneer er geen domeinen zijn opgegeven, heeft Web Knowledge Source onbeperkte toegang tot het hele openbare internet.

Web Knowledge Source werkt het beste naast andere kennisbronnen. Gebruik de webkennisbron wanneer uw eigen inhoud geen volledige, actuele antwoorden verstrekt of wanneer u resultaten wilt aanvullen met informatie van een commerciële zoekmachine.

Houd rekening met het volgende wanneer u Web Knowledge Source gebruikt:

  • Het antwoord is altijd één, geformuleerd antwoord op de query in plaats van onbewerkte zoekresultaten van het web.

  • Omdat Web Knowledge Source geen ondersteuning biedt voor extractieve gegevens, moet uw knowledge base antwoordsynthese en weinig of gemiddelde redenering gebruiken. U kunt ook geen antwoordinstructies definiëren.

Vereiste voorwaarden

Controleren op bestaande kennisbronnen

Een kennisbron is een herbruikbaar object op het hoogste niveau. Kennis over bestaande kennisbronnen is handig voor het opnieuw gebruiken of benoemen van nieuwe objecten.

Voer de volgende code uit om kennisbronnen op naam en type weer te geven.

// 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}");
}

U kunt ook één kennisbron op naam retourneren om de JSON-definitie ervan te controleren.

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));

De volgende JSON is een voorbeeldantwoord voor een Web Knowledge Source-bron.

{
  "WebParameters": {
    "Domains": null
  },
  "Name": "my-web-ks",
  "Description": "A sample Web Knowledge Source.",
  "EncryptionKey": null,
}

Een kennisbron maken

Voer de volgende code uit om een webkennisbronresource te maken.

// Create Web Knowledge Source
// Create a 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.");

Bronspecifieke eigenschappen

U kunt de volgende eigenschappen doorgeven om een webkennisbronresource te maken.

Naam Description Typologie Bewerkbaar Verplicht
Name De naam van de kennisbron, die uniek moet zijn binnen de verzameling kennisbronnen en de naamgevingsrichtlijnen voor objecten in Azure AI Search moet volgen. Snaar / Touwtje Yes Yes
Description Een beschrijving van de kennisbron. Wanneer deze niet is opgegeven, wordt in Azure AI Search een standaardbeschrijving toegepast. Snaar / Touwtje Yes Nee.
EncryptionKey Een door de klant beheerde sleutel voor het versleutelen van gevoelige informatie in de kennisbron. Object Yes Nee.
WebParameters Parameters die specifiek zijn voor webkennisbron. Op dit moment is dit alleen Domains. Object Yes Nee.
Domains Domeinen om toe te staan of te blokkeren in zoekopdrachten. De kennisbron maakt standaard gebruik van Grounding met Bing Search om het hele openbare internet te doorzoeken. Wanneer u domeinen opgeeft, gebruikt de kennisbron Grounding met Bing Custom Search om resultaten te beperken tot de opgegeven domeinen. In beide gevallen is Bing Custom Search de zoekprovider. Object Yes Nee.
AllowedDomains Domeinen die moeten worden opgenomen in de zoekruimte. Voor elk domein moet u zijn address in het website.com-formaat opgeven. U kunt ook opgeven of de subpagina's van het domein moeten worden opgenomen door IncludeSubpages in te stellen op true of false. Array Yes Nee.
BlockedDomains Domeinen die moeten worden uitgesloten van de zoekruimte. Voor elk domein moet u zijn address in het website.com-formaat opgeven. U kunt ook opgeven of de subpagina's van het domein moeten worden opgenomen door IncludeSubpages in te stellen op true of false. Array Yes Nee.

Toewijzen aan een kennisbank

Als u tevreden bent met de kennisbron, gaat u verder met de volgende stap: geef de kennisbron op in een knowledge base.

Nadat de knowledge base is geconfigureerd, gebruikt u de actie ophalen om een query uit te voeren op de kennisbron.

Een kennisbron verwijderen

Voordat u een kennisbron kunt verwijderen, moet u een knowledge base verwijderen die ernaar verwijst of de knowledge base-definitie bijwerken om de verwijzing te verwijderen. Voor kennisbronnen die een index- en indexeerpijplijn genereren, worden ook alle gegenereerde objecten verwijderd. Als u echter een bestaande index hebt gebruikt om een kennisbron te maken, wordt uw index niet verwijderd.

Als u probeert een kennisbron te verwijderen die in gebruik is, mislukt de actie en wordt een lijst met betrokken knowledge bases geretourneerd.

Een kennisbron verwijderen:

  1. Haal een lijst op met alle knowledge bases op uw zoekservice.

    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}");
}

    Een voorbeeld van een antwoord kan er als volgt uitzien:

     Knowledge Bases:
   - earth-knowledge-base
   - hotels-sample-knowledge-base
   - my-demo-knowledge-base

  2. Haal een afzonderlijke Knowledge Base-definitie op om te controleren op verwijzingen naar kennisbronnen.

    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);

    Een voorbeeld van een antwoord kan er als volgt uitzien:

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

  3. Verwijder de knowledge base of werk de knowledge base bij om de kennisbron te verwijderen als u meerdere bronnen hebt. In dit voorbeeld ziet u de verwijdering.

    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.");

  4. Verwijder de kennisbron.

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

Belangrijk

Opmerking

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview wordt geleverd zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.

Web Knowledge Source maakt het mogelijk om realtime webgegevens van Microsoft Bing op te halen in een agent-gebaseerde ophaalpijplijn. Kennisbronnen worden onafhankelijk gemaakt, waarnaar wordt verwezen in een knowledge base en worden gebruikt als basisgegevens wanneer een agent of chatbot een ophaalactie aanroept tijdens het uitvoeren van query's.

Bing Custom Search is altijd de zoekprovider voor webkennisbron. Hoewel u geen alternatieve zoekproviders of engines kunt opgeven, kunt u specifieke domeinen opnemen of uitsluiten, zoals https://learn.microsoft.com. Wanneer er geen domeinen zijn opgegeven, heeft Web Knowledge Source onbeperkte toegang tot het hele openbare internet.

Web Knowledge Source werkt het beste naast andere kennisbronnen. Gebruik de webkennisbron wanneer uw eigen inhoud geen volledige, actuele antwoorden verstrekt of wanneer u resultaten wilt aanvullen met informatie van een commerciële zoekmachine.

Houd rekening met het volgende wanneer u Web Knowledge Source gebruikt:

  • Het antwoord is altijd één, geformuleerd antwoord op de query in plaats van onbewerkte zoekresultaten van het web.

  • Omdat Web Knowledge Source geen ondersteuning biedt voor extractieve gegevens, moet uw knowledge base antwoordsynthese en weinig of gemiddelde redenering gebruiken. U kunt ook geen antwoordinstructies definiëren.

Vereiste voorwaarden

Controleren op bestaande kennisbronnen

Een kennisbron is een herbruikbaar object op het hoogste niveau. Kennis over bestaande kennisbronnen is handig voor het opnieuw gebruiken of benoemen van nieuwe objecten.

Voer de volgende code uit om kennisbronnen op naam en type weer te geven.

# List knowledge sources by name and type
import requests
import json

endpoint = "{search_url}/knowledgesources"
params = {"api-version": "2025-11-01-preview", "$select": "name, kind"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

U kunt ook één kennisbron op naam retourneren om de JSON-definitie ervan te controleren.

# Get a knowledge source definition
import requests
import json

endpoint = "{search_url}/knowledgesources/{knowledge_source_name}"
params = {"api-version": "2025-11-01-preview"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

De volgende JSON is een voorbeeldantwoord voor een Web Knowledge Source-bron.

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

Een kennisbron maken

Voer de volgende code uit om een webkennisbronresource te maken.

# 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

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 = [ { "address": "learn.microsoft.com", "include_subpages": True } ],
            blocked_domains = [ { "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.")

Bronspecifieke eigenschappen

U kunt de volgende eigenschappen doorgeven om een webkennisbronresource te maken.

Naam Description Typologie Bewerkbaar Verplicht
name De naam van de kennisbron, die uniek moet zijn binnen de verzameling kennisbronnen en de naamgevingsrichtlijnen voor objecten in Azure AI Search moet volgen. Snaar / Touwtje Yes Yes
description Een beschrijving van de kennisbron. Wanneer deze niet is opgegeven, wordt in Azure AI Search een standaardbeschrijving toegepast. Snaar / Touwtje Yes Nee.
encryption_key Een door de klant beheerde sleutel voor het versleutelen van gevoelige informatie in de kennisbron. Object Yes Nee.
web_parameters Parameters die specifiek zijn voor webkennisbron. Op dit moment is dit alleen domains. Object Yes Nee.
domains Domeinen om toe te staan of te blokkeren in zoekopdrachten. De kennisbron maakt standaard gebruik van Grounding met Bing Search om het hele openbare internet te doorzoeken. Wanneer u domeinen opgeeft, gebruikt de kennisbron Grounding met Bing Custom Search om resultaten te beperken tot de opgegeven domeinen. In beide gevallen is Bing Custom Search de zoekprovider. Object Yes Nee.
allowed_domains Domeinen die moeten worden opgenomen in de zoekruimte. Voor elk domein moet u zijn address in het website.com-formaat opgeven. U kunt ook opgeven of de subpagina's van het domein moeten worden opgenomen door include_subpages in te stellen op true of false. Array Yes Nee.
blocked_domains Domeinen die moeten worden uitgesloten van de zoekruimte. Voor elk domein moet u zijn address in het website.com-formaat opgeven. U kunt ook opgeven of de subpagina's van het domein moeten worden opgenomen door include_subpages in te stellen op true of false. Array Yes Nee.

Toewijzen aan een kennisbank

Als u tevreden bent met de kennisbron, gaat u verder met de volgende stap: geef de kennisbron op in een knowledge base.

Nadat de knowledge base is geconfigureerd, gebruikt u de actie ophalen om een query uit te voeren op de kennisbron.

Een kennisbron verwijderen

Voordat u een kennisbron kunt verwijderen, moet u een knowledge base verwijderen die ernaar verwijst of de knowledge base-definitie bijwerken om de verwijzing te verwijderen. Voor kennisbronnen die een index- en indexeerpijplijn genereren, worden ook alle gegenereerde objecten verwijderd. Als u echter een bestaande index hebt gebruikt om een kennisbron te maken, wordt uw index niet verwijderd.

Als u probeert een kennisbron te verwijderen die in gebruik is, mislukt de actie en wordt een lijst met betrokken knowledge bases geretourneerd.

Een kennisbron verwijderen:

  1. Haal een lijst op met alle knowledge bases op uw zoekservice.

    # Get knowledge bases
import requests
import json

endpoint = "{search_url}/knowledgebases"
params = {"api-version": "2025-11-01-preview", "$select": "name"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

    Een voorbeeld van een antwoord kan er als volgt uitzien:

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

  2. Haal een afzonderlijke Knowledge Base-definitie op om te controleren op verwijzingen naar kennisbronnen.

    # Get a knowledge base definition
import requests
import json

endpoint = "{search_url}/knowledgebases/{knowledge_base_name}"
params = {"api-version": "2025-11-01-preview"}
headers = {"api-key": "{api_key}"}

response = requests.get(endpoint, params = params, headers = headers)
print(json.dumps(response.json(), indent = 2))

    Een voorbeeld van een antwoord kan er als volgt uitzien:

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

  3. Verwijder de knowledge base of werk de knowledge base bij om de kennisbron te verwijderen als u meerdere bronnen hebt. In dit voorbeeld ziet u de verwijdering.

    # 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.")

  4. Verwijder de kennisbron.

    # 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.")

Belangrijk

Opmerking

Deze functie is momenteel beschikbaar als openbare preview-versie. Deze preview wordt geleverd zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.

Web Knowledge Source maakt het mogelijk om realtime webgegevens van Microsoft Bing op te halen in een agent-gebaseerde ophaalpijplijn. Kennisbronnen worden onafhankelijk gemaakt, waarnaar wordt verwezen in een knowledge base en worden gebruikt als basisgegevens wanneer een agent of chatbot een ophaalactie aanroept tijdens het uitvoeren van query's.

Bing Custom Search is altijd de zoekprovider voor webkennisbron. Hoewel u geen alternatieve zoekproviders of engines kunt opgeven, kunt u specifieke domeinen opnemen of uitsluiten, zoals https://learn.microsoft.com. Wanneer er geen domeinen zijn opgegeven, heeft Web Knowledge Source onbeperkte toegang tot het hele openbare internet.

Web Knowledge Source werkt het beste naast andere kennisbronnen. Gebruik de webkennisbron wanneer uw eigen inhoud geen volledige, actuele antwoorden verstrekt of wanneer u resultaten wilt aanvullen met informatie van een commerciële zoekmachine.

Houd rekening met het volgende wanneer u Web Knowledge Source gebruikt:

  • Het antwoord is altijd één, geformuleerd antwoord op de query in plaats van onbewerkte zoekresultaten van het web.

  • Omdat Web Knowledge Source geen ondersteuning biedt voor extractieve gegevens, moet uw knowledge base antwoordsynthese en weinig of gemiddelde redenering gebruiken. U kunt ook geen antwoordinstructies definiëren.

Vereiste voorwaarden

Controleren op bestaande kennisbronnen

Een kennisbron is een herbruikbaar object op het hoogste niveau. Kennis over bestaande kennisbronnen is handig voor het opnieuw gebruiken of benoemen van nieuwe objecten.

Gebruik Knowledge Sources - Get (REST API) om kennisbronnen op naam en type weer te geven.

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

U kunt ook één kennisbron op naam retourneren om de JSON-definitie ervan te controleren.

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

De volgende JSON is een voorbeeldantwoord voor een Web Knowledge Source-bron.

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

Een kennisbron maken

Kennisbronnen gebruiken: een Web Knowledge Source-resource maken of bijwerken (REST API ).

PUT {{search-url}}/knowledgesources/my-web-ks?api-version=2025-11-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 } ]
    }
  }
}

Bronspecifieke eigenschappen

U kunt de volgende eigenschappen doorgeven om een webkennisbronresource te maken.

Naam Description Typologie Bewerkbaar Verplicht
name De naam van de kennisbron, die uniek moet zijn binnen de verzameling kennisbronnen en de naamgevingsrichtlijnen voor objecten in Azure AI Search moet volgen. Snaar / Touwtje Yes Yes
kind Het soort kennisbron, in dit geval web. Snaar / Touwtje Nee. Yes
description Een beschrijving van de kennisbron. Wanneer deze niet is opgegeven, wordt in Azure AI Search een standaardbeschrijving toegepast. Snaar / Touwtje Yes Nee.
encryptionKey Een door de klant beheerde sleutel voor het versleutelen van gevoelige informatie in de kennisbron. Object Yes Nee.
webParameters Parameters die specifiek zijn voor webkennisbron. Op dit moment is dit alleen domains. Object Yes Nee.
domains Domeinen om toe te staan of te blokkeren in zoekopdrachten. De kennisbron maakt standaard gebruik van Grounding met Bing Search om het hele openbare internet te doorzoeken. Wanneer u domeinen opgeeft, gebruikt de kennisbron Grounding met Bing Custom Search om resultaten te beperken tot de opgegeven domeinen. In beide gevallen is Bing Custom Search de zoekprovider. Object Yes Nee.
allowedDomains Domeinen die moeten worden opgenomen in de zoekruimte. Voor elk domein moet u zijn address in het website.com-formaat opgeven. U kunt ook opgeven of de subpagina's van het domein moeten worden opgenomen door includeSubpages in te stellen op true of false. Array Yes Nee.
blockedDomains Domeinen die moeten worden uitgesloten van de zoekruimte. Voor elk domein moet u zijn address in het website.com-formaat opgeven. U kunt ook opgeven of de subpagina's van het domein moeten worden opgenomen door includeSubpages in te stellen op true of false. Array Yes Nee.

Toewijzen aan een kennisbank

Als u tevreden bent met de kennisbron, gaat u verder met de volgende stap: geef de kennisbron op in een knowledge base.

Nadat de knowledge base is geconfigureerd, gebruikt u de actie ophalen om een query uit te voeren op de kennisbron.

Een kennisbron verwijderen

Voordat u een kennisbron kunt verwijderen, moet u een knowledge base verwijderen die ernaar verwijst of de knowledge base-definitie bijwerken om de verwijzing te verwijderen. Voor kennisbronnen die een index- en indexeerpijplijn genereren, worden ook alle gegenereerde objecten verwijderd. Als u echter een bestaande index hebt gebruikt om een kennisbron te maken, wordt uw index niet verwijderd.

Als u probeert een kennisbron te verwijderen die in gebruik is, mislukt de actie en wordt een lijst met betrokken knowledge bases geretourneerd.

Een kennisbron verwijderen:

  1. Haal een lijst op met alle knowledge bases op uw zoekservice.

    ### Get knowledge bases
GET {{search-endpoint}}/knowledgebases?api-version=2025-11-01-preview&$select=name
api-key: {{api-key}}

    Een voorbeeld van een antwoord kan er als volgt uitzien:

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

  2. Haal een afzonderlijke Knowledge Base-definitie op om te controleren op verwijzingen naar kennisbronnen.

    ### Get a knowledge base definition
GET {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

    Een voorbeeld van een antwoord kan er als volgt uitzien:

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

  3. Verwijder de knowledge base of werk de knowledge base bij door de kennisbron te verwijderen als u meerdere bronnen hebt. In dit voorbeeld ziet u de verwijdering.

    ### Delete a knowledge base
DELETE {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

  4. Verwijder de kennisbron.

    ### Delete a knowledge source
DELETE {{search-endpoint}}/knowledgesources/{{knowledge-source-name}}?api-version=2025-11-01-preview
api-key: {{api-key}}

Verwante inhoud

  • Last updated on