在 Foundry IQ(Azure AI 搜尋服務)中啟用答案合成

註

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

重要

本文中標示為(預覽)的功能或特性目前處於公開預覽狀態,並受 Microsoft Azure 預覽版補充使用條款的約束。

有關 Foundry IQ(Azure AI 搜尋服務)專屬的預覽條款,請參閱預覽功能。

預設情況下,Foundry IQ(Azure AI 搜尋服務)中的知識庫會執行資料擷取,從你的知識來源回傳基礎內容,而不會產生答案。

你也可以啟用 答案合成,利用你知識庫中設定的 LLM 來生成自然語言的答案。 你可以提供回答指示來塑造回應內容,例如請求項目符號清單。 參考文獻提供用於引用的來源 ID。

您可以在知識庫或擷取請求中設定輸出模式。 知識庫設定會為所有查詢建立預設值,而 retrieve request 設定則會依查詢逐一覆蓋預設值。

使用支援

Azure portal Microsoft Foundry 入口網站 .NET SDK Python SDK Java SDK JavaScript SDK REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

先決條件

  • 一個具備指定 LLM 的知識庫的 Foundry IQ 服務。

  • 更新知識庫的權限 設定無金鑰驗證,並將搜尋服務參與者角色指派給您的使用者帳戶(建議),或使用管理員 API 金鑰。

  • 對於對 LLM 的外撥呼叫,Foundry IQ 服務必須擁有受控識別,且該識別在 Microsoft Foundry 資源上具有 Cognitive Services User 權限。

  • 最新的 Azure.Search.Documents 預覽套件:dotnet add package Azure.Search.Documents --prerelease

  • 對於無鑰匙認證,套件如下 Azure.Identity : dotnet add package Azure.Identity

  • 2026-10-01 Search REST API 或更新版本。 範例會使用 2026-11-01-preview。

  • 對於無金鑰認證,請在Authorization每個 HTTP 請求的標頭中加入 Microsoft Entra ID 令牌。

限制與考量

  • 一般的 minimal 作業會繞過基於模型的查詢規劃,而非答案生成。 合成需另行配置模型,包括使用 minimal。 欲了解更多資訊,請參閱 設定檢索推理努力。

  • 答案合成會根據輸入與輸出代幣數量,從 Azure OpenAI 收取按需付費的費用。 費用會顯示在指派給該知識庫的大型語言模型下。 欲了解更多資訊,請參閱 區域可用性、限額及計費。

在知識庫中啟用答案合成

在現有知識庫中啟用答案生成功能。 關於建立知識庫,請參閱「建立知識庫」。

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

參考:SearchIndexClient, 知識庫

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

參考:SearchIndexClient, 知識庫

在知識庫定義中,將 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 活動。 對於模型支援的查詢規劃,請選擇 low 或 medium 代替。 提供訊息或意圖,而非兩者兼具。

其他範例

以下範例顯示等效的 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]."

根據你的知識庫設定,回應可能包含其他資訊,例如活動日誌和參考陣列。 欲了解更多資訊,請參閱 建立知識庫。