Web Bilgi Kaynağı kaynağı oluşturma

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

Önemli

(önizleme) olarak işaretlenen özellikler, özellikler veya özellikler hizmet düzeyi sözleşmesi kapsamında değildir, üretim iş yükleri için önerilmez ve genel kullanıma sunulmadan önce değişebilir veya kısıtlanabilir. Azure Yapay Zeka Arama önizleme terimleri, tek başına veya genel kullanıma sunulan bir özelliğin parçası olsun, tüm önizleme işlevleri için geçerlidir.

Önemli

Web Bilgi Kaynağı, Bing Arama ile Temellendirme ve/veya Bing Özel Arama ile Temellendirme kullanan Birinci Taraf Tüketim Hizmeti Grounding with Bing kullanım koşulları ve Microsoft Gizlilik Bildirimi ile yönetilir.
Microsoft Veri Koruma Eki Web Bilgi Kaynağı'na gönderilen veriler için geçerli değildir. Müşteri Web Bilgi Kaynağı'nı kullandığında, Müşteri Verileri Azure uyumluluğu ve Coğrafi sınırın dışına akar. Bu aynı zamanda Web Bilgi Kaynağı kullanımının, veri hakimiyetini ve geçerli olduğu şekilde ekranlı/vatandaşlık tabanlı desteği dahil etmek için tüm yükseltilmiş Kamu Topluluğu Bulut güvenliği ve uyumluluk taahhütlerinden feragat edildiği anlamına gelir.
Web Bilgi Kaynağı kullanımı maliyete neden olur; fiyatlandırma hakkında daha fazla bilgi edinin.
Azure yöneticilerinin Web Bilgi Kaynağı kullanımına erişimi nasıl yönetebileceği hakkında daha fazla bilgi edinin.

Web Bilgi Kaynağı, ajan tabanlı bir alma işlem hattında Microsoft Bing'den gerçek zamanlı web verilerinin alınmasını sağlar. Bilgi kaynakları bağımsız olarak oluşturulur, bilgi bankasında başvurulur ve çalışma zamanında bilgi bankası sorgulandığı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 ve güncel yanıtlar sağlamadığında veya sonuçları ticari bir arama motorundan alınan bilgilerle desteklemek istediğinizde bunu kullanın.

Kullanım desteği

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

Önkoşullar

Web Bilgi Kaynağı'na erişim içeren bir Azure aboneliği. Varsayılan olarak, erişim etkindir. Erişim devre dışıysa yöneticinize başvurun.
Herhangi bir kamuya açık bölgede ajan bazlı alma sağlayan bir Azure Yapay Zeka Arama hizmeti. Web Bilgi Kaynağı özel veya bağımsız bulutlarda desteklenmez.
Bilgi kaynakları oluşturma izni. Kullanıcı hesabınıza atanan Arama Hizmeti Katkıda Bulunanı rolüyle anahtarsız kimlik doğrulamasını yapılandırın (önerilir) veya bir yönetici API anahtarı kullanın.

Gerekli Azure.Search.Documents paketi:
- 2026-08-01-preview özellikleri için en son önizleme paketi: dotnet add package Azure.Search.Documents --prerelease
- 2026-04-01 özellikleri için en son kararlı paket: dotnet add package Azure.Search.Documents
Anahtarsız kimlik doğrulaması için Azure.Identity paket: dotnet add package Azure.Identity

Gerekli azure-search-documents paketi:
- 2026-08-01-preview özellikleri için en son önizleme paketi: pip install --pre azure-search-documents
- 2026-04-01 özellikleri için en son kararlı paket: pip install azure-search-documents
Anahtarsız kimlik doğrulaması için azure-identity paket: pip install azure-identity

Gerekli Arama Hizmeti REST API sürümü:
- Önizleme özellikleri için: 2026-08-01-preview
- Genel kullanıma sunulan özellikler için: 2026-04-01
Anahtarsız kimlik doğrulaması için her HTTP isteğinin üst bilgisine Authorization bir Microsoft Entra ID belirteci ekleyin.

Sınırlamalar ve dikkat edilmesi gerekenler

Web içeriği, arama sonuçlarına eklenmeden önce her zaman bir LLM tarafından özetlenir. Sonuçlar, kelimesi kelimesine web metni değil, özetlenmiş bilgilerdir.
2026-04-01 API sürümü için bilgi bankasının, web içeriğini özetlemek amacıyla LLM'yi sağlamak üzere bir model referansı içermesi gerekir. Alma işlemi her zaman ayıklayıcıdır (alıntılanan özetler). Yanıt sentezi ve yapılandırılabilir mantık eforu bu sürümde kullanılamaz.
2026-08-01-preview API sürümü için bilgi bankası modeli başvurusu, ayıklanan alıntılar yerine tek bir LLM formüllü yanıt üreten yanıt sentezini (önizleme) de etkinleştirir.

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

Başvuru: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})")

Başvuru:SearchIndexClient

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

Başvuru:Bilgi Kaynakları - Liste

JSON tanımını gözden geçirmek için, ismiyle tek bir bilgi kaynağını 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));

Başvuru: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))

Başvuru:SearchIndexClient

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

Başvuru:Bilgi Kaynakları - Get

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ğı oluşturmak için aşağıdaki kodu çalıştırın.

2026-08-01-önizleme
2026-04-01

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

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

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

Başvuru:SearchIndexClient, WebKnowledgeSource

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

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

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

Başvuru:SearchIndexClient, WebKnowledgeSource

2026-08-01-önizleme
2026-04-01

# Create Web Knowledge Source
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import WebKnowledgeSource, WebKnowledgeSourceParameters, WebKnowledgeSourceDomains, WebKnowledgeSourceDomain

index_client = SearchIndexClient(endpoint = "<search-endpoint>", credential = DefaultAzureCredential())

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

Başvuru:SearchIndexClient

# Create Web Knowledge Source
from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import WebKnowledgeSource, WebKnowledgeSourceParameters, WebKnowledgeSourceDomains, WebKnowledgeSourceDomain

index_client = SearchIndexClient(endpoint = "<search-endpoint>", credential = DefaultAzureCredential())

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

Başvuru:SearchIndexClient

2026-08-01-önizleme
2026-04-01

### Create Web Knowledge Source
PUT {{search-endpoint}}/knowledgesources/my-web-ks?api-version=2026-08-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}

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

Başvuru:Bilgi Kaynakları - Oluşturma veya Güncelleştirme

### Create Web Knowledge Source
PUT {{search-endpoint}}/knowledgesources/my-web-ks?api-version=2026-04-01
Content-Type: application/json
Authorization: Bearer {{search-access-token}}

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

Başvuru:Bilgi Kaynakları - Oluşturma veya Güncelleştirme

Bilgi bankasına atama

Bilgi kaynağından memnunsanız bunu bir bilgi bankasına ekleyin.

Bilgi bankasına sorgu yapma

Web Bilgi Kaynağı içeren bir bilgi bankasını sorguladığınızda, alma yanıt activity dizisi web ile ilgili iki kayıt içerebilir:

web İstek için kullanılan çalışma zamanı parametrelerini yakalayan kayıt.
LLM özetleme adımı için belirteçlerin kullanımını kaydeden bir modelWebSummarization kaydı.

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

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:

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

Başvuru:SearchIndexClient

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

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

Başvuru:SearchIndexClient

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

Bilgi bankasını silin veya birden çok bilgi kaynağınız varsa, kaynağı 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.");

Başvuru:SearchIndexClient

Bilgi kaynağını silin.

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

Başvuru:SearchIndexClient

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

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

Başvuru:SearchIndexClient

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

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

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

Başvuru:SearchIndexClient

Ö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"
   }
 }

Bilgi bankasını silin veya birden çok bilgi kaynağınız varsa, kaynağı 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.")

Başvuru:SearchIndexClient

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

Başvuru:SearchIndexClient

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

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

Başvuru:Bilgi Bankaları - Liste

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

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

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

Başvuru:Bilgi Bankaları - Get

Ö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"
   }
 }

Bilgi bankasını silin veya birden çok bilgi kaynağınız varsa, kaynağı kaldırmak için bilgi bankasını güncelleştirin. Bu örnekte silme işlemi gösterilmektedir.
```
### Delete a knowledge base
DELETE {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
Authorization: Bearer {{token}}
```
Başvuru:Bilgi Tabanları - Sil

Bilgi kaynağını silin.

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

Başvuru:Bilgi Kaynakları - Sil

Azure aboneliğinizde Web Bilgi Kaynağı'na erişimi yönetme
Azure Yapay Zeka Arama'te Agentic retrieval
Bilgi kaynağı nedir?
Bilgi bankası oluşturma
Bilgi bankasını sorgulama

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-09-17

Web Bilgi Kaynağı kaynağı oluşturma

Kullanım desteği

Önkoşullar

Sınırlamalar ve dikkat edilmesi gerekenler

Mevcut bilgi kaynaklarını denetleme

Bilgi kaynağı oluşturma

Bilgi bankasına atama

Bilgi bankasına sorgu yapma

Bilgi kaynağını silme

İlgili içerik

Geri Bildirim

Ek kaynaklar