Membuat sumber daya Sumber Pengetahuan Web

Catatan

Fitur pengambilan berbasis agen ini tersedia secara umum di REST API 2026-04-01 melalui akses terprogram. Portal Azure dan portal Microsoft Foundry terus menyediakan akses khusus pratinjau ke semua fitur pengambilan agenik. Untuk panduan migrasi, lihat Memigrasikan kode pengambilan agenik ke versi terbaru.

Jika Anda memilih untuk menggunakan PRATINJAU REST API, Anda dapat mengakses kemampuan yang belum tersedia secara umum untuk fitur ini. Fitur pratinjau disediakan tanpa perjanjian tingkat layanan dan tidak disarankan untuk beban kerja produksi. Untuk informasi lebih lanjut, lihat Supplemental Terms of Use for Microsoft Azure Previews.

Penting

Fitur dan fungsionalitas ini adalah bagian dari REST API pratinjau 2026-05-01. Pratinjau 2026-05-01 dilisensikan kepada Anda sebagai bagian dari langganan Azure Anda dan tunduk pada persyaratan yang berlaku untuk "Pratinjau" dalam Ketentuan Produk Microsoft, Adendum Perlindungan Data Produk dan Layanan Microsoft ("DPA"), dan Ketentuan Penggunaan Supplemental untuk Pratinjau Microsoft Azure.

Versi pratinjau 2026-05-01 mendukung koneksi ke layanan Microsoft dan layanan pihak ketiga. Penggunaan layanan ini tunduk pada persyaratan masing-masing dan dapat mengakibatkan pemrosesan data atau penyimpanan di luar batas kepatuhan Azure, serta data yang mengalir ke batas kepatuhan Azure.

Anda bertanggung jawab untuk mengelola apakah data Anda akan mengalir di luar batas kepatuhan dan geografis organisasi Anda dan implikasi terkait, dan bahwa izin, batas, dan persetujuan yang sesuai disediakan.

Anda bertanggung jawab untuk meninjau dan menguji aplikasi yang Anda buat dengan cermat dalam konteks kasus penggunaan spesifik Anda dan membuat semua keputusan dan penyesuaian yang sesuai. Ini termasuk menerapkan mitigasi AI Anda sendiri yang bertanggung jawab, seperti metaprompts, filter konten, atau sistem keamanan lainnya, dan memastikan aplikasi Anda memenuhi standar kualitas, keandalan, keamanan, dan kepercayaan yang sesuai. Untuk informasi selengkapnya, lihat Catatan Transparansi Pencarian Azure AI.

Penting

Sumber Pengetahuan Web, yang menggunakan Grounding dengan Bing Search dan/atau Grounding dengan Bing Custom Search, adalah Layanan Konsumsi Pihak Pertama yang diatur oleh ketentuan penggunaan Grounding dengan Bing dan Pernyataan Privasi Microsoft.
Adendum Perlindungan Data Microsoft tidak berlaku untuk data yang dikirim ke Sumber Pengetahuan Web. Ketika Pelanggan menggunakan Sumber Pengetahuan Web, Data Pelanggan mengalir di luar kepatuhan Azure dan batas geografis. Ini juga berarti penggunaan Sumber Pengetahuan Web melepaskan semua komitmen keamanan dan kepatuhan dari Cloud Komunitas Pemerintah yang ditingkatkan, termasuk kedaulatan data serta dukungan berdasarkan penyaringan/kewarganegaraan, sebagaimana berlaku.
Penggunaan Sumber Pengetahuan Web dikenakan biaya; pelajari selengkapnya tentang harga.
Pelajari selengkapnya tentang bagaimana admin Azure dapat kelola akses ke penggunaan Sumber Pengetahuan Web.

Web Knowledge Source memungkinkan pengambilan data web secara real-time dari Microsoft Bing dalam kerangka kerja pengambilan data berbasis agen. Sumber pengetahuan dibuat secara independen, direferensikan dalam pangkalan pengetahuan, dan digunakan sebagai data dasar ketika pangkalan pengetahuan dikueri saat runtime.

Pencarian Kustom Bing selalu menjadi penyedia pencarian untuk Sumber Pengetahuan Web. Meskipun Anda tidak dapat menentukan penyedia atau mesin pencarian alternatif, Anda dapat menyertakan atau mengecualikan domain tertentu, seperti https://learn.microsoft.com. Ketika tidak ada domain yang ditentukan, Sumber Pengetahuan Web memiliki akses tak terbatas ke seluruh internet publik.

Sumber Pengetahuan Web berfungsi paling baik bersama sumber pengetahuan lainnya. Gunakan ini ketika konten milik Anda tidak memberikan jawaban yang lengkap dan terkini, atau ketika Anda ingin melengkapi hasil dengan informasi dari mesin pencari komersial.

Dukungan penggunaan

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

Prasyarat

Langganan Azure dengan akss ke Sumber Pengetahuan Web. Secara default, akses diaktifkan. Hubungi admin Anda jika akses dinonaktifkan.
Layanan Pencarian Azure AI di wilayah publik mana pun yang menyediakan pengambilan berbasis agen. Sumber Pengetahuan Web tidak didukung di cloud privat atau berdaulat.
Izin untuk membuat sumber pengetahuan. Konfigurasikan autentikasi tanpa kunci dengan peran Kontributor Layanan Pencarian yang ditetapkan ke akun pengguna Anda (disarankan) atau gunakan kunci API.

Paket Azure.Search.Documents yang diperlukan:
- Untuk fitur pratinjau 2026-05-01, paket pratinjau terbaru: dotnet add package Azure.Search.Documents --prerelease
- Untuk fitur 2026-04-01, paket stabil terbaru: dotnet add package Azure.Search.Documents

Paket azure-search-documents yang diperlukan:
- Untuk fitur pratinjau 2026-05-01, paket pratinjau terbaru: pip install --pre azure-search-documents
- Untuk fitur 2026-04-01, paket stabil terbaru: pip install azure-search-documents

Versi REST API yang diperlukan:
- Untuk fitur pratinjau: Search Service 2026-05-01-preview
- Untuk fitur yang tersedia secara umum: Layanan Pencarian 2026-04-01

Batasan dan pertimbangan

Konten web selalu dirangkum oleh LLM sebelum disertakan dalam hasil pencarian. Hasilnya dikutip ringkasan, bukan teks web verbatim.
Untuk versi API 2026-04-01, pangkalan pengetahuan harus menyertakan referensi model untuk menyediakan LLM untuk ringkasan konten web. Pengambilan data selalu bersifat ekstraktif (menyajikan ringkasan yang dikutip). Sintesis jawaban dan upaya penalaran yang dapat dikonfigurasi tidak tersedia dalam versi ini.
Untuk versi API 2026-05-01-preview, referensi model basis pengetahuan juga memungkinkan sintesis jawaban, yang menghasilkan satu respons yang dirumuskan oleh LLM, bukan kutipan yang diekstrak.

Periksa sumber pengetahuan yang ada

Sumber pengetahuan adalah objek tingkat atas yang dapat digunakan kembali. Mengetahui tentang sumber pengetahuan yang ada sangat membantu untuk menggunakan kembali atau memberi nama objek baru.

Jalankan kode berikut untuk mencantumkan sumber pengetahuan menurut nama dan jenis.

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

Referensi: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})")

Referensi:SearchIndexClient

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

Referensi:Sumber Pengetahuan - Daftar

Anda juga dapat mengembalikan satu sumber pengetahuan berdasarkan nama untuk meninjau definisi JSON-nya.

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

Referensi: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))

Referensi:SearchIndexClient

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

Referensi:Sumber Pengetahuan - Dapatkan

JSON berikut adalah contoh respons untuk sumber daya Sumber Pengetahuan Web.

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

Membuat sumber pengetahuan

Jalankan kode berikut untuk membuat sumber pengetahuan web.

2026-05-01-preview
2026-04-01

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

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

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

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

Referensi:SearchIndexClient, WebKnowledgeSource

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

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

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

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

Referensi:SearchIndexClient, WebKnowledgeSource

2026-05-01-preview
2026-04-01

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

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

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

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

Referensi:SearchIndexClient

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

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

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

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

Referensi:SearchIndexClient

2026-05-01-preview
2026-04-01

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

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

Referensi:Sumber Pengetahuan - Buat atau Perbarui

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

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

Referensi:Sumber Pengetahuan - Buat atau Perbarui

Properti khusus sumber

Properti berikut berlaku untuk sumber pengetahuan web.

Nama	Deskripsi	Jenis	Dapat Diedit	Diperlukan
`Name`	Nama sumber pengetahuan, yang harus unik dalam koleksi sumber pengetahuan dan mengikuti panduan naming untuk objek dalam Pencarian Azure AI.	String	Tidak	Ya
`Description`	Deskripsi sumber pengetahuan. Saat tidak ditentukan, Pencarian Azure AI menerapkan deskripsi default.	String	Ya	Tidak
`EncryptionKey`	Kunci yang dikelola pelanggan untuk mengenkripsi informasi sensitif di sumber pengetahuan.	Objek	Ya	Tidak
`WebParameters`	Parameter khusus untuk Sumber Pengetahuan Web. Saat ini, ini hanya `Domains`.	Objek	Ya	Tidak
`Domains`	Domain yang akan diizinkan atau diblokir dari ruang pencarian. Secara default, sumber pengetahuan menggunakan Grounding dengan Bing Search untuk mencari seluruh internet publik. Saat Anda menentukan domain, sumber pengetahuan menggunakan Grounding dengan Pencarian Kustom Bing untuk membatasi hasil ke domain yang ditentukan. Dalam kedua kasus, Pencarian Kustom Bing adalah penyedia pencarian.	Objek	Ya	Tidak
`AllowedDomains`	Domain yang akan disertakan dalam ruang pencarian. Untuk setiap domain, Anda harus menentukannya `address` dalam format `website.com`. Anda juga dapat menentukan apakah akan menyertakan sub-halaman domain dengan mengatur `IncludeSubpages` ke `true` atau `false`.	Array	Ya	Tidak
`BlockedDomains`	Domain yang akan dikecualikan dari ruang pencarian. Untuk setiap domain, Anda harus menentukannya `address` dalam format `website.com`. Anda juga dapat menentukan apakah akan menyertakan sub-halaman domain dengan mengatur `IncludeSubpages` ke `true` atau `false`.	Array	Ya	Tidak

Nama	Deskripsi	Jenis	Dapat Diedit	Diperlukan
`name`	Nama sumber pengetahuan, yang harus unik dalam koleksi sumber pengetahuan dan mengikuti panduan naming untuk objek dalam Pencarian Azure AI.	String	Tidak	Ya
`description`	Deskripsi sumber pengetahuan. Saat tidak ditentukan, Pencarian Azure AI menerapkan deskripsi default.	String	Ya	Tidak
`encryption_key`	Kunci yang dikelola pelanggan untuk mengenkripsi informasi sensitif di sumber pengetahuan.	Objek	Ya	Tidak
`web_parameters`	Parameter khusus untuk Sumber Pengetahuan Web. Saat ini, ini hanya `domains`.	Objek	Ya	Tidak
`domains`	Domain yang akan diizinkan atau diblokir dari ruang pencarian. Secara default, sumber pengetahuan menggunakan Grounding dengan Bing Search untuk mencari seluruh internet publik. Saat Anda menentukan domain, sumber pengetahuan menggunakan Grounding dengan Pencarian Kustom Bing untuk membatasi hasil ke domain yang ditentukan. Dalam kedua kasus, Pencarian Kustom Bing adalah penyedia pencarian.	Objek	Ya	Tidak
`allowed_domains`	Domain yang akan disertakan dalam ruang pencarian. Untuk setiap domain, Anda harus menentukannya `address` dalam format `website.com`. Anda juga dapat menentukan apakah akan menyertakan sub-halaman domain dengan mengatur `include_subpages` ke `true` atau `false`.	Array	Ya	Tidak
`blocked_domains`	Domain yang akan dikecualikan dari ruang pencarian. Untuk setiap domain, Anda harus menentukannya `address` dalam format `website.com`. Anda juga dapat menentukan apakah akan menyertakan sub-halaman domain dengan mengatur `include_subpages` ke `true` atau `false`.	Array	Ya	Tidak

Nama	Deskripsi	Jenis	Dapat Diedit	Diperlukan
`name`	Nama sumber pengetahuan, yang harus unik dalam koleksi sumber pengetahuan dan mengikuti panduan naming untuk objek dalam Pencarian Azure AI.	String	Tidak	Ya
`kind`	Jenis sumber pengetahuan, yang pada `web` kasus ini.	String	Tidak	Ya
`description`	Deskripsi sumber pengetahuan. Saat tidak ditentukan, Pencarian Azure AI menerapkan deskripsi default.	String	Ya	Tidak
`encryptionKey`	Kunci yang dikelola pelanggan untuk mengenkripsi informasi sensitif di sumber pengetahuan.	Objek	Ya	Tidak
`webParameters`	Parameter khusus untuk Sumber Pengetahuan Web. Saat ini, ini hanya `domains`.	Objek	Ya	Tidak
`domains`	Domain yang akan diizinkan atau diblokir dari ruang pencarian. Secara default, sumber pengetahuan menggunakan Grounding dengan Bing Search untuk mencari seluruh internet publik. Saat Anda menentukan domain, sumber pengetahuan menggunakan Grounding dengan Pencarian Kustom Bing untuk membatasi hasil ke domain yang ditentukan. Dalam kedua kasus, Pencarian Kustom Bing adalah penyedia pencarian.	Objek	Ya	Tidak
`allowedDomains`	Domain yang akan disertakan dalam ruang pencarian. Untuk setiap domain, Anda harus menentukannya `address` dalam format `website.com`. Anda juga dapat menentukan apakah akan menyertakan sub-halaman domain dengan mengatur `includeSubpages` ke `true` atau `false`.	Array	Ya	Tidak
`blockedDomains`	Domain yang akan dikecualikan dari ruang pencarian. Untuk setiap domain, Anda harus menentukannya `address` dalam format `website.com`. Anda juga dapat menentukan apakah akan menyertakan sub-halaman domain dengan mengatur `includeSubpages` ke `true` atau `false`.	Array	Ya	Tidak

Tetapkan ke basis pengetahuan

Jika Anda puas dengan sumber pengetahuan, tambahkan ke pangkalan pengetahuan.

Meminta pangkalan pengetahuan

Saat Anda mengkueri pangkalan pengetahuan yang menyertakan Sumber Pengetahuan Web, array respons activity pengambilan dapat berisi dua rekaman terkait web:

Rekaman web yang mencatat parameter runtime yang digunakan untuk permintaan.
Rekaman modelWebSummarization yang menangkap penggunaan token dalam langkah peringkasan LLM.

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

Menghapus sumber pengetahuan

Sebelum dapat menghapus sumber pengetahuan, Anda harus menghapus pangkalan pengetahuan apa pun yang mereferensikannya atau memperbarui definisi pangkalan pengetahuan untuk menghapus referensi. Untuk sumber pengetahuan yang menghasilkan indeks dan alur pengindeks, semua objek yang dihasilkan juga dihapus. Namun, jika Anda menggunakan indeks yang ada untuk membuat sumber pengetahuan, indeks Anda tidak dihapus.

Jika Anda mencoba menghapus sumber pengetahuan yang sedang digunakan, tindakan gagal dan mengembalikan daftar pangkalan pengetahuan yang terpengaruh.

Untuk menghapus sumber pengetahuan:

Dapatkan daftar semua pangkalan pengetahuan di layanan pencarian Anda.

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

Referensi:SearchIndexClient

Contoh respons mungkin terlihat seperti berikut ini:

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

Dapatkan definisi pangkalan pengetahuan individual untuk memeriksa referensi sumber pengetahuan.

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

Referensi:SearchIndexClient

Contoh respons mungkin terlihat seperti berikut ini:

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

Hapus pangkalan pengetahuan atau, jika Anda memiliki beberapa sumber pengetahuan, perbarui pangkalan pengetahuan untuk menghapus sumbernya. Contoh ini menunjukkan penghapusan.

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

Referensi:SearchIndexClient

Hapus sumber pengetahuan.

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

Referensi:SearchIndexClient

Dapatkan daftar semua pangkalan pengetahuan di layanan pencarian Anda.

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

Referensi:SearchIndexClient

Contoh respons mungkin terlihat seperti berikut ini:

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

Dapatkan definisi pangkalan pengetahuan individual untuk memeriksa referensi sumber pengetahuan.

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

Referensi:SearchIndexClient

Contoh respons mungkin terlihat seperti berikut ini:

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

Hapus pangkalan pengetahuan atau, jika Anda memiliki beberapa sumber pengetahuan, perbarui pangkalan pengetahuan untuk menghapus sumbernya. Contoh ini menunjukkan penghapusan.

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

Referensi:SearchIndexClient

Hapus sumber pengetahuan.

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

Referensi:SearchIndexClient

Dapatkan daftar semua pangkalan pengetahuan di layanan pencarian Anda.

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

Referensi:Pangkalan Pengetahuan - Daftar

Contoh respons mungkin terlihat seperti berikut ini:

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

Dapatkan definisi pangkalan pengetahuan individual untuk memeriksa referensi sumber pengetahuan.

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

Referensi:Pangkalan Pengetahuan - Dapatkan

Contoh respons mungkin terlihat seperti berikut ini:

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

Hapus pangkalan pengetahuan atau, jika Anda memiliki beberapa sumber pengetahuan, perbarui pangkalan pengetahuan untuk menghapus sumbernya. Contoh ini menunjukkan penghapusan.
```
### Delete a knowledge base
DELETE {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
api-key: {{api-key}}
```
Referensi:Pangkalan Pengetahuan - Hapus

Hapus sumber pengetahuan.

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

Referensi:Sumber Pengetahuan - Hapus

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-06-03

Membuat sumber daya Sumber Pengetahuan Web

Dukungan penggunaan

Prasyarat

Batasan dan pertimbangan

Periksa sumber pengetahuan yang ada

Membuat sumber pengetahuan

Properti khusus sumber

Tetapkan ke basis pengetahuan

Meminta pangkalan pengetahuan

Menghapus sumber pengetahuan

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: