참고
Foundry IQ (Azure AI 검색)는 관리형 검색을 위한 상위 수준의 지식 원본 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
중요
이 문서에서 (미리 보기)로 표시된 기능 또는 성능은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
Foundry IQ(Azure AI 검색) 관련 미리 보기 약관은 미리 보기 기능을 참조하세요.
기본적으로 Azure AI 검색(Foundry IQ)의 기술 자료는 데이터 추출을 수행하여 답변을 생성하지 않고 지식 원본에서 접지 콘텐츠를 반환합니다.
대신 답변 합성을 활성화할 수 있으며, 이 기능은 지식 베이스에 구성된 LLM을 사용하여 자연어 답변을 생성합니다. 글머리 기호 목록 요청과 같이 응답 형식을 조정하는 응답 지침을 제공할 수 있습니다. 참조는 인용에 사용되는 원본 ID를 제공합니다.
지식 베이스 또는 검색 요청에서 출력 모드를 설정할 수 있습니다. 기술 자료 설정은 모든 쿼리에 대한 기본값을 설정하는 반면, 검색 요청 설정은 쿼리별로 기본값을 재정의합니다.
사용량 지원
| Azure 포털 | Microsoft Foundry 포털 | .NET SDK | Python SDK | Java SDK | JavaScript SDK | REST API |
|---|---|---|---|---|---|---|
| ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
필수 구성 요소
LLM을 지정하는 지식 베이스가 있는 Foundry IQ 서비스입니다.
기술 자료를 업데이트할 수 있는 권한입니다. 사용자 계정에 할당된 Search Service 기여자 역할로 키 없는 인증을 구성하거나(권장) 관리자 API 키를 사용합니다.
LLM에 대한 아웃바운드 호출의 경우 Foundry IQ 서비스에는 Microsoft Foundry 리소스에 대한 Cognitive Services 사용자 권한이 있는 관리 ID가 있어야 합니다.
최신
Azure.Search.Documents미리 보기 패키지:dotnet add package Azure.Search.Documents --prerelease키 없는 인증의 경우 패키지:
Azure.Identitydotnet add package Azure.Identity
최신
azure-search-documents미리 보기 패키지:pip install --pre azure-search-documents키 없는 인증의 경우 패키지:
azure-identitypip install azure-identity
2026-10-01이상 Search REST API 이 예제에서는2026-11-01-preview를 사용합니다.키 없는 인증의 경우 각 HTTP 요청의 헤더에 Microsoft Entra ID 토큰을
Authorization포함합니다.
제한 사항 및 고려 사항
일반적인
minimal처리는 응답 합성이 아니라 모델 기반 쿼리 계획을 건너뜁니다. 합성에는minimal를 포함하여 별도로 구성된 모델이 필요합니다. 자세한 내용은 검색 추론 작업 설정을 참조하세요.응답 합성은 입력 및 출력 토큰 수를 기반으로 하는 Azure OpenAI에서 종량제 요금이 발생합니다. 요금은 기술 자료에 할당된 LLM 아래에 표시됩니다. 자세한 내용은 지역 가용성, 제한 및 청구를 참조하세요.
기술 자료에서 응답 합성 사용
기존 지식 기반에서 응답 합성을 사용하도록 설정합니다. 지식 베이스를 만들려면 지식 베이스 만들기를 참조하세요.
OutputMode 정의에서 "answerSynthesis"을 KnowledgeBase로 설정합니다. 필요에 따라 응답 출력을 사용자 지정하도록 설정합니다 AnswerInstructions . 다음 예에서는 지식 베이스가 Use concise bulleted lists하도록 지시합니다.
var indexClient = new SearchIndexClient(
new Uri(searchEndpoint), credential);
var aoaiParams = new AzureOpenAIVectorizerParameters
{
ResourceUri = new Uri("<aoai-endpoint>"),
DeploymentName = "<aoai-gpt-deployment>",
ModelName = "<aoai-gpt-model>",
};
var knowledgeBase = new KnowledgeBase(
name: "<knowledge-base-name>",
knowledgeSources: new[] { new KnowledgeSourceReference("<knowledge-source-name>") })
{
Models = { new KnowledgeBaseAzureOpenAIModel(aoaiParams) },
OutputMode = "answerSynthesis",
AnswerInstructions = "Use concise bulleted lists",
};
await indexClient.CreateOrUpdateKnowledgeBaseAsync(knowledgeBase);
output_mode 정의에서 "answerSynthesis"을 KnowledgeBase로 설정합니다. 필요에 따라 응답 출력을 사용자 지정하도록 설정합니다 answer_instructions . 다음 예에서는 지식 베이스가 Use concise bulleted lists하도록 지시합니다.
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
AzureOpenAIVectorizerParameters,
KnowledgeBase,
KnowledgeBaseAzureOpenAIModel,
KnowledgeSourceReference,
)
aoai_params = AzureOpenAIVectorizerParameters(
resource_url="<aoai-endpoint>",
deployment_name="<aoai-gpt-deployment>",
model_name="<aoai-gpt-model>",
)
knowledge_base = KnowledgeBase(
name="<knowledge-base-name>",
models=[KnowledgeBaseAzureOpenAIModel(azure_open_ai_parameters=aoai_params)],
knowledge_sources=[KnowledgeSourceReference(name="<knowledge-source-name>")],
output_mode="answerSynthesis",
answer_instructions="Use concise bulleted lists",
)
index_client = SearchIndexClient(
endpoint=search_endpoint,
credential=credential,
)
index_client.create_or_update_knowledge_base(knowledge_base)
기술 자료 정의에서 outputMode을(를) "answerSynthesis"(으)로 설정합니다. 필요에 따라 응답 출력을 사용자 지정하도록 설정합니다 answerInstructions . 다음 예에서는 지식 베이스가 Use concise bulleted lists하도록 지시합니다.
지식 베이스에서 명명된 도구를 정의하는 경우 업데이트에 기존 tools 배열을 포함합니다.
### Enable answer synthesis in a knowledge base
PUT {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}
{
"name": "{{knowledge-base-name}}",
"knowledgeSources": [ ... // OMITTED FOR BREVITY ],
"models": [ ... // OMITTED FOR BREVITY ],
"outputMode": "answerSynthesis",
"answerInstructions": "Use concise bulleted lists"
}
검색 요청에서 응답 합성 사용
응답 형식에 대한 쿼리별 제어의 경우 쿼리 시간에 응답 합성을 사용하도록 설정할 수 있습니다. 이 방법은 기술 자료에 지정된 기본 출력 모드를 재정의합니다.
REST로 응답 합성 사용
배열에 models, 채워진 검색 인덱스 지식 원본 및 콘텐츠를 검색할 권한이 있는 자격 증명이 포함된 기존 지식 베이스를 사용합니다. 기술 자료에서 Azure OpenAI를 사용하는 경우 액세스를 구성합니다.
POST {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}/retrieve?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{search-token}}
{
"intents": [
{
"type": "semantic",
"search": "What is the return policy?"
}
],
"retrievalReasoningEffort": {
"kind": "minimal"
},
"outputMode": "answerSynthesis",
"includeActivity": true
}
참조:지식 검색 - 검색
응답 메시지, 참조, 그리고 별도의 modelAnswerSynthesis 활동을 확인합니다. 모델 지원 쿼리 계획의 경우 medium 또는 low를 대신 선택하세요. 메시지 또는 의도 중 하나만 제공하고 둘 다 제공하지 마세요.
추가 예시
다음 예제에서는 동등한 SDK 및 메시지 기반 REST 요청을 보여 줍니다.
OutputMode에서 "answerSynthesis"을(를) KnowledgeBaseRetrievalRequest(으)로 설정합니다.
var client = new KnowledgeBaseRetrievalClient(
endpoint: new Uri(searchEndpoint),
knowledgeBaseName: knowledgeBaseName,
credential: credential);
var request = new KnowledgeBaseRetrievalRequest
{
RetrievalReasoningEffort = new KnowledgeRetrievalLowReasoningEffort()
};
request.Messages.Add(
new KnowledgeBaseMessage(
content: new[]
{
new KnowledgeBaseMessageTextContent("What is healthcare?")
}) { Role = "user" });
request.OutputMode = "answerSynthesis";
var result = await client.RetrieveAsync(request);
참조:KnowledgeBaseRetrievalClient, KnowledgeBaseRetrievalRequest
output_mode에서 "answerSynthesis"을(를) KnowledgeBaseRetrievalRequest(으)로 설정합니다.
from azure.search.documents.knowledgebases import KnowledgeBaseRetrievalClient
from azure.search.documents.knowledgebases.models import (
KnowledgeBaseMessage,
KnowledgeBaseMessageTextContent,
KnowledgeBaseRetrievalRequest,
KnowledgeRetrievalLowReasoningEffort,
)
agent_client = KnowledgeBaseRetrievalClient(
endpoint=search_endpoint,
credential=credential,
knowledge_base_name=knowledge_base_name,
)
request = KnowledgeBaseRetrievalRequest(
messages=[
KnowledgeBaseMessage(
role="user",
content=[KnowledgeBaseMessageTextContent(text="What is healthcare?")],
)
],
retrieval_reasoning_effort=KnowledgeRetrievalLowReasoningEffort(),
output_mode="answerSynthesis",
)
result = agent_client.retrieve(retrieval_request=request)
참조:KnowledgeBaseRetrievalClient, KnowledgeBaseRetrievalRequest
가져오기 요청에서 outputMode을 "answerSynthesis"(으)로 설정합니다.
### Enable answer synthesis in a retrieve request
POST {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}/retrieve?api-version=2026-11-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}
{
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "What is healthcare?"
}
]
}
],
"retrievalReasoningEffort": {
"kind": "low"
},
"outputMode": "answerSynthesis"
}
참조:지식 검색 - 가져오기
합성된 답변 가져오기
응답 합성을 사용하도록 설정하면 기술 자료는 기술 자료에서 선택적으로 지정한 지침에 따라 자연어 답변을 반환합니다. 지식 원본에 대한 인용 형식은 다음과 같습니다 [ref_id:<number>].
예를 들어 지침이 Use concise bulleted lists 있고 쿼리인 경우 응답은 What is healthcare?다음 예제와 유사해야 합니다.
{
"response": [
{
"content": [
{
"type": "text",
"text": "- Healthcare encompasses various services provided to patients and the general population ..."
}
]
}
]
}
전체 text 출력은 다음과 같습니다.
"- Healthcare encompasses various services provided to patients and the general population, including primary health services, hospital care, dental care, mental health services, and alternative health services [ref_id:1].\n- It involves the delivery of safe, effective, patient-centered care through different modalities, such as in-person encounters, shared medical appointments, and group education sessions [ref_id:0].\n- Behavioral health is a significant aspect of healthcare, focusing on the connection between behavior and overall health, including mental health and substance use [ref_id:2].\n- The healthcare system aims to ensure quality of care, access to providers, and accountability for positive outcomes while managing costs effectively [ref_id:2].\n- The global health system is evolving to address complex health needs, emphasizing the importance of cross-sectoral collaboration and addressing social determinants of health [ref_id:4]."
기술 자료의 구성에 따라 응답에는 활동 로그 및 참조 배열과 같은 다른 정보가 포함될 수 있습니다. 자세한 내용은 기술 자료 만들기를 참조하세요.
관련 콘텐츠
- 지식 베이스 만들기
- 지식 베이스 쿼리
- 빠른 시작: 에이전트 기반 검색 (응답 합성 사용)
- Python 샘플: Foundry IQ Blob 지식 소스(응답 합성 사용)