Aracılığıyla paylaş

Web Bilgi Kaynağı kaynağı oluşturma

Önemli

Uyarı

Bu özellik şu anda genel önizlemededir. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Web Bilgi Kaynağı , Microsoft Bing'den gerçek zamanlı web verilerinin aracılı bir alma işlem hattında alınmasını sağlar. Bilgi kaynakları bağımsız olarak oluşturulur, bilgi bankasında başvurulur ve bir aracı veya sohbet botu sorgu zamanında alma eylemi çağırdığında temel veri olarak kullanılır.

Bing Özel Arama her zaman Web Bilgi Kaynağı için arama sağlayıcısıdır. Alternatif arama sağlayıcıları veya altyapıları belirtemeseniz de, gibi belirli https://learn.microsoft.com dahil edebilir veya hariç tutabilirsiniz. Etki alanı belirtilmediğinde, Web Bilgi Kaynağı'nın tüm genel İnternet'e sınırsız erişimi vardır.

Web Bilgi Kaynağı en iyi şekilde diğer bilgi kaynaklarıyla birlikte çalışır. Özel içeriğiniz eksiksiz, up-togüncel yanıtlar sağlamadığında veya ticari bir arama motorundan gelen bilgilerle sonuçları tamamlamak istediğinizde Web Bilgi Kaynağı'ndan faydalanabilirsiniz.

Web Bilgi Kaynağı'nı kullanırken aşağıdakileri göz önünde bulundurun:

Kullanım desteği

Azure portalı Microsoft Foundry portalı .NET SDK Python SDK'sı Java SDK'sı JavaScript SDK'sı REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Önkoşullar

Mevcut bilgi kaynaklarını denetleme

Bilgi kaynağı üst düzey, yeniden kullanılabilir bir nesnedir. Mevcut bilgi kaynakları hakkında bilgi edinmek, yeni nesneleri yeniden kullanmak veya adlandırmak için yararlıdır.

Bilgi kaynaklarını ada ve türe göre listelemek için aşağıdaki kodu çalıştırın.

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

JSON tanımını gözden geçirmek için ada göre tek bir bilgi kaynağı da döndürebilirsiniz.

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

Aşağıdaki JSON, Web Bilgi Kaynağı kaynağı için örnek bir yanıttır.

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

Bilgi kaynağı oluşturma

Web Bilgi Kaynağı kaynağı oluşturmak için aşağıdaki kodu çalıştırın.

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

Kaynağa özgü özellikler

Web Bilgi Kaynağı kaynağı oluşturmak için aşağıdaki özellikleri geçirebilirsiniz.

İsim Description Türü Düzenlenebilir Gerekli
Name Bilgi kaynakları koleksiyonunda benzersiz olması ve Azure AI Search'teki nesneler için adlandırma yönergelerini izlemesi gereken bilgi kaynağının adı. String Yes Yes
Description Bilgi kaynağının açıklaması. Belirtilmediğinde Azure AI Search varsayılan bir açıklama uygular. String Yes Hayı
EncryptionKey Bilgi kaynağındaki hassas bilgileri şifrelemek için müşteri tarafından yönetilen anahtar . Nesne Yes Hayı
WebParameters Web Bilgi Kaynağına özgü parametreler. Şu anda yalnızca Domainsbudur. Nesne Yes Hayı
Domains Arama alanında izin verilecek veya engellenecek etki alanları. Varsayılan olarak, bilgi kaynağı genel İnternet'in tamamında arama yapmak için Bing Arama ile Topraklama'yı kullanır. Etki alanlarını belirttiğinizde, bilgi kaynağı sonuçları belirtilen etki alanlarıyla kısıtlamak için Bing Özel Arama ile Temellendirme'yi kullanır. Her iki durumda da arama sağlayıcısı Bing Özel Arama'dır. Nesne Yes Hayı
AllowedDomains Arama alanı için eklenecek alan adları. Her etki alanı için, etki alanını addresswebsite.com biçiminde belirtmeniz gerekir. Etki alanının alt sayfalarını dahil edip etmeyeceğinizi IncludeSubpages öğesini true veya false olarak ayarlayarak da belirtebilirsiniz. Array Yes Hayı
BlockedDomains Arama alanından hariç tutulacak alan adları. Her etki alanı için, etki alanını addresswebsite.com biçiminde belirtmeniz gerekir. Etki alanının alt sayfalarını dahil edip etmeyeceğinizi IncludeSubpages öğesini true veya false olarak ayarlayarak da belirtebilirsiniz. Array Yes Hayı

Bilgi bankasına atama

Bilgi kaynağından memnunsanız bir sonraki adıma geçin: Bilgi bankasında bilgi kaynağını belirtin.

Bilgi bankası yapılandırıldıktan sonra, bilgi kaynağını sorgulamak için alma eylemini kullanın.

Bilgi kaynağını silme

Bilgi kaynağını silebilmeniz için önce, buna başvuran bilgi bankalarını silmeniz veya başvuruyu kaldırmak için bilgi bankası tanımını güncelleştirmeniz gerekir. Dizin ve dizin oluşturucu işlem hattı oluşturan bilgi kaynakları için , oluşturulan tüm nesneler de silinir. Ancak, bilgi kaynağı oluşturmak için mevcut bir dizini kullandıysanız dizininiz silinmez.

Kullanımda olan bir bilgi kaynağını silmeye çalışırsanız, eylem başarısız olur ve etkilenen bilgi bankalarının listesini döndürür.

Bilgi kaynağını silmek için:

  1. Arama hizmetinizdeki tüm bilgi bankalarının listesini alın.

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

    Örnek bir yanıt aşağıdaki gibi görünebilir:

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

  2. Bilgi kaynağı başvurularını denetlemek için tek bir bilgi bankası tanımı alın.

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

    Örnek bir yanıt aşağıdaki gibi görünebilir:

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

  3. Bilgi bankasını silin veya birden çok kaynağınız varsa bilgi kaynağını kaldırmak için bilgi bankasını güncelleştirin . Bu örnekte silme işlemi gösterilmektedir.

    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. Bilgi kaynağını silin.

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

Önemli

Uyarı

Bu özellik şu anda genel önizlemededir. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Web Bilgi Kaynağı , Microsoft Bing'den gerçek zamanlı web verilerinin aracılı bir alma işlem hattında alınmasını sağlar. Bilgi kaynakları bağımsız olarak oluşturulur, bilgi bankasında başvurulur ve bir aracı veya sohbet botu sorgu zamanında alma eylemi çağırdığında temel veri olarak kullanılır.

Bing Özel Arama her zaman Web Bilgi Kaynağı için arama sağlayıcısıdır. Alternatif arama sağlayıcıları veya altyapıları belirtemeseniz de, gibi belirli https://learn.microsoft.com dahil edebilir veya hariç tutabilirsiniz. Etki alanı belirtilmediğinde, Web Bilgi Kaynağı'nın tüm genel İnternet'e sınırsız erişimi vardır.

Web Bilgi Kaynağı en iyi şekilde diğer bilgi kaynaklarıyla birlikte çalışır. Özel içeriğiniz eksiksiz, up-togüncel yanıtlar sağlamadığında veya ticari bir arama motorundan gelen bilgilerle sonuçları tamamlamak istediğinizde Web Bilgi Kaynağı'ndan faydalanabilirsiniz.

Web Bilgi Kaynağı'nı kullanırken aşağıdakileri göz önünde bulundurun:

Kullanım desteği

Azure portalı Microsoft Foundry portalı .NET SDK Python SDK'sı Java SDK'sı JavaScript SDK'sı REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Önkoşullar

Mevcut bilgi kaynaklarını denetleme

Bilgi kaynağı üst düzey, yeniden kullanılabilir bir nesnedir. Mevcut bilgi kaynakları hakkında bilgi edinmek, yeni nesneleri yeniden kullanmak veya adlandırmak için yararlıdır.

Bilgi kaynaklarını ada ve türe göre listelemek için aşağıdaki kodu çalıştırın.

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

JSON tanımını gözden geçirmek için ada göre tek bir bilgi kaynağı da döndürebilirsiniz.

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

Aşağıdaki JSON, Web Bilgi Kaynağı kaynağı için örnek bir yanıttır.

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

Bilgi kaynağı oluşturma

Web Bilgi Kaynağı kaynağı oluşturmak için aşağıdaki kodu çalıştırın.

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

Kaynağa özgü özellikler

Web Bilgi Kaynağı kaynağı oluşturmak için aşağıdaki özellikleri geçirebilirsiniz.

İsim Description Türü Düzenlenebilir Gerekli
name Bilgi kaynakları koleksiyonunda benzersiz olması ve Azure AI Search'teki nesneler için adlandırma yönergelerini izlemesi gereken bilgi kaynağının adı. String Yes Yes
description Bilgi kaynağının açıklaması. Belirtilmediğinde Azure AI Search varsayılan bir açıklama uygular. String Yes Hayı
encryption_key Bilgi kaynağındaki hassas bilgileri şifrelemek için müşteri tarafından yönetilen anahtar . Nesne Yes Hayı
web_parameters Web Bilgi Kaynağına özgü parametreler. Şu anda yalnızca domainsbudur. Nesne Yes Hayı
domains Arama alanında izin verilecek veya engellenecek etki alanları. Varsayılan olarak, bilgi kaynağı genel İnternet'in tamamında arama yapmak için Bing Arama ile Topraklama'yı kullanır. Etki alanlarını belirttiğinizde, bilgi kaynağı sonuçları belirtilen etki alanlarıyla kısıtlamak için Bing Özel Arama ile Temellendirme'yi kullanır. Her iki durumda da arama sağlayıcısı Bing Özel Arama'dır. Nesne Yes Hayı
allowed_domains Arama alanı için eklenecek alan adları. Her etki alanı için, etki alanını addresswebsite.com biçiminde belirtmeniz gerekir. Etki alanının alt sayfalarını dahil edip etmeyeceğinizi include_subpages öğesini true veya false olarak ayarlayarak da belirtebilirsiniz. Array Yes Hayı
blocked_domains Arama alanından hariç tutulacak alan adları. Her etki alanı için, etki alanını addresswebsite.com biçiminde belirtmeniz gerekir. Etki alanının alt sayfalarını dahil edip etmeyeceğinizi include_subpages öğesini true veya false olarak ayarlayarak da belirtebilirsiniz. Array Yes Hayı

Bilgi bankasına atama

Bilgi kaynağından memnunsanız bir sonraki adıma geçin: Bilgi bankasında bilgi kaynağını belirtin.

Bilgi bankası yapılandırıldıktan sonra, bilgi kaynağını sorgulamak için alma eylemini kullanın.

Bilgi kaynağını silme

Bilgi kaynağını silebilmeniz için önce, buna başvuran bilgi bankalarını silmeniz veya başvuruyu kaldırmak için bilgi bankası tanımını güncelleştirmeniz gerekir. Dizin ve dizin oluşturucu işlem hattı oluşturan bilgi kaynakları için , oluşturulan tüm nesneler de silinir. Ancak, bilgi kaynağı oluşturmak için mevcut bir dizini kullandıysanız dizininiz silinmez.

Kullanımda olan bir bilgi kaynağını silmeye çalışırsanız, eylem başarısız olur ve etkilenen bilgi bankalarının listesini döndürür.

Bilgi kaynağını silmek için:

  1. Arama hizmetinizdeki tüm bilgi bankalarının listesini alın.

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

    Örnek bir yanıt aşağıdaki gibi görünebilir:

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

  2. Bilgi kaynağı başvurularını denetlemek için tek bir bilgi bankası tanımı alın.

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

    Örnek bir yanıt aşağıdaki gibi görünebilir:

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

  3. Bilgi bankasını silin veya birden çok kaynağınız varsa bilgi kaynağını kaldırmak için bilgi bankasını güncelleştirin . Bu örnekte silme işlemi gösterilmektedir.

    # 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. Bilgi kaynağını silin.

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

Önemli

Uyarı

Bu özellik şu anda genel önizlemededir. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmiyor olabileceği gibi özellikleri sınırlandırılmış da olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Web Bilgi Kaynağı , Microsoft Bing'den gerçek zamanlı web verilerinin aracılı bir alma işlem hattında alınmasını sağlar. Bilgi kaynakları bağımsız olarak oluşturulur, bilgi bankasında başvurulur ve bir aracı veya sohbet botu sorgu zamanında alma eylemi çağırdığında temel veri olarak kullanılır.

Bing Özel Arama her zaman Web Bilgi Kaynağı için arama sağlayıcısıdır. Alternatif arama sağlayıcıları veya altyapıları belirtemeseniz de, gibi belirli https://learn.microsoft.com dahil edebilir veya hariç tutabilirsiniz. Etki alanı belirtilmediğinde, Web Bilgi Kaynağı'nın tüm genel İnternet'e sınırsız erişimi vardır.

Web Bilgi Kaynağı en iyi şekilde diğer bilgi kaynaklarıyla birlikte çalışır. Özel içeriğiniz eksiksiz, up-togüncel yanıtlar sağlamadığında veya ticari bir arama motorundan gelen bilgilerle sonuçları tamamlamak istediğinizde Web Bilgi Kaynağı'ndan faydalanabilirsiniz.

Web Bilgi Kaynağı'nı kullanırken aşağıdakileri göz önünde bulundurun:

Kullanım desteği

Azure portalı Microsoft Foundry portalı .NET SDK Python SDK'sı Java SDK'sı JavaScript SDK'sı REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Önkoşullar

Mevcut bilgi kaynaklarını denetleme

Bilgi kaynağı üst düzey, yeniden kullanılabilir bir nesnedir. Mevcut bilgi kaynakları hakkında bilgi edinmek, yeni nesneleri yeniden kullanmak veya adlandırmak için yararlıdır.

Bilgi kaynaklarını ada ve türe göre listelemek için Bilgi Kaynakları - Get (REST API) kullanın.

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

JSON tanımını gözden geçirmek için ada göre tek bir bilgi kaynağı da döndürebilirsiniz.

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

Aşağıdaki JSON, Web Bilgi Kaynağı kaynağı için örnek bir yanıttır.

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

Bilgi kaynağı oluşturma

Web Bilgi Kaynağı kaynağı oluşturmak için Bilgi Kaynakları - Oluştur veya Güncelleştir (REST API) kullanın.

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

Kaynağa özgü özellikler

Web Bilgi Kaynağı kaynağı oluşturmak için aşağıdaki özellikleri geçirebilirsiniz.

İsim Description Türü Düzenlenebilir Gerekli
name Bilgi kaynakları koleksiyonunda benzersiz olması ve Azure AI Search'teki nesneler için adlandırma yönergelerini izlemesi gereken bilgi kaynağının adı. String Yes Yes
kind Söz konusu bilgi kaynağı türü bu örnekte web şeklindedir. String Hayı Yes
description Bilgi kaynağının açıklaması. Belirtilmediğinde Azure AI Search varsayılan bir açıklama uygular. String Yes Hayı
encryptionKey Bilgi kaynağındaki hassas bilgileri şifrelemek için müşteri tarafından yönetilen anahtar . Nesne Yes Hayı
webParameters Web Bilgi Kaynağına özgü parametreler. Şu anda yalnızca domainsbudur. Nesne Yes Hayı
domains Arama alanında izin verilecek veya engellenecek etki alanları. Varsayılan olarak, bilgi kaynağı genel İnternet'in tamamında arama yapmak için Bing Arama ile Topraklama'yı kullanır. Etki alanlarını belirttiğinizde, bilgi kaynağı sonuçları belirtilen etki alanlarıyla kısıtlamak için Bing Özel Arama ile Temellendirme'yi kullanır. Her iki durumda da arama sağlayıcısı Bing Özel Arama'dır. Nesne Yes Hayı
allowedDomains Arama alanı için eklenecek alan adları. Her etki alanı için, etki alanını addresswebsite.com biçiminde belirtmeniz gerekir. Etki alanının alt sayfalarını dahil edip etmeyeceğinizi includeSubpages öğesini true veya false olarak ayarlayarak da belirtebilirsiniz. Array Yes Hayı
blockedDomains Arama alanından hariç tutulacak alan adları. Her etki alanı için, etki alanını addresswebsite.com biçiminde belirtmeniz gerekir. Etki alanının alt sayfalarını dahil edip etmeyeceğinizi includeSubpages öğesini true veya false olarak ayarlayarak da belirtebilirsiniz. Array Yes Hayı

Bilgi bankasına atama

Bilgi kaynağından memnunsanız bir sonraki adıma geçin: Bilgi bankasında bilgi kaynağını belirtin.

Bilgi bankası yapılandırıldıktan sonra, bilgi kaynağını sorgulamak için alma eylemini kullanın.

Bilgi kaynağını silme

Bilgi kaynağını silebilmeniz için önce, buna başvuran bilgi bankalarını silmeniz veya başvuruyu kaldırmak için bilgi bankası tanımını güncelleştirmeniz gerekir. Dizin ve dizin oluşturucu işlem hattı oluşturan bilgi kaynakları için , oluşturulan tüm nesneler de silinir. Ancak, bilgi kaynağı oluşturmak için mevcut bir dizini kullandıysanız dizininiz silinmez.

Kullanımda olan bir bilgi kaynağını silmeye çalışırsanız, eylem başarısız olur ve etkilenen bilgi bankalarının listesini döndürür.

Bilgi kaynağını silmek için:

  1. Arama hizmetinizdeki tüm bilgi bankalarının listesini alın.

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

    Örnek bir yanıt aşağıdaki gibi görünebilir:

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

  2. Bilgi kaynağı başvurularını denetlemek için tek bir bilgi bankası tanımı alın.

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

    Örnek bir yanıt aşağıdaki gibi görünebilir:

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

  3. Bilgi bankasını silin veya birden çok kaynağınız varsa bilgi kaynağını kaldırarak bilgi bankasını güncelleştirin . Bu örnekte silme işlemi gösterilmektedir.

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

  4. Bilgi kaynağını silin.

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

İlgili içerik

  • Last updated on