Important
기술 자료 도구 기능은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
이 기능에 대한 미리 보기 관련 약관은 미리 보기 기능을 참조하세요.
지식 베이스 도구를 사용하면 하나의 지식 베이스로 애플리케이션 및 에이전트에 대한 여러 작업별 검색 워크플로를 지원할 수 있습니다. 각 도구는 지식 소스를 선택하고 추론 수준 및 출력 제한과 같은 재사용 가능한 검색 방식을 설정합니다. 클라이언트는 REST를 통해 도구를 호출하거나 MCP 엔드포인트를 통해 도구를 찾아 호출할 수 있습니다.
클라이언트가 요청할 때마다 동일한 지식 소스와 기본값을 매번 다시 구성하지 않고도 검색을 위한 일관된 진입점이 필요한 경우 기술 자료 도구를 사용하세요. 이 문서에서는 도구를 만들고, 저장된 설정이 요청 시간 컨트롤과 상호 작용하는 방법을 테스트하고, MCP를 통해 호출하고, 업데이트하거나 제거합니다.
사용량 지원
| Azure 포털 | Microsoft Foundry 포털 | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Prerequisites
- 샘플 리소스를 만들고 쿼리할 수 있는 권한 사용자 계정에 할당된 Search Service 기여자, 검색 인덱스 데이터 기여자 및 검색 인덱스 데이터 판독기 역할을 사용하여 키 없는 인증을 구성합니다.
-
azure-search-documents의 최신 미리 보기 버전 및azure-identity패키지입니다. Python 클라이언트 라이브러리를 참조하세요.
- .NET 8 이상 콘솔 프로젝트와 최신 미리 보기 버전의
Azure.Search.Documents가 필요합니다. .NET 클라이언트 라이브러리를 참조하세요.
샘플 지식 베이스 만들기
인덱스, 지식 원본 및 기술 자료를 만듭니다.
Foundry IQ(Azure AI 검색)에 연결에 설명된 대로 로그인합니다. SDK 코드 조각을 순서대로 실행합니다.
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)
참조:DefaultAzureCredential, SearchClient, SearchIndexClient.
인덱스 만들기 및 세 가지 가상 정책 업로드
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)
참조:SearchIndexClient, SearchIndex, SearchClient.upload_documents.
Foundry IQ에 연결에 설명된 대로 로그인합니다. SDK 코드 조각을 순서대로 실행합니다.
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);
참조:DefaultAzureCredential, SearchClient, SearchIndexClient.
인덱스 만들기 및 세 가지 가상 정책 업로드
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);
참조:SearchIndexClient, SearchIndex, SearchClient.UploadDocumentsAsync.
지식 소스를 만듭니다.
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"), ], ), ), )최소한의 추론 및 추출 출력을 사용하여 모델 없는 기술 자료를 만듭니다.
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, ))
지식 소스를 만듭니다.
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;최소한의 추론 및 추출 출력을 사용하여 모델 없는 기술 자료를 만듭니다.
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;
Foundry IQ 서비스 엔드포인트 및 액세스 토큰을 설정합니다. 액세스 토큰을 얻으려면 Foundry IQ에 연결을 참조하세요.
@searchEndpoint = <search-endpoint> @searchAccessToken = <search-access-token> @indexName = kb-tools-policy-index @knowledgeSourceName = kb-tools-policy-source @knowledgeBaseName = kb-tools-policy-kb검색 가능한 정책 텍스트와 필터링 가능한 관할 필드를 사용하여 인덱스를 만드세요
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 } ] }세 가지 가상 정책을 업로드합니다.
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." } ] }참조:문서 - 인덱스.
지식 소스를 만듭니다.
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" } ] } }최소한의 추론 및 추출 출력을 사용하여 지식 베이스를 만듭니다.
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" }
지식 베이스에 사용자 지정 도구 추가
도구는 기술 자료에 이미 정의된 지식 소스를 참조합니다. 지식 베이스는 도구의 이름, 설명 및 기본값을 저장합니다.
캐나다 지식 원본 참조를 구성합니다.
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, )참조:인덱스 모델.
기술 자료에 도구를 추가합니다.
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, )
캐나다의 지식 원본 참조를 구성합니다.
using Azure.Search.Documents.Indexes.Models; var toolSource = new KnowledgeBaseToolKnowledgeSourceReference(source.Name) { FilterAddOn = "jurisdiction eq 'CA'", RerankerThreshold = 0, MaxOutputDocuments = 50, FailOnError = true, };참조:인덱스 모델.
기술 자료에 도구를 추가합니다.
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;
하나의 도구로 전체 기술 자료 모음 정의를 보냅니다.
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
}
}]
}
CA 필터는 기술 자료 정의가 아니라 도구의 기술 자료 참조에 속합니다. 도구를 선택하면 검색이 시작되기 전에 구성된 지식 소스로 검색이 제한됩니다. 이 원 소스 예제에서 필터는 검색을 캐나다 문서로 제한합니다.
도구 호출하기
기존 가져오기 작업에서 도구를 선택합니다. 전체 질문을 포함하는 하나의 의미 체계 의도를 사용합니다.
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)
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);
전체 질문을 포함하는 하나의 의미 체계 의도를 보냅니다.
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
}
응답에 캐나다 정책이 포함되고 us-leave는 제외되는지 확인합니다. 반환된 증명 정보 및 원본 실행을 검사하려면 추출된 응답, 참조 배열 및 활동 배열을 참조하세요.
일반 기술 자료 전체 검색을 사용하려면 도구 이름을 생략하세요. 도구 이름이 비어 있거나 알 수 없으면 기술 자료 전체 검색으로 되돌아가는 대신 실패합니다.
기본값 적용 및 필터 교차
도구 기본값은 기술 자료 기본값을 재정의합니다. 명시적 요청 값은 일반 도구 기본값을 재정의하지만 요청 필터는 도구 필터를 대체하지 않고 대신 AND로 결합됩니다.
캐나다 기준선 다음에 이러한 제어 요소를 사용하세요. 요청은 도구에 지식 소스를 추가하거나 필터를 바꿀 수 없습니다. 요청 소스 제외는 도구 설정 alwaysQuerySource보다 우선합니다.
도구를 선택하지 않고 US 정책을 요청합니다.
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)동일한 미국 요청에서 캐나다 도구를 선택합니다.
us_request.tool_name = "canada-hr-search" intersection_response = retrieval_client.retrieve(us_request)참조:KnowledgeBaseRetrievalClient.
유효 필터는 CA 및 US이므로 결과가 반환되지 않습니다.
원래 캐나다 요청에 대해 하나의 문서 예산을 설정합니다.
request.max_output_documents = 1 limited_response = retrieval_client.retrieve(request)
도구를 선택하지 않고 미국 정책을 요청합니다.
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);동일한 미국 요청에서 캐나다 도구를 선택합니다.
usRequest.ToolName = "canada-hr-search"; var intersectionResponse = await retrievalClient.RetrieveAsync(usRequest);참조:KnowledgeBaseRetrievalClient.
유효 필터는 CA 및 US이므로 결과가 반환되지 않습니다.
원래 캐나다 요청에 대해 문서 1개로 제한을 설정합니다.
request.MaxOutputDocuments = 1; var limitedResponse = await retrievalClient.RetrieveAsync(request);
명시적 미국 소스 필터를 사용하여
toolName없이 미국 정책을 요청합니다.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 }참조:지식 검색 - 검색.
캐나다 도구를 선택한 상태에서 동일한 미국 질문 및 요청 필터를 반복하세요.
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 }참조:지식 검색 - 가져오기.
유효 필터는 CA 및 US이므로 결과가 반환되지 않습니다.
도구의 일반 출력 문서 기본값을 단일 문서 요청 한도로 재정의합니다.
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 }참조:지식 검색 - 가져오기
filterAddOn 원본 수준은 호환되는 검색 인덱스 원본에 대해 지원됩니다. 호환되지 않는 원본 종류는 저장 시 유효성 검사에 실패합니다. 요청 셰이프에 대해서는 쿼리 시간 필터링을, 공유 제한에 대해서는 에이전트 검색 제한을 참조하세요.
MCP를 통해 도구를 찾고 호출
canada-hr-search을 검색하고 호출하려면 사용자 지정 기술 자료 검색 도구에 대한 두 가지 변경 사항과 함께 MCP 엔드포인트 호출의 단계를 따르세요.
사용자 지정 도구는 이전 API 버전에서는 사용할 수 없으므로 2026-11-01-preview MCP 엔드포인트를 사용하세요. 도구를 허용하거나 호출할 때는 knowledge_base_retrieve 대신 구성된 이름 canada-hr-search을(를) 사용합니다. 검색은 동일한 이름을 반환합니다.
도구 제거
도구를 지우고 지식 베이스를 업데이트합니다.
knowledge_base.tools = []
knowledge_base = index_client.create_or_update_knowledge_base(
knowledge_base,
)
도구를 지우고 지식 베이스를 업데이트합니다.
knowledgeBase.Tools.Clear();
knowledgeBase = (await indexClient.CreateOrUpdateKnowledgeBaseAsync(
knowledgeBase)).Value;
빈 tools 배열을 사용하여 전체 기술 자료 정의를 보냅니다.
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": []
}
Troubleshooting
보다 포괄적인 문제 해결 방법은 retrieve 작업 또는 MCP 엔드포인트를 사용하여 기술 자료를 조회하기를 참조하세요.
샘플 리소스 정리
도구를 제거해도 기술 자료나 해당 원본은 삭제되지 않습니다. 이 샘플에 대해 만든 리소스만 종속성 순서인 지식 베이스, 지식 원본, 그다음 인덱스 순으로 삭제합니다.
index_client.delete_knowledge_base(knowledge_base_name)
index_client.delete_knowledge_source(knowledge_source_name)
index_client.delete_index(index_name)
await indexClient.DeleteKnowledgeBaseAsync(knowledgeBaseName);
await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName);
await indexClient.DeleteIndexAsync(indexName);
### 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}}