Konfigurowanie narzędzi bazy wiedzy

Important

Funkcje narzędzi bazy wiedzy są dostępne w publicznej wersji zapoznawczej i podlegają dodatkowym warunkom użytkowania dla Microsoft Azure wersji zapoznawczych. Aby zapoznać się z terminami wersji zapoznawczej specyficznymi dla tej funkcji, zobacz Funkcje wersji zapoznawczej.

Narzędzia baz wiedzy pozwalają jednej bazie wiedzy obsługiwać wiele przepływów pracy wyszukiwania informacji dostosowanych do konkretnych zadań na potrzeby aplikacji i agentów. Każde narzędzie wybiera źródła wiedzy i ustawia zachowanie pobierania wielokrotnego użytku, takie jak nakład pracy rozumowania i limity danych wyjściowych. Klienci mogą wywoływać narzędzie za pośrednictwem interfejsu REST lub odkrywać je i wywoływać przez endpoint MCP.

Użyj narzędzi bazy wiedzy, gdy klienci potrzebują spójnego punktu wejścia pobierania bez ponownego kompilowania tych samych źródeł wiedzy i wartości domyślnych dla każdego żądania. W tym artykule utworzysz narzędzie, przetestujesz sposób, w jaki jego zapisane ustawienia współdziałają z kontrolkami czasu żądania, wywołują je za pośrednictwem umowy MCP i aktualizują lub usuwają.

Wsparcie użytkowania

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

Prerequisites

  • Uprawnienie do tworzenia i przeszukiwania przykładowych zasobów. Skonfiguruj uwierzytelnianie bez klucza przy użyciu ról Współautor usługi wyszukiwania, Współautor danych indeksu wyszukiwania i Czytelnik danych indeksu wyszukiwania przypisanych do konta użytkownika.
  • Projekt konsoli .NET 8 lub nowszy w najnowszej wersji zapoznawczej Azure.Search.Documents. Zobacz bibliotekę klienta .NET.

Tworzenie przykładowej bazy wiedzy

Utwórz indeks, źródło wiedzy i bazę wiedzy.

Zaloguj się zgodnie z opisem w artykule Connect to Foundry IQ (Wyszukiwanie AI platformy Azure). Uruchom fragmenty kodu zestawu SDK w kolejności.

from azure.identity import DefaultAzureCredential
from azure.search.documents import SearchClient
from azure.search.documents.indexes import SearchIndexClient

search_endpoint = "<search-endpoint>"
index_name = "kb-tools-policy-index"
knowledge_source_name = "kb-tools-policy-source"
knowledge_base_name = "kb-tools-policy-kb"
credential = DefaultAzureCredential()
index_client = SearchIndexClient(search_endpoint, credential)
search_client = SearchClient(search_endpoint, index_name, credential)

Reference:DefaultAzureCredential, SearchClient, SearchIndexClient.

Utwórz indeks i przekaż trzy syntetyczne polisy.

from azure.search.documents.indexes.models import (
    SearchFieldDataType,
    SearchIndex,
    SearchableField,
    SimpleField,
)

index = index_client.create_index(SearchIndex(
    name=index_name,
    fields=[
        SimpleField(
            name="id", type=SearchFieldDataType.STRING, key=True,
        ),
        SearchableField(name="title"),
        SearchableField(name="content"),
        SimpleField(
            name="jurisdiction",
            type=SearchFieldDataType.STRING,
            filterable=True,
        ),
    ],
))

documents = [
    {
        "id": "ca-leave",
        "title": "Canadian parental leave",
        "jurisdiction": "CA",
        "content": (
            "Canadian employees receive four weeks of paid parental leave."
        ),
    },
    {
        "id": "ca-request",
        "title": "Canadian leave requests",
        "jurisdiction": "CA",
        "content": (
            "Canadian employees submit parental leave requests through "
            "the HR portal at least 30 days before leave."
        ),
    },
    {
        "id": "us-leave",
        "title": "US parental leave",
        "jurisdiction": "US",
        "content": "US employees receive six weeks of paid parental leave.",
    },
]
search_client.upload_documents(documents=documents)

Dokumentacja:SearchIndexClient, SearchIndex, SearchClient.upload_documents.

Zaloguj się zgodnie z opisem w temacie Connect to Foundry IQ. Uruchom fragmenty kodu zestawu SDK w kolejności.

using Azure.Identity;
using Azure.Search.Documents;
using Azure.Search.Documents.Indexes;

string searchEndpoint = "<search-endpoint>";
string indexName = "kb-tools-policy-index";
string knowledgeSourceName = "kb-tools-policy-source";
string knowledgeBaseName = "kb-tools-policy-kb";
var credential = new DefaultAzureCredential();
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var searchClient = new SearchClient(
    new Uri(searchEndpoint), indexName, credential);

Reference:DefaultAzureCredential, SearchClient, SearchIndexClient.

Utwórz indeks i przekaż trzy syntetyczne polisy.

using Azure.Search.Documents.Indexes.Models;
using Azure.Search.Documents.Models;

var index = (await indexClient.CreateIndexAsync(
    new SearchIndex(indexName,
    [
        new SimpleField("id", SearchFieldDataType.String)
        {
            IsKey = true,
        },
        new SearchableField("title"),
        new SearchableField("content"),
        new SimpleField("jurisdiction", SearchFieldDataType.String)
        {
            IsFilterable = true,
        },
    ])).Value;

var documents = new SearchDocument[]
{
    new()
    {
        ["id"] = "ca-leave",
        ["title"] = "Canadian parental leave",
        ["jurisdiction"] = "CA",
        ["content"] =
            "Canadian employees receive four weeks of paid parental leave.",
    },
    new()
    {
        ["id"] = "ca-request",
        ["title"] = "Canadian leave requests",
        ["jurisdiction"] = "CA",
        ["content"] =
            "Canadian employees submit parental leave requests through " +
            "the HR portal at least 30 days before leave.",
    },
    new()
    {
        ["id"] = "us-leave",
        ["title"] = "US parental leave",
        ["jurisdiction"] = "US",
        ["content"] =
            "US employees receive six weeks of paid parental leave.",
    },
};
await searchClient.UploadDocumentsAsync(documents);

Odwołanie:SearchIndexClient, SearchIndex, SearchClient.UploadDocumentsAsync.

  1. Utwórz źródło wiedzy.

    from azure.search.documents.indexes.models import (
        SearchIndexFieldReference,
        SearchIndexKnowledgeSource,
        SearchIndexKnowledgeSourceParameters,
    )
    
    source = index_client.create_knowledge_source(
        SearchIndexKnowledgeSource(
            name=knowledge_source_name,
            search_index_parameters=SearchIndexKnowledgeSourceParameters(
                search_index_name=index_name,
                source_data_fields=[
                    SearchIndexFieldReference(name="id"),
                    SearchIndexFieldReference(name="title"),
                    SearchIndexFieldReference(name="content"),
                    SearchIndexFieldReference(name="jurisdiction"),
                ],
            ),
        ),
    )
    

    Odwołanie:SearchIndexClient.

  2. Utwórz bazę wiedzy bez modelu z minimalnym rozumowaniem i wyjściem ekstrakcyjnym.

    from azure.search.documents.indexes.models import (
        KnowledgeBase,
        KnowledgeSourceReference,
    )
    from azure.search.documents.knowledgebases.models import (
        KnowledgeRetrievalMinimalReasoningEffort,
        KnowledgeRetrievalOutputMode,
    )
    
    knowledge_base = index_client.create_knowledge_base(KnowledgeBase(
        name=knowledge_base_name,
        knowledge_sources=[KnowledgeSourceReference(name=source.name)],
        retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(),
        output_mode=KnowledgeRetrievalOutputMode.EXTRACTIVE_DATA,
    ))
    

    Odwołanie:KnowledgeBase, SearchIndexClient.

  1. Utwórz źródło wiedzy.

    using Azure.Search.Documents.Indexes.Models;
    
    var source = (await indexClient.CreateKnowledgeSourceAsync(
        new SearchIndexKnowledgeSource(knowledgeSourceName,
            new SearchIndexKnowledgeSourceParameters(indexName)
            {
                SourceDataFields =
                {
                    new SearchIndexFieldReference("id"),
                    new SearchIndexFieldReference("title"),
                    new SearchIndexFieldReference("content"),
                    new SearchIndexFieldReference("jurisdiction"),
                },
            }))).Value;
    

    Odwołanie:SearchIndexClient.

  2. Utwórz bazę wiedzy bez modelu z minimalnym rozumowaniem i wyjściem ekstrakcyjnym.

    using Azure.Search.Documents.Indexes.Models;
    using Azure.Search.Documents.KnowledgeBases.Models;
    
    var knowledgeBase = (await indexClient.CreateKnowledgeBaseAsync(
        new KnowledgeBase(knowledgeBaseName,
            [new KnowledgeSourceReference(source.Name)])
        {
            RetrievalReasoningEffort =
                new KnowledgeRetrievalMinimalReasoningEffort(),
            OutputMode = KnowledgeRetrievalOutputMode.ExtractiveData,
        })).Value;
    

    Odwołanie:KnowledgeBase, SearchIndexClient.

  1. Ustaw punkt końcowy usługi Foundry IQ i token dostępu. Aby uzyskać token dostępu, zobacz Łączenie z usługą Foundry IQ.

    @searchEndpoint = <search-endpoint>
    @searchAccessToken = <search-access-token>
    @indexName = kb-tools-policy-index
    @knowledgeSourceName = kb-tools-policy-source
    @knowledgeBaseName = kb-tools-policy-kb
    
  2. Utwórz indeks z tekstem zasad z możliwością przeszukiwania i filtrowalnym polem jurysdykcji.

    PUT {{searchEndpoint}}/indexes/{{indexName}}?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "name": "{{indexName}}",
      "fields": [
        { "name": "id", "type": "Edm.String", "key": true },
        { "name": "title", "type": "Edm.String", "searchable": true },
        { "name": "content", "type": "Edm.String", "searchable": true },
        { "name": "jurisdiction", "type": "Edm.String", "filterable": true }
      ]
    }
    

    Odwołanie:Indeksy — tworzenie lub aktualizowanie.

  3. Prześlij trzy syntetyczne polisy.

    POST {{searchEndpoint}}/indexes/{{indexName}}/docs/index?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "value": [
        {
          "@search.action": "upload", "id": "ca-leave",
          "title": "Canadian parental leave", "jurisdiction": "CA",
          "content": "Canadian employees receive four weeks of paid parental leave."
        },
        {
          "@search.action": "upload", "id": "ca-request",
          "title": "Canadian leave requests", "jurisdiction": "CA",
          "content": "Canadian employees submit parental leave requests through the HR portal at least 30 days before leave."
        },
        {
          "@search.action": "upload", "id": "us-leave",
          "title": "US parental leave", "jurisdiction": "US",
          "content": "US employees receive six weeks of paid parental leave."
        }
      ]
    }
    

    Informacje:Dokumenty — indeks.

  4. Utwórz źródło wiedzy.

    PUT {{searchEndpoint}}/knowledgesources/{{knowledgeSourceName}}?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "name": "{{knowledgeSourceName}}",
      "kind": "searchIndex",
      "searchIndexParameters": {
        "searchIndexName": "{{indexName}}",
        "sourceDataFields": [
          { "name": "id" }, { "name": "title" },
          { "name": "content" }, { "name": "jurisdiction" }
        ]
      }
    }
    

    Dokumentacja:Źródła wiedzy — tworzenie lub aktualizowanie.

  5. Utwórz bazę wiedzy z minimalnym wnioskowaniem i wyjściem ekstrakcyjnym.

    PUT {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "name": "{{knowledgeBaseName}}",
      "knowledgeSources": [{ "name": "{{knowledgeSourceName}}" }],
      "retrievalReasoningEffort": { "kind": "minimal" },
      "outputMode": "extractiveData"
    }
    

    Odwołanie:Bazy wiedzy — tworzenie lub aktualizowanie.

Dodaj niestandardowe narzędzie do bazy wiedzy

Narzędzie odwołuje się do źródeł wiedzy zdefiniowanych już w bazie wiedzy. Baza wiedzy przechowuje nazwę narzędzia, opis i ustawienia domyślne.

  1. Skonfiguruj odniesienie do kanadyjskiego źródła wiedzy.

    from azure.search.documents.indexes.models import (
        KnowledgeBaseToolKnowledgeSourceReference,
    )
    
    tool_source = KnowledgeBaseToolKnowledgeSourceReference(
        name=source.name,
        filter_add_on="jurisdiction eq 'CA'",
        reranker_threshold=0,
        max_output_documents=50,
        fail_on_error=True,
    )
    

    Odwołanie:Modele indeksowania.

  2. Dodaj narzędzie do bazy wiedzy.

    from azure.search.documents.indexes.models import (
        KnowledgeBaseRetrieveDefaults,
        KnowledgeBaseTool,
    )
    from azure.search.documents.knowledgebases.models import (
        KnowledgeRetrievalMinimalReasoningEffort,
    )
    
    tool = KnowledgeBaseTool(
        name="canada-hr-search",
        description="Find Canadian employee leave and benefits policies.",
        knowledge_sources=[tool_source],
        retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(),
        retrieve_defaults=KnowledgeBaseRetrieveDefaults(
            max_runtime_in_seconds=30,
            max_output_size_in_tokens=5000,
            max_output_documents=12,
        ),
    )
    knowledge_base.tools = [tool]
    knowledge_base = index_client.create_or_update_knowledge_base(
        knowledge_base,
    )
    

    Odwołanie:SearchIndexClient.

  1. Skonfiguruj odniesienie do kanadyjskiego źródła wiedzy.

    using Azure.Search.Documents.Indexes.Models;
    
    var toolSource = new KnowledgeBaseToolKnowledgeSourceReference(source.Name)
    {
        FilterAddOn = "jurisdiction eq 'CA'",
        RerankerThreshold = 0,
        MaxOutputDocuments = 50,
        FailOnError = true,
    };
    

    Odwołanie:Modele indeksowania.

  2. Dodaj narzędzie do bazy wiedzy.

    using Azure.Search.Documents.Indexes.Models;
    using Azure.Search.Documents.KnowledgeBases.Models;
    
    var tool = new KnowledgeBaseTool(
        "canada-hr-search",
        "Find Canadian employee leave and benefits policies.",
        [toolSource])
    {
        RetrievalReasoningEffort =
            new KnowledgeRetrievalMinimalReasoningEffort(),
        RetrieveDefaults = new KnowledgeBaseRetrieveDefaults
        {
            MaxRuntimeInSeconds = 30,
            MaxOutputSizeInTokens = 5000,
            MaxOutputDocuments = 12,
        },
    };
    knowledgeBase.Tools.Add(tool);
    knowledgeBase = (await indexClient.CreateOrUpdateKnowledgeBaseAsync(
        knowledgeBase)).Value;
    

    Odwołanie:SearchIndexClient.

Wyślij pełną definicję bazy wiedzy za pomocą jednego narzędzia.

PUT {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{searchAccessToken}}

{
  "name": "{{knowledgeBaseName}}",
  "knowledgeSources": [{ "name": "{{knowledgeSourceName}}" }],
  "retrievalReasoningEffort": { "kind": "minimal" },
  "outputMode": "extractiveData",
  "tools": [{
    "name": "canada-hr-search",
    "description": "Find Canadian employee leave and benefits policies.",
    "knowledgeSources": [{
      "name": "{{knowledgeSourceName}}",
      "filterAddOn": "jurisdiction eq 'CA'",
      "rerankerThreshold": 0,
      "maxOutputDocuments": 50,
      "failOnError": true
    }],
    "retrievalReasoningEffort": { "kind": "minimal" },
    "retrieveDefaults": {
      "maxRuntimeInSeconds": 30,
      "maxOutputSizeInTokens": 5000,
      "maxOutputDocuments": 12
    }
  }]
}

Odwołanie:Bazy wiedzy — tworzenie lub aktualizowanie.

Filtr urzędu certyfikacji należy do odwołania do źródła wiedzy narzędzia, a nie definicji źródła wiedzy. Wybranie narzędzia ogranicza pobieranie do skonfigurowanych dla niego źródeł wiedzy przed rozpoczęciem pobierania. W tym przykładzie z jednym źródłem filtr ogranicza pobieranie do kanadyjskich dokumentów.

Wywołaj narzędzie

Wybierz narzędzie dla istniejącej operacji pobierania. Użyj jednej intencji semantycznej zawierającej pełne pytanie.

from azure.search.documents.knowledgebases import KnowledgeBaseRetrievalClient
from azure.search.documents.knowledgebases.models import (
    KnowledgeBaseRetrievalRequest,
    KnowledgeRetrievalMinimalReasoningEffort,
    KnowledgeRetrievalOutputMode,
    KnowledgeRetrievalSemanticIntent,
)

question = "What parental leave do Canadian employees receive and how do they request it?"
retrieval_client = KnowledgeBaseRetrievalClient(
    search_endpoint, credential, knowledge_base_name=knowledge_base.name,
)
request = KnowledgeBaseRetrievalRequest(
    tool_name="canada-hr-search",
    intents=[KnowledgeRetrievalSemanticIntent(search=question)],
    retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(),
    output_mode=KnowledgeRetrievalOutputMode.EXTRACTIVE_DATA,
    include_activity=True,
)
response = retrieval_client.retrieve(request)

Reference:KnowledgeBaseRetrievalClient.

using Azure.Search.Documents.KnowledgeBases;
using Azure.Search.Documents.KnowledgeBases.Models;

string question = "What parental leave do Canadian employees receive and how do they request it?";
var retrievalClient = new KnowledgeBaseRetrievalClient(
    new Uri(searchEndpoint), knowledgeBase.Name, credential);
var request = new KnowledgeBaseRetrievalRequest
{
    ToolName = "canada-hr-search",
    Intents = { new KnowledgeRetrievalSemanticIntent(question) },
    RetrievalReasoningEffort =
        new KnowledgeRetrievalMinimalReasoningEffort(),
    OutputMode = KnowledgeRetrievalOutputMode.ExtractiveData,
    IncludeActivity = true,
};
var response = await retrievalClient.RetrieveAsync(request);

Reference:KnowledgeBaseRetrievalClient.

Wyślij jedną semantyczną intencję zawierającą pełne pytanie.

POST {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}/retrieve?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{searchAccessToken}}

{
  "toolName": "canada-hr-search",
  "intents": [{
    "type": "semantic",
    "search": "What parental leave do Canadian employees receive and how do they request it?"
  }],
  "retrievalReasoningEffort": { "kind": "minimal" },
  "outputMode": "extractiveData",
  "includeActivity": true
}

Odwołanie:Pobieranie wiedzy — pobieranie.

Upewnij się, że odpowiedź zawiera zarówno kanadyjskie zasady, jak i wyklucza us-leave. Aby sprawdzić zwrócone dowody i wykonanie źródła, zobacz Wyodrębniona odpowiedź, Tablica odwołań i Tablica działań.

Pomiń nazwę narzędzia, aby używać zwykłego pobierania całej bazy wiedzy. Pusta lub nieznana nazwa narzędzia kończy się niepowodzeniem zamiast wracać do pobierania całej bazy wiedzy.

Zastosuj ustawienia domyślne i przecięcia filtrów

Wartości domyślne narzędzi zastępują wartości domyślne bazy wiedzy. Jawnie określone wartości żądania zastępują zwykłe ustawienia domyślne narzędzia, ale filtry żądania nie zastępują filtrów narzędzia: są łączone operatorem AND.

Użyj tych kontrolek po kanadyjskiej linii bazowej. Żądanie nie może dodać źródeł wiedzy do narzędzia ani zastąpić jego filtru. Wykluczenie źródła w żądaniu ma pierwszeństwo przed ustawieniem narzędzia alwaysQuerySource.

  1. Zażądaj polityk USA bez wybrania narzędzia.

    from azure.search.documents.knowledgebases.models import (
        KnowledgeBaseRetrievalRequest,
        KnowledgeRetrievalMinimalReasoningEffort,
        KnowledgeRetrievalOutputMode,
        KnowledgeRetrievalSemanticIntent,
        SearchIndexKnowledgeSourceParams,
    )
    
    us_request = KnowledgeBaseRetrievalRequest(
        intents=[KnowledgeRetrievalSemanticIntent(
            search="What parental leave do US employees receive?",
        )],
        knowledge_source_params=[SearchIndexKnowledgeSourceParams(
            knowledge_source_name=source.name,
            filter_add_on="jurisdiction eq 'US'",
        )],
        retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(),
        output_mode=KnowledgeRetrievalOutputMode.EXTRACTIVE_DATA,
        include_activity=True,
    )
    us_response = retrieval_client.retrieve(us_request)
    

    Reference:KnowledgeBaseRetrievalClient.

  2. Wybierz narzędzie kanadyjskie w tym samym żądaniu z USA.

    us_request.tool_name = "canada-hr-search"
    intersection_response = retrieval_client.retrieve(us_request)
    

    Reference:KnowledgeBaseRetrievalClient.

    Efektywny filtr to CA i US, więc nie są zwracane żadne wyniki.

  3. Ustaw budżet na jeden dokument dla oryginalnego kanadyjskiego żądania.

    request.max_output_documents = 1
    limited_response = retrieval_client.retrieve(request)
    

    Reference:KnowledgeBaseRetrievalClient.

  1. Zażądaj polityk USA bez wybrania narzędzia.

    using Azure.Search.Documents.KnowledgeBases.Models;
    
    var usRequest = new KnowledgeBaseRetrievalRequest
    {
        Intents =
        {
            new KnowledgeRetrievalSemanticIntent(
                "What parental leave do US employees receive?"),
        },
        KnowledgeSourceParams =
        {
            new SearchIndexKnowledgeSourceParams(source.Name)
            {
                FilterAddOn = "jurisdiction eq 'US'",
            },
        },
        RetrievalReasoningEffort =
            new KnowledgeRetrievalMinimalReasoningEffort(),
        OutputMode = KnowledgeRetrievalOutputMode.ExtractiveData,
        IncludeActivity = true,
    };
    var usResponse = await retrievalClient.RetrieveAsync(usRequest);
    

    Reference:KnowledgeBaseRetrievalClient.

  2. Wybierz narzędzie kanadyjskie w tym samym żądaniu z USA.

    usRequest.ToolName = "canada-hr-search";
    var intersectionResponse = await retrievalClient.RetrieveAsync(usRequest);
    

    Reference:KnowledgeBaseRetrievalClient.

    Efektywny filtr to CA i US, więc nie są zwracane żadne wyniki.

  3. Ustaw budżet na jeden dokument dla oryginalnego kanadyjskiego żądania.

    request.MaxOutputDocuments = 1;
    var limitedResponse = await retrievalClient.RetrieveAsync(request);
    

    Reference:KnowledgeBaseRetrievalClient.

  1. Zażądaj polityk USA bez toolName, używając jawnego filtru źródła USA.

    POST {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}/retrieve?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "intents": [{
        "type": "semantic",
        "search": "What parental leave do US employees receive?"
      }],
      "knowledgeSourceParams": [{
        "knowledgeSourceName": "{{knowledgeSourceName}}",
        "kind": "searchIndex",
        "filterAddOn": "jurisdiction eq 'US'"
      }],
      "retrievalReasoningEffort": { "kind": "minimal" },
      "outputMode": "extractiveData",
      "includeActivity": true
    }
    

    Odwołanie:Pobieranie wiedzy — pobieranie.

  2. Powtórz to samo pytanie dotyczące USA i filtr zapytania przy wybranym narzędziu kanadyjskim.

    POST {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}/retrieve?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "toolName": "canada-hr-search",
      "intents": [{
        "type": "semantic",
        "search": "What parental leave do US employees receive?"
      }],
      "knowledgeSourceParams": [{
        "knowledgeSourceName": "{{knowledgeSourceName}}",
        "kind": "searchIndex",
        "filterAddOn": "jurisdiction eq 'US'"
      }],
      "retrievalReasoningEffort": { "kind": "minimal" },
      "outputMode": "extractiveData",
      "includeActivity": true
    }
    

    Odwołanie:Pobieranie wiedzy — pobieranie.

    Efektywny filtr to CA i US, więc nie są zwracane żadne wyniki.

  3. Zastąp zwykłe domyślne ustawienie liczby dokumentów wyjściowych w narzędziu budżetem żądania jednego dokumentu.

    POST {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}/retrieve?api-version=2026-11-01-preview
    Content-Type: application/json
    Authorization: Bearer {{searchAccessToken}}
    
    {
      "toolName": "canada-hr-search",
      "intents": [{
        "type": "semantic",
        "search": "What parental leave do Canadian employees receive and how do they request it?"
      }],
      "retrievalReasoningEffort": { "kind": "minimal" },
      "outputMode": "extractiveData",
      "includeActivity": true,
      "maxOutputDocuments": 1
    }
    

    Odwołanie:Pobieranie wiedzy — pobieranie.

Poziom filterAddOn źródła jest obsługiwany dla zgodnych źródeł indeksu wyszukiwania; niezgodne rodzaje źródeł nie przechodzą walidacji podczas zapisywania. Zapoznaj się z filtrowaniem w czasie wykonywania zapytania, aby poznać strukturę żądania, oraz z limitami pobierania agentowego, aby poznać wspólne limity.

Odnajdywanie i wywoływanie narzędzia za pośrednictwem programu MCP

Aby wykryć i wywołać canada-hr-search, wykonaj kroki opisane w sekcji Wywoływanie punktu końcowego MCP, z uwzględnieniem dwóch zmian dotyczących niestandardowych narzędzi do pobierania z bazy wiedzy. Użyj punktu końcowego 2026-11-01-preview MCP, ponieważ narzędzia niestandardowe nie są dostępne we wcześniejszych wersjach interfejsu API. Jeśli zezwalasz na narzędzie lub wywołujesz je, użyj skonfigurowanej nazwy canada-hr-search zamiast knowledge_base_retrieve; odnajdywanie zwraca tę samą nazwę.

Usuwanie narzędzia

Wyczyść narzędzia i zaktualizuj bazę wiedzy.

knowledge_base.tools = []
knowledge_base = index_client.create_or_update_knowledge_base(
    knowledge_base,
)

Odwołanie:SearchIndexClient.

Wyczyść narzędzia i zaktualizuj bazę wiedzy.

knowledgeBase.Tools.Clear();
knowledgeBase = (await indexClient.CreateOrUpdateKnowledgeBaseAsync(
    knowledgeBase)).Value;

Odwołanie:SearchIndexClient.

Wyślij pełną definicję bazy wiedzy z pustą tools tablicą.

PUT {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{searchAccessToken}}

{
  "name": "{{knowledgeBaseName}}",
  "knowledgeSources": [{ "name": "{{knowledgeSourceName}}" }],
  "retrievalReasoningEffort": { "kind": "minimal" },
  "outputMode": "extractiveData",
  "tools": []
}

Odwołanie:Bazy wiedzy — tworzenie lub aktualizowanie.

Troubleshooting

Aby uzyskać bardziej kompleksowe rozwiązywanie problemów, zobacz Wykonywanie zapytań w bazie wiedzy przy użyciu akcji pobierania lub punktu końcowego MCP.

Czyszczenie przykładowych zasobów

Usunięcie narzędzia nie powoduje usunięcia bazy wiedzy ani jej źródła. Usuń tylko zasoby utworzone dla tego przykładu, w kolejności zależności: baza wiedzy, źródło wiedzy, a następnie indeks.

index_client.delete_knowledge_base(knowledge_base_name)
index_client.delete_knowledge_source(knowledge_source_name)
index_client.delete_index(index_name)

Odwołanie:SearchIndexClient.

await indexClient.DeleteKnowledgeBaseAsync(knowledgeBaseName);
await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName);
await indexClient.DeleteIndexAsync(indexName);

Odwołanie:SearchIndexClient.

### Delete the owned sample KB
DELETE {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}?api-version=2026-11-01-preview
Authorization: Bearer {{searchAccessToken}}

### Delete the owned sample knowledge source
DELETE {{searchEndpoint}}/knowledgesources/{{knowledgeSourceName}}?api-version=2026-11-01-preview
Authorization: Bearer {{searchAccessToken}}

### Delete the owned sample index
DELETE {{searchEndpoint}}/indexes/{{indexName}}?api-version=2026-11-01-preview
Authorization: Bearer {{searchAccessToken}}

Odwołanie:bazy wiedzy, źródła wiedzy i indeksy.