Important
Microsoft Retriever 1은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
이 기능과 관련된 미리 보기 관련 약관은 미리 보기 기능을 참조하세요.
Microsoft-retriever-1은 Azure AI 검색(Foundry IQ)에서 호스트되는 특수 검색 모델입니다. 외부 계획 모델을 연결하거나 해당 모델이 제공하는 검색 계획 기능을 위해 해당 모델의 네트워킹 및 인증을 구성할 필요가 없습니다. 이 워크플로는 작은 정책 인덱스를 직접 검색한 다음 지식 베이스를 통해 동일한 콘텐츠를 제공합니다.
사용량 지원
| Azure 포털 | Microsoft Foundry 포털 | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Prerequisites
- 지원되는 지역에서 표준 지식 검색 계획을 사용하는 Foundry IQ 서비스입니다.
- 샘플 인덱스, 지식 원본 및 기술 자료를 만들고, 채우고, 쿼리하고, 삭제할 수 있는 권한입니다. 키 없는 인증의 경우 Foundry IQ 서비스에서 검색 서비스 기여자, 검색 인덱스 데이터 기여자 및 검색 인덱스 데이터 판독기 역할을 ID에 할당합니다.
-
azure-search-documents의 최신 미리 보기 버전 및azure-identity패키지입니다. Python 클라이언트 라이브러리를 참조하세요.
- .NET 8 이상 콘솔 프로젝트와 최신 미리 보기 버전의
Azure.Search.Documents가 필요합니다. .NET 클라이언트 라이브러리를 참조하세요.
작은 정책 인덱스 만들기
검색 가능한 정책 텍스트와 필터링 가능한 관할 필드를 사용하여 인덱스 만들기
Foundry IQ에 연결에 설명된 대로 로그인합니다. 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 = "mr1-policy-index"
knowledge_source_name = "mr1-policy-source"
knowledge_base_name = "mr1-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."
),
},
]
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 = "mr1-policy-index";
string knowledgeSourceName = "mr1-policy-source";
string knowledgeBaseName = "mr1-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.",
},
};
await searchClient.UploadDocumentsAsync(documents);
참조:SearchIndexClient, SearchIndex, SearchClient.UploadDocumentsAsync.
Foundry IQ 서비스 엔드포인트 및 액세스 토큰을 설정합니다. 액세스 토큰을 가져오려면 Foundry IQ에 연결을(를) 참조하세요.
@searchEndpoint = <search-endpoint> @searchAccessToken = <search-access-token> @indexName = mr1-policy-index @knowledgeSourceName = mr1-policy-source @knowledgeBaseName = mr1-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." } ] }참조:문서 - 인덱스.
Microsoft Retriever 1을 사용하여 직접 검색합니다
에이전트 쿼리 실행, 필터 및 디버그 모드가 agentic으로 설정된 전체 질문을 제출합니다.
from azure.search.documents.models import (
AgenticSearchOptions,
QueryDebugMode,
QueryType,
)
question = "What parental leave do Canadian employees receive and how do they request it?"
results = search_client.search(
search_text=question,
query_type=QueryType.AGENTIC,
agentic_options=AgenticSearchOptions(max_runtime_in_seconds=60),
filter="jurisdiction eq 'CA'",
select=["id", "title", "content", "jurisdiction"],
top=5,
debug=QueryDebugMode.AGENTIC,
)
documents = list(results)
diagnostics = results.get_debug_info()
진단 예제:
{
"semantic": null,
"queryRewrites": null,
"agentic": {
"terminationReason": "modelStopped",
"subQueries": [],
"usage": {
"agenticPlanningTokens": 102,
"reasoningTokens": 50
}
}
}
에이전트 쿼리 실행, 필터 및 디버그 모드가 agentic으로 설정된 전체 질문을 제출합니다.
using Azure.Search.Documents;
using Azure.Search.Documents.Models;
string question = "What parental leave do Canadian employees receive and how do they request it?";
var options = new SearchOptions
{
QueryType = SearchQueryType.Agentic,
AgenticOptions = new AgenticSearchOptions { MaxRuntimeInSeconds = 60 },
Filter = "jurisdiction eq 'CA'",
Select = { "id", "title", "content", "jurisdiction" },
Size = 5,
Debug = QueryDebugMode.Agentic,
};
var directResult = await searchClient.SearchAsync<SearchDocument>(
question, options);
진단 예제:
{
"semantic": null,
"queryRewrites": null,
"agentic": {
"terminationReason": "modelStopped",
"subQueries": [],
"usage": {
"agenticPlanningTokens": 102,
"reasoningTokens": 50
}
}
}
queryType: "agentic"를 사용하여 전체 질문을 제출합니다. 필터는 증거를 캐나다로 제한하고, select는 반환되는 필드를 제어합니다.
POST {{searchEndpoint}}/indexes/{{indexName}}/docs/search?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{searchAccessToken}}
{
"search": "What parental leave do Canadian employees receive and how do they request it?",
"queryType": "agentic",
"agenticOptions": { "maxRuntimeInSeconds": 60 },
"filter": "jurisdiction eq 'CA'",
"select": "id,title,content,jurisdiction",
"top": 5,
"debug": "agentic"
}
참조:문서 - 검색 POST.
200 응답은 요청이 완료되었음을 의미합니다. 응답이 206이면 부분적인 성공을 의미하며 응답에는 문서가 계속 포함될 수 있습니다.
종료 이유가 modelStopped인 경우는 모델이 중지되거나 서비스가 반복 제한에 도달한 후 처리가 완료되었음을 의미합니다.
maxRuntimeExceeded 는 모델이 중지되기 전에 요청이 런타임 제한에 도달했음을 의미합니다.
modelFailed 는 모델이 중지되기 전에 모델 처리가 실패했음을 의미합니다.
지식 베이스를 통해 가져오기
검색 인덱스 지식 소스를 사용하여 동일한 인덱스를 재사용하세요.
지식 소스를 만듭니다.
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"), ], ), ), )microsoft-retriever-1 모델, 최소 추론, 추출형 출력을 사용하여 지식 베이스를 생성합니다.
from azure.search.documents.indexes.models import ( KnowledgeBase, KnowledgeBaseMicrosoftRetriever1Model, KnowledgeSourceReference, ) from azure.search.documents.knowledgebases.models import ( KnowledgeRetrievalOutputMode, KnowledgeRetrievalMinimalReasoningEffort, ) knowledge_base = index_client.create_knowledge_base(KnowledgeBase( name=knowledge_base_name, knowledge_sources=[ KnowledgeSourceReference(name=source.name), ], models=[KnowledgeBaseMicrosoftRetriever1Model()], retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(), output_mode=KnowledgeRetrievalOutputMode.EXTRACTIVE_DATA, ))전체 질문을 포함하는 시맨틱 의도를 정확히 하나만 사용하여 검색합니다.
from azure.search.documents.knowledgebases import ( KnowledgeBaseRetrievalClient, ) from azure.search.documents.knowledgebases.models import ( KnowledgeBaseRetrievalRequest, KnowledgeRetrievalMinimalReasoningEffort, KnowledgeRetrievalOutputMode, KnowledgeRetrievalSemanticIntent, ) retrieval_client = KnowledgeBaseRetrievalClient( search_endpoint, credential, knowledge_base_name=knowledge_base.name, ) response = retrieval_client.retrieve(KnowledgeBaseRetrievalRequest( intents=[KnowledgeRetrievalSemanticIntent(search=question)], retrieval_reasoning_effort=KnowledgeRetrievalMinimalReasoningEffort(), output_mode=KnowledgeRetrievalOutputMode.EXTRACTIVE_DATA, include_activity=True, ))
지식 소스를 만듭니다.
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;microsoft-retriever-1 모델, 최소 추론 및 추출 출력을 사용하여 기술 자료를 만듭니다.
using Azure.Search.Documents.Indexes.Models; using Azure.Search.Documents.KnowledgeBases.Models; var knowledgeBase = (await indexClient.CreateKnowledgeBaseAsync( new KnowledgeBase(knowledgeBaseName, [new KnowledgeSourceReference(source.Name)]) { Models = { new KnowledgeBaseMicrosoftRetriever1Model() }, RetrievalReasoningEffort = new KnowledgeRetrievalMinimalReasoningEffort(), OutputMode = KnowledgeRetrievalOutputMode.ExtractiveData, })).Value;전체 질문을 포함하는 의미적 의도를 정확히 하나만 사용하여 검색합니다.
using Azure.Search.Documents.KnowledgeBases; using Azure.Search.Documents.KnowledgeBases.Models; var retrievalClient = new KnowledgeBaseRetrievalClient( new Uri(searchEndpoint), knowledgeBase.Name, credential); var request = new KnowledgeBaseRetrievalRequest { Intents = { new KnowledgeRetrievalSemanticIntent(question) }, RetrievalReasoningEffort = new KnowledgeRetrievalMinimalReasoningEffort(), OutputMode = KnowledgeRetrievalOutputMode.ExtractiveData, IncludeActivity = true, }; var response = await retrievalClient.RetrieveAsync(request);
지식 소스를 만듭니다.
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" } ] } }microsoftRetriever1모델 종류, 최소 추론 및 추출형 출력을 사용하여 기술 자료를 만듭니다.PUT {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}?api-version=2026-11-01-preview Content-Type: application/json Authorization: Bearer {{searchAccessToken}} { "name": "{{knowledgeBaseName}}", "knowledgeSources": [{ "name": "{{knowledgeSourceName}}" }], "models": [{ "kind": "microsoftRetriever1" }], "retrievalReasoningEffort": { "kind": "minimal" }, "outputMode": "extractiveData" }전체 질문을 포함하는 의미 의도를 정확히 하나만 사용하여 검색합니다.
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 Canadian employees receive and how do they request it?" }], "retrievalReasoningEffort": { "kind": "minimal" }, "outputMode": "extractiveData", "includeActivity": true }참조:지식 검색 - 검색/가져오기.
활동 로그에는 다음 예제와 유사한 Planner 결과가 포함됩니다.
{
"type": "modelQueryPlanning",
"id": 1,
"inputTokens": 94,
"outputTokens": 26,
"elapsedMs": 251,
"model": {
"modelName": "microsoft-retriever-1"
}
}
증거 검사 중에 JSON 응답을 구문 분석하고 상호 연관시키려면 추출된 응답, 참조 배열 및 활동 배열을 따릅니다.
자동 검색 추론 노력
요청마다 난이도가 다를 수 있습니다. 일부 요청은 빠른 조회로 응답할 수 있지만 다른 요청은 더 심층적인 계획이 필요합니다. 각 요청의 난이도를 미리 예측할 수 없는 경우 Auto를 사용합니다. 자동은 모든 요청에 하나의 고정 추론 수준을 적용하는 대신 각 요청에 대한 검색 깊이를 선택합니다.
Auto는 각 요청에 대해 두 가지 경로 중 하나를 따릅니다. 기본 경로는 최소 검색 추론 작업을 사용하는 초기 자동 패스로 시작하고 필요한 경우에만 심층 계획으로 이동합니다. 요청이 기본 경로에 적합하지 않은 경우 Auto는 대신 Medium 노력 수준에서 시작합니다. 자동에는 요청이 Medium에서 시작되거나 Medium으로 에스컬레이션될 때 사용하는 외부 계획 모델이 필요합니다. 기본 경로는 요청이 다음 요구 사항을 모두 충족하는 경우에만 사용할 수 있습니다.
- Foundry IQ 서비스는 자동 검색 추론 수준을 지원하는 지역에 있습니다.
- 요청에는 정확히 하나의 의미적 의도가 포함됩니다.
- 지식 베이스의 모든 지식 소스는 최소 검색 추론 작업을 지원합니다.
- 다음 표와 같이 지식 베이스에 있는 하나 이상의 지식 원본이 초기 Auto 패스를 지원합니다.
alwaysQuerySource가true로 설정된 모든 지식 원본도 이 패스를 지원해야 합니다.
| 지식 출처 | 초기 자동 패스 |
|---|---|
| 검색 인덱스 | ✔️ |
| Azure Blob | ✔️ |
| Azure SQL | ✔️ |
| 파일 | ✔️ |
| OneLake | ✔️ |
| 인덱싱된 SharePoint | ✔️ |
| 원격 SharePoint | ❌ |
| Fabric 데이터 에이전트 | ❌ |
| Fabric 온톨로지 | ❌ |
| MCP 서버 | ❌ |
| 업무 IQ | ❌ |
| 웹 | ❌ |
- 초기 자동 패스의 기술 자료의 경우 이미지 제공이 꺼져 있고
resultsProcessing이(가)none(으)로 설정되어 있지 않습니다.
요청에 둘 이상의 의미적 의도가 포함되어 있거나 초기 Auto 패스에 대한 다른 요구 사항이 충족되지 않는 경우 Auto는 Medium으로 시작합니다. 초기 Auto 패스에 사용되지 않는 지식 원본은 이후 계획 단계에서 계속 쿼리할 수 있습니다.
요청이 기본 경로를 사용할 수 있는 경우 Auto는 더 간단한 검색에서 필요에 따라 더 복잡한 계획으로 에스컬레이션됩니다.
- Auto는 먼저 초기 단계에 적합한 지식 소스에 쿼리를 보냅니다. 상위 순위 결과가 충분히 관련성이 있는 경우 Auto는 이러한 결과를 즉시 반환합니다.
- 요청이 초기 패스에 대해 너무 복잡하고 microsoft-retriever-1이 요청에 사용할 수 있는 모든 지식 소스를 지원하는 경우 microsoft-retriever-1은 더 심층 검색을 실행합니다.
- 마지막으로 Microsoft-retriever-1은 요청에 심층적인 계획이 필요할 때 중간 수준으로 외부 계획 모델로 에스컬레이션할 수 있습니다.
자동을 사용하려면 기술 자료에 지원되는 외부 모델을 추가하고, 모델에 대한 액세스를 구성하고, 검색 추론 작업을 Auto로 설정합니다.
외부 계획 모델을 추가하고 자동을 기술 자료 기본값으로 설정합니다.
from azure.search.documents.indexes.models import ( AzureOpenAIVectorizerParameters, KnowledgeBaseAzureOpenAIModel, KnowledgeBaseMicrosoftRetriever1Model, ) from azure.search.documents.knowledgebases.models import ( KnowledgeRetrievalAutoReasoningEffort, ) azure_open_ai_model = KnowledgeBaseAzureOpenAIModel( azure_open_ai_parameters=AzureOpenAIVectorizerParameters( resource_url="<azure-openai-endpoint>", deployment_name="<model-deployment-name>", model_name="<model-name>", ), ) knowledge_base.models = [ KnowledgeBaseMicrosoftRetriever1Model(), azure_open_ai_model, ] knowledge_base.retrieval_reasoning_effort = ( KnowledgeRetrievalAutoReasoningEffort() ) knowledge_base = index_client.create_or_update_knowledge_base( knowledge_base, )자동으로 검색합니다.
from azure.search.documents.knowledgebases.models import ( KnowledgeBaseRetrievalRequest, KnowledgeRetrievalAutoReasoningEffort, KnowledgeRetrievalOutputMode, KnowledgeRetrievalSemanticIntent, ) auto_response = retrieval_client.retrieve( KnowledgeBaseRetrievalRequest( intents=[KnowledgeRetrievalSemanticIntent(search=question)], retrieval_reasoning_effort=( KnowledgeRetrievalAutoReasoningEffort() ), output_mode=KnowledgeRetrievalOutputMode.EXTRACTIVE_DATA, include_activity=True, ) )
외부 계획 모델을 추가하고 자동을 기술 자료 베이스 기본값으로 설정합니다.
using Azure.Search.Documents.Indexes.Models; using Azure.Search.Documents.KnowledgeBases.Models; var azureOpenAIParameters = new AzureOpenAIVectorizerParameters { ResourceUri = new Uri("<azure-openai-endpoint>"), DeploymentName = "<model-deployment-name>", ModelName = "<model-name>", }; knowledgeBase.Models.Clear(); knowledgeBase.Models.Add(new KnowledgeBaseMicrosoftRetriever1Model()); knowledgeBase.Models.Add(new KnowledgeBaseAzureOpenAIModel( azureOpenAIParameters: azureOpenAIParameters)); knowledgeBase.RetrievalReasoningEffort = new KnowledgeRetrievalAutoReasoningEffort(); knowledgeBase = (await indexClient.CreateOrUpdateKnowledgeBaseAsync( knowledgeBase)).Value;자동으로 검색합니다.
using Azure.Search.Documents.KnowledgeBases.Models; var autoRequest = new KnowledgeBaseRetrievalRequest { Intents = { new KnowledgeRetrievalSemanticIntent(question) }, RetrievalReasoningEffort = new KnowledgeRetrievalAutoReasoningEffort(), OutputMode = KnowledgeRetrievalOutputMode.ExtractiveData, IncludeActivity = true, }; var autoResponse = await retrievalClient.RetrieveAsync(autoRequest);
외부 계획 모델을 추가하고 자동을 지식 베이스 기본값으로 설정합니다.
PUT {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}?api-version=2026-11-01-preview Content-Type: application/json Authorization: ****** { "name": "{{knowledgeBaseName}}", "knowledgeSources": [{ "name": "{{knowledgeSourceName}}" }], "models": [ { "kind": "microsoftRetriever1" }, { "kind": "azureOpenAI", "azureOpenAIParameters": { "resourceUri": "<azure-openai-endpoint>", "deploymentId": "<model-deployment-name>", "modelName": "<model-name>" } } ], "retrievalReasoningEffort": { "kind": "auto" }, "outputMode": "extractiveData" }Auto로 검색
POST {{searchEndpoint}}/knowledgebases/{{knowledgeBaseName}}/retrieve?api-version=2026-11-01-preview Content-Type: application/json Authorization: ****** { "intents": [{ "type": "semantic", "search": "What parental leave do Canadian employees receive and how do they request it?" }], "retrievalReasoningEffort": { "kind": "auto" }, "outputMode": "extractiveData", "includeActivity": true }참조:지식 검색 - 검색.
다음은 microsoft-retriever-1에서 외부 계획 모델로 에스컬레이션되는 자동 요청을 보여 주는 단축된 작업 발췌 내용입니다.
{
"activity": [
{
"type": "modelQueryPlanning",
"model": {
"modelName": "microsoft-retriever-1"
}
},
{
"type": "modelQueryPlanning",
"model": {
"modelName": "<model-name>",
"deploymentId": "<model-deployment-name>"
}
},
{
"type": "agenticReasoning",
"logicalReasoningEffort": {
"kind": "auto"
}
}
]
}
첫 번째 계획 레코드는 microsoft-retriever-1 활동을 보여줍니다. 두 번째는 계획이 외부 계획 모델에 전달되었음을 보여줍니다.
자세한 내용은 검색 추론 노력을 참조하세요.
Limitations
- microsoft-retriever-1만 사용하는 기술 자료는 낮음 또는 중간 검색 추론 노력 수준이나 지식 원본 선택을 지원하지 않습니다.
- Direct Search 에이전트 실행은
skip이 0이 아님,orderby,count: true, 패싯, 100 미만의 커버리지, 강조 표시, 쿼리 다시 쓰기, 맞춤법 검사기,semanticQuery, 답변, 캡션, 의미 체계 대기 또는 오류 컨트롤, 벡터 쿼리 다시 쓰기,featuresMode,queryLanguage, 또는semanticFields을(를) 지원하지 않습니다. Purview 사용이 설정된 인덱스도 지원되지 않습니다.
문제 해결
활동을 포함하는 최소 요청에 model.modelName이 modelQueryPlanning인 microsoft-retriever-1 활동이 없는 경우 필수 구성 요소를 확인하고 요청에 하나의 의미 체계 의도가 포함되어 있는지 확인합니다. 여러 의도는 microsoft-retriever-1 계획을 건너뛰고, 일반 최소 검색을 실행하고, 206 활동 레코드에 경고를 기록하고 agenticReasoning를 반환합니다.
microsoft-retriever-1이 시작되지만 계획을 완료하지 않으면 해당 modelQueryPlanning 활동 레코드에 오류가 포함됩니다. Minimal을 사용하면 검색된 결과가 유지되면 요청은 206을 반환하고, 그렇지 않으면 요청이 실패합니다. Auto를 사용하면 Auto 활동 예제와 같이 계획을 외부 계획 모델에 넘겨줄 수 있습니다.
샘플 리소스 정리
이 샘플에 대해 만든 리소스만 종속성 순서(기술 자료, 기술 원본, 인덱스)로 삭제하세요.
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}}