Udostępnij przez

Tworzenie zasobu źródła wiedzy internetowej

Ważne

Uwaga / Notatka

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Źródło Wiedzy Internetowej umożliwia agentowy potok pobierania danych internetowych w czasie rzeczywistym z usługi Microsoft Bing. Źródła wiedzy są tworzone niezależnie, odwołują się do bazy wiedzy i używane jako dane bazowe, gdy agent lub czatbot wywołuje akcję pobierania w czasie wykonywania zapytania.

Bing Custom Search jest zawsze dostawcą wyszukiwania dla Źródła Wiedzy w Sieci. Chociaż nie można określić alternatywnych dostawców wyszukiwania lub silników, można uwzględniać lub wykluczać określone domeny, takie jak https://learn.microsoft.com. Jeśli nie określono żadnych domen, źródło wiedzy sieci Web ma nieograniczony dostęp do całego publicznego Internetu.

Źródło wiedzy internetowej najlepiej współpracuje z innymi źródłami wiedzy. Użyj internetowego źródła wiedzy, gdy zastrzeżona zawartość nie udostępnia pełnych, up-to-date odpowiedzi lub gdy chcesz uzupełnić wyniki informacjami z komercyjnej wyszukiwarki.

W przypadku korzystania z internetowego źródła wiedzy należy pamiętać o następujących kwestiach:

  • Odpowiedź jest zawsze pojedynczą, sformułowaną odpowiedzią na zapytanie zamiast nieprzetworzonych wyników wyszukiwania z Internetu.

  • Ponieważ źródło wiedzy internetowej nie obsługuje danych wyodrębnianych, baza wiedzy musi korzystać z syntezy odpowiedzi i niskiego lub średniego wysiłku rozumowania. Nie można również zdefiniować instrukcji odpowiedzi.

Wymagania wstępne

Sprawdzanie istniejących źródeł wiedzy

Źródłem wiedzy jest obiekt najwyższego poziomu wielokrotnego użytku. Znajomość istniejących źródeł wiedzy jest przydatna w przypadku ponownego użycia lub nazewnictwa nowych obiektów.

Uruchom następujący kod, aby wyświetlić listę źródeł wiedzy według nazwy i typu.

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

Możesz również zwrócić pojedyncze źródło wiedzy według nazwy, aby przejrzeć jego definicję JSON.

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

Poniższy kod JSON to przykładowa odpowiedź dla zasobu internetowego źródła wiedzy.

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

Tworzenie źródła wiedzy

Uruchom następujący kod, aby utworzyć zasób internetowego źródła wiedzy.

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

Właściwości specyficzne dla źródła

Aby utworzyć zasób źródła wiedzy internetowej, możesz przekazać następujące właściwości.

Name Description Typ Można edytować Required
Name Nazwa źródła wiedzy, które musi być unikatowe w kolekcji źródeł wiedzy i postępować zgodnie z wytycznymi dotyczącymi nazewnictwa obiektów w usłudze Azure AI Search. Sznurek Tak Tak
Description Opis źródła wiedzy. Jeśli nie określono, usługa Azure AI Search zastosuje domyślny opis. Sznurek Tak Nie.
EncryptionKey Klucz zarządzany przez klienta do szyfrowania poufnych informacji w źródle wiedzy. Object Tak Nie.
WebParameters Parametry specyficzne dla internetowego źródła wiedzy. Obecnie jest to tylko Domains. Object Tak Nie.
Domains Domeny do zezwolenia lub zablokowania w przestrzeni wyszukiwania. Domyślnie źródło wiedzy używa funkcji "Grounding with Bing Search" do przeszukiwania całego publicznego Internetu. Podczas określania domen źródło wiedzy używa funkcji Grounding with Bing Custom Search w celu ograniczenia wyników do określonych domen. W obu przypadkach usługa wyszukiwania niestandardowego Bing jest dostawcą wyszukiwania. Object Tak Nie.
AllowedDomains Domeny do uwzględnienia w przestrzeni wyszukiwania. Dla każdej domeny należy określić jej address w formacie website.com. Możesz również określić, czy chcesz uwzględnić podstrony domeny, ustawiając wartość IncludeSubpages na true lub false. Array Tak Nie.
BlockedDomains Domeny do wykluczenia z obszaru wyszukiwania. Dla każdej domeny należy określić jej address w formacie website.com. Możesz również określić, czy chcesz uwzględnić podstrony domeny, ustawiając wartość IncludeSubpages na true lub false. Array Tak Nie.

Przypisywanie do bazy wiedzy

Jeśli źródło wiedzy jest zadowalające, przejdź do następnego kroku: określ źródło wiedzy w bazie wiedzy.

Po skonfigurowaniu bazy wiedzy użyj akcji pobierania , aby wysłać zapytanie do źródła wiedzy.

Usuwanie źródła wiedzy

Aby można było usunąć źródło wiedzy, należy usunąć dowolną bazę wiedzy, która odwołuje się do źródła wiedzy, lub zaktualizować definicję bazy wiedzy, aby usunąć odwołanie. W przypadku źródeł wiedzy, które generują potok indeksu i indeksatora, wszystkie wygenerowane obiekty również są usuwane. Jeśli jednak użyto istniejącego indeksu do utworzenia źródła wiedzy, indeks nie zostanie usunięty.

Jeśli spróbujesz usunąć używane źródło wiedzy, akcja zakończy się niepowodzeniem i zwróci listę baz wiedzy, których dotyczy problem.

Aby usunąć źródło wiedzy:

  1. Pobierz listę wszystkich baz wiedzy w usłudze wyszukiwania.

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

    Przykładowa odpowiedź może wyglądać następująco:

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

  2. Uzyskaj pojedynczą definicję bazy wiedzy, aby sprawdzić odwołania do źródeł wiedzy.

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

    Przykładowa odpowiedź może wyglądać następująco:

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

  3. Usuń bazę wiedzy lub zaktualizuj bazę wiedzy , aby usunąć źródło wiedzy, jeśli masz wiele źródeł. W tym przykładzie pokazano usunięcie.

    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. Usuń źródło wiedzy.

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

Ważne

Uwaga / Notatka

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Źródło Wiedzy Internetowej umożliwia agentowy potok pobierania danych internetowych w czasie rzeczywistym z usługi Microsoft Bing. Źródła wiedzy są tworzone niezależnie, odwołują się do bazy wiedzy i używane jako dane bazowe, gdy agent lub czatbot wywołuje akcję pobierania w czasie wykonywania zapytania.

Bing Custom Search jest zawsze dostawcą wyszukiwania dla Źródła Wiedzy w Sieci. Chociaż nie można określić alternatywnych dostawców wyszukiwania lub silników, można uwzględniać lub wykluczać określone domeny, takie jak https://learn.microsoft.com. Jeśli nie określono żadnych domen, źródło wiedzy sieci Web ma nieograniczony dostęp do całego publicznego Internetu.

Źródło wiedzy internetowej najlepiej współpracuje z innymi źródłami wiedzy. Użyj internetowego źródła wiedzy, gdy zastrzeżona zawartość nie udostępnia pełnych, up-to-date odpowiedzi lub gdy chcesz uzupełnić wyniki informacjami z komercyjnej wyszukiwarki.

W przypadku korzystania z internetowego źródła wiedzy należy pamiętać o następujących kwestiach:

  • Odpowiedź jest zawsze pojedynczą, sformułowaną odpowiedzią na zapytanie zamiast nieprzetworzonych wyników wyszukiwania z Internetu.

  • Ponieważ źródło wiedzy internetowej nie obsługuje danych wyodrębnianych, baza wiedzy musi korzystać z syntezy odpowiedzi i niskiego lub średniego wysiłku rozumowania. Nie można również zdefiniować instrukcji odpowiedzi.

Wymagania wstępne

Sprawdzanie istniejących źródeł wiedzy

Źródłem wiedzy jest obiekt najwyższego poziomu wielokrotnego użytku. Znajomość istniejących źródeł wiedzy jest przydatna w przypadku ponownego użycia lub nazewnictwa nowych obiektów.

Uruchom następujący kod, aby wyświetlić listę źródeł wiedzy według nazwy i typu.

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

Możesz również zwrócić pojedyncze źródło wiedzy według nazwy, aby przejrzeć jego definicję JSON.

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

Poniższy kod JSON to przykładowa odpowiedź dla zasobu internetowego źródła wiedzy.

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

Tworzenie źródła wiedzy

Uruchom następujący kod, aby utworzyć zasób internetowego źródła wiedzy.

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

Właściwości specyficzne dla źródła

Aby utworzyć zasób źródła wiedzy internetowej, możesz przekazać następujące właściwości.

Name Description Typ Można edytować Required
name Nazwa źródła wiedzy, które musi być unikatowe w kolekcji źródeł wiedzy i postępować zgodnie z wytycznymi dotyczącymi nazewnictwa obiektów w usłudze Azure AI Search. Sznurek Tak Tak
description Opis źródła wiedzy. Jeśli nie określono, usługa Azure AI Search zastosuje domyślny opis. Sznurek Tak Nie.
encryption_key Klucz zarządzany przez klienta do szyfrowania poufnych informacji w źródle wiedzy. Object Tak Nie.
web_parameters Parametry specyficzne dla internetowego źródła wiedzy. Obecnie jest to tylko domains. Object Tak Nie.
domains Domeny do zezwolenia lub zablokowania w przestrzeni wyszukiwania. Domyślnie źródło wiedzy używa funkcji "Grounding with Bing Search" do przeszukiwania całego publicznego Internetu. Podczas określania domen źródło wiedzy używa funkcji Grounding with Bing Custom Search w celu ograniczenia wyników do określonych domen. W obu przypadkach usługa wyszukiwania niestandardowego Bing jest dostawcą wyszukiwania. Object Tak Nie.
allowed_domains Domeny do uwzględnienia w przestrzeni wyszukiwania. Dla każdej domeny należy określić jej address w formacie website.com. Możesz również określić, czy chcesz uwzględnić podstrony domeny, ustawiając wartość include_subpages na true lub false. Array Tak Nie.
blocked_domains Domeny do wykluczenia z obszaru wyszukiwania. Dla każdej domeny należy określić jej address w formacie website.com. Możesz również określić, czy chcesz uwzględnić podstrony domeny, ustawiając wartość include_subpages na true lub false. Array Tak Nie.

Przypisywanie do bazy wiedzy

Jeśli źródło wiedzy jest zadowalające, przejdź do następnego kroku: określ źródło wiedzy w bazie wiedzy.

Po skonfigurowaniu bazy wiedzy użyj akcji pobierania , aby wysłać zapytanie do źródła wiedzy.

Usuwanie źródła wiedzy

Aby można było usunąć źródło wiedzy, należy usunąć dowolną bazę wiedzy, która odwołuje się do źródła wiedzy, lub zaktualizować definicję bazy wiedzy, aby usunąć odwołanie. W przypadku źródeł wiedzy, które generują potok indeksu i indeksatora, wszystkie wygenerowane obiekty również są usuwane. Jeśli jednak użyto istniejącego indeksu do utworzenia źródła wiedzy, indeks nie zostanie usunięty.

Jeśli spróbujesz usunąć używane źródło wiedzy, akcja zakończy się niepowodzeniem i zwróci listę baz wiedzy, których dotyczy problem.

Aby usunąć źródło wiedzy:

  1. Pobierz listę wszystkich baz wiedzy w usłudze wyszukiwania.

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

    Przykładowa odpowiedź może wyglądać następująco:

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

  2. Uzyskaj pojedynczą definicję bazy wiedzy, aby sprawdzić odwołania do źródeł wiedzy.

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

    Przykładowa odpowiedź może wyglądać następująco:

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

  3. Usuń bazę wiedzy lub zaktualizuj bazę wiedzy , aby usunąć źródło wiedzy, jeśli masz wiele źródeł. W tym przykładzie pokazano usunięcie.

    # 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. Usuń źródło wiedzy.

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

Ważne

Uwaga / Notatka

Ta funkcja jest obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie jest zalecana w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

Źródło Wiedzy Internetowej umożliwia agentowy potok pobierania danych internetowych w czasie rzeczywistym z usługi Microsoft Bing. Źródła wiedzy są tworzone niezależnie, odwołują się do bazy wiedzy i używane jako dane bazowe, gdy agent lub czatbot wywołuje akcję pobierania w czasie wykonywania zapytania.

Bing Custom Search jest zawsze dostawcą wyszukiwania dla Źródła Wiedzy w Sieci. Chociaż nie można określić alternatywnych dostawców wyszukiwania lub silników, można uwzględniać lub wykluczać określone domeny, takie jak https://learn.microsoft.com. Jeśli nie określono żadnych domen, źródło wiedzy sieci Web ma nieograniczony dostęp do całego publicznego Internetu.

Źródło wiedzy internetowej najlepiej współpracuje z innymi źródłami wiedzy. Użyj internetowego źródła wiedzy, gdy zastrzeżona zawartość nie udostępnia pełnych, up-to-date odpowiedzi lub gdy chcesz uzupełnić wyniki informacjami z komercyjnej wyszukiwarki.

W przypadku korzystania z internetowego źródła wiedzy należy pamiętać o następujących kwestiach:

  • Odpowiedź jest zawsze pojedynczą, sformułowaną odpowiedzią na zapytanie zamiast nieprzetworzonych wyników wyszukiwania z Internetu.

  • Ponieważ źródło wiedzy internetowej nie obsługuje danych wyodrębnianych, baza wiedzy musi korzystać z syntezy odpowiedzi i niskiego lub średniego wysiłku rozumowania. Nie można również zdefiniować instrukcji odpowiedzi.

Wymagania wstępne

Sprawdzanie istniejących źródeł wiedzy

Źródłem wiedzy jest obiekt najwyższego poziomu wielokrotnego użytku. Znajomość istniejących źródeł wiedzy jest przydatna w przypadku ponownego użycia lub nazewnictwa nowych obiektów.

Użyj Knowledge Sources - Get (REST API), aby wyświetlić listę źródeł wiedzy według nazwy i typu.

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

Możesz również zwrócić pojedyncze źródło wiedzy według nazwy, aby przejrzeć jego definicję JSON.

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

Poniższy kod JSON to przykładowa odpowiedź dla zasobu internetowego źródła wiedzy.

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

Tworzenie źródła wiedzy

Użyj Knowledge Sources - Create or Update (REST API), aby utworzyć zasób Web Knowledge Source.

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 } ]
    }
  }
}

Właściwości specyficzne dla źródła

Aby utworzyć zasób źródła wiedzy internetowej, możesz przekazać następujące właściwości.

Name Description Typ Można edytować Required
name Nazwa źródła wiedzy, które musi być unikatowe w kolekcji źródeł wiedzy i postępować zgodnie z wytycznymi dotyczącymi nazewnictwa obiektów w usłudze Azure AI Search. Sznurek Tak Tak
kind Rodzaj źródła wiedzy, który jest web w tym przypadku. Sznurek Nie. Tak
description Opis źródła wiedzy. Jeśli nie określono, usługa Azure AI Search zastosuje domyślny opis. Sznurek Tak Nie.
encryptionKey Klucz zarządzany przez klienta do szyfrowania poufnych informacji w źródle wiedzy. Object Tak Nie.
webParameters Parametry specyficzne dla internetowego źródła wiedzy. Obecnie jest to tylko domains. Object Tak Nie.
domains Domeny do zezwolenia lub zablokowania w przestrzeni wyszukiwania. Domyślnie źródło wiedzy używa funkcji "Grounding with Bing Search" do przeszukiwania całego publicznego Internetu. Podczas określania domen źródło wiedzy używa funkcji Grounding with Bing Custom Search w celu ograniczenia wyników do określonych domen. W obu przypadkach usługa wyszukiwania niestandardowego Bing jest dostawcą wyszukiwania. Object Tak Nie.
allowedDomains Domeny do uwzględnienia w przestrzeni wyszukiwania. Dla każdej domeny należy określić jej address w formacie website.com. Możesz również określić, czy chcesz uwzględnić podstrony domeny, ustawiając wartość includeSubpages na true lub false. Array Tak Nie.
blockedDomains Domeny do wykluczenia z obszaru wyszukiwania. Dla każdej domeny należy określić jej address w formacie website.com. Możesz również określić, czy chcesz uwzględnić podstrony domeny, ustawiając wartość includeSubpages na true lub false. Array Tak Nie.

Przypisywanie do bazy wiedzy

Jeśli źródło wiedzy jest zadowalające, przejdź do następnego kroku: określ źródło wiedzy w bazie wiedzy.

Po skonfigurowaniu bazy wiedzy użyj akcji pobierania , aby wysłać zapytanie do źródła wiedzy.

Usuwanie źródła wiedzy

Aby można było usunąć źródło wiedzy, należy usunąć dowolną bazę wiedzy, która odwołuje się do źródła wiedzy, lub zaktualizować definicję bazy wiedzy, aby usunąć odwołanie. W przypadku źródeł wiedzy, które generują potok indeksu i indeksatora, wszystkie wygenerowane obiekty również są usuwane. Jeśli jednak użyto istniejącego indeksu do utworzenia źródła wiedzy, indeks nie zostanie usunięty.

Jeśli spróbujesz usunąć używane źródło wiedzy, akcja zakończy się niepowodzeniem i zwróci listę baz wiedzy, których dotyczy problem.

Aby usunąć źródło wiedzy:

  1. Pobierz listę wszystkich baz wiedzy w usłudze wyszukiwania.

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

    Przykładowa odpowiedź może wyglądać następująco:

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

  2. Uzyskaj pojedynczą definicję bazy wiedzy, aby sprawdzić odwołania do źródeł wiedzy.

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

    Przykładowa odpowiedź może wyglądać następująco:

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

  3. Usuń bazę wiedzy lub zaktualizuj bazę wiedzy , usuwając źródło wiedzy, jeśli masz wiele źródeł. W tym przykładzie pokazano usunięcie.

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

  4. Usuń źródło wiedzy.

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

Treści powiązane

  • Last updated on