Azure Yapay Zeka Arama alıntı destekli yanıtlar için yanıt sentezi kullanma (önizleme)

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

Önemli

(önizleme) olarak işaretlenen özellikler, özellikler veya özellikler hizmet düzeyi sözleşmesi kapsamında değildir, üretim iş yükleri için önerilmez ve genel kullanıma sunulmadan önce değişebilir veya kısıtlanabilir. Azure Yapay Zeka Arama önizleme terimleri, tek başına veya genel kullanıma sunulan bir özelliğin parçası olsun, tüm önizleme işlevleri için geçerlidir.

Varsayılan olarak, Azure Yapay Zeka Arama'daki bir bilgi bankası veri ayıklama gerçekleştirir ve bu da bilgi kaynaklarınızdan ham topraklama öbekleri döndürür. Veri ayıklama, belirli bilgileri almak için kullanışlıdır, ancak karmaşık sorgular için gerekli bağlam ve mantık özelliğinden yoksundur.

Bunun yerine, sorguları doğal dilde yanıtlamak için bilgi bankanızda belirtilen LLM'yi kullanan yanıt sentezini (önizleme) etkinleştirebilirsiniz. Her yanıt, alınan kaynaklara yönelik alıntılar içerir ve madde işaretli listeler kullanma gibi sağladığınız yönergeleri izler.

Bu özelliği bir bilgi bankasında veya alma isteğinde ayarlayabilirsiniz. Bilgi bankası ayarı tüm sorgular için varsayılan ayarı oluştururken, alma isteği ayarı varsayılanı sorgu temelinde geçersiz kılar.

Kullanım desteği

Azure portalı Microsoft Foundry portalı .NET SDK Python SDK'sı Java SDK JavaScript SDK'sı REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Önkoşullar

  • LLM belirten bir bilgi tabanı içeren bir Azure Yapay Zeka Arama hizmeti.

  • Bilgi bankalarını güncelleştirme izni. Kullanıcı hesabınıza atanan Arama Hizmeti Katkıda Bulunanı rolüyle anahtarsız kimlik doğrulamasını yapılandırın (önerilir) veya bir yönetici API anahtarı kullanın.

  • LLM'ye giden çağrılar için, arama hizmetinin Microsoft Foundry kaynağında Managed Identity ve Cognitive Services Kullanıcı izinlerine sahip olması gerekmektedir.

  • En son Azure.Search.Documents önizleme paketi: dotnet add package Azure.Search.Documents --prerelease

  • Anahtarsız kimlik doğrulaması için Azure.Identity paket: dotnet add package Azure.Identity

Sınırlamalar ve Dikkat Edilecek Hususlar

  • minimal geri getirme muhakeme düzeyi, LLM işlemesini devre dışı bırakır; bu nedenle hem bilgi tabanı tanımlarında hem de geri getirme isteklerinde yanıt senteziyle uyumsuzdur. Daha fazla bilgi için bkz. Geri alma mantığını ayarlama çabası.

  • Yanıt sentezi, giriş ve çıkış belirteçlerinin sayısına göre Azure OpenAI kullandıkça öde ücretlerine tabidir. Ücretler, bilgi tabanına bağlı LLM'nin altında görünür. Daha fazla bilgi için bkz . Bölge kullanılabilirliği, sınırları ve faturalama.

Bilgi bankasında yanıt sentezi etkinleştirme

Bu bölümde, mevcut bir bilgi bankasında yanıt sentezin nasıl etkinleştirileceği gösterilmektedir. Bu yapılandırmayı yeni bilgi bankaları için kullanabilirsiniz ancak bilgi bankası oluşturma işlemi bu makalenin kapsamı dışındadır.

OutputMode tanımında "answerSynthesis" değerini KnowledgeBase olarak ayarlayın. İsteğe bağlı olarak, yanıt çıkışını özelleştirmek için ayarlayın AnswerInstructions . Aşağıdaki örnek, bilgi tabanına Use concise bulleted lists talimatını verir.

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

Başvuru:SearchIndexClient, KnowledgeBase

output_mode tanımında "answerSynthesis" değerini KnowledgeBase olarak ayarlayın. İsteğe bağlı olarak, yanıt çıkışını özelleştirmek için ayarlayın answer_instructions . Aşağıdaki örnek, bilgi tabanına Use concise bulleted lists talimatını verir.

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)

Başvuru:SearchIndexClient, KnowledgeBase

Bilgi bankası tanımında outputMode değerini "answerSynthesis" olarak ayarlayın. İsteğe bağlı olarak, yanıt çıkışını özelleştirmek için ayarlayın answerInstructions . Aşağıdaki örnek, bilgi tabanına Use concise bulleted lists talimatını verir.

### Enable answer synthesis in a knowledge base
PUT {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}?api-version=2026-08-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"
}

Başvuru:Bilgi Bankası - Oluşturma veya Güncelleştirme

Getirme isteğinde yanıt sentezini etkinleştirme

Yanıt biçimi üzerinde sorgu başına denetim için, sorgu zamanında yanıt sentezini etkinleştirebilirsiniz. Bu yaklaşım, bilgi bankasında belirtilen varsayılan çıkış modunu geçersiz kılar.

Bir OutputMode üzerinde "answerSynthesis" öğesini KnowledgeBaseRetrievalRequest olarak ayarlayın.

var client = new KnowledgeBaseRetrievalClient(
    endpoint: new Uri(searchEndpoint),
    knowledgeBaseName: knowledgeBaseName,
    credential: credential);

var request = new KnowledgeBaseRetrievalRequest();
request.Messages.Add(
    new KnowledgeBaseMessage(
        content: new[]
        {
            new KnowledgeBaseMessageTextContent("What is healthcare?")
        }) { Role = "user" });
request.OutputMode = "answerSynthesis";

var result = await client.RetrieveAsync(request);

Reference:KnowledgeBaseRetrievalClient, KnowledgeBaseRetrievalRequest

Bir output_mode üzerinde "answerSynthesis" öğesini KnowledgeBaseRetrievalRequest olarak ayarlayın.

from azure.search.documents.knowledgebases import KnowledgeBaseRetrievalClient
from azure.search.documents.knowledgebases.models import (
    KnowledgeBaseMessage,
    KnowledgeBaseMessageTextContent,
    KnowledgeBaseRetrievalRequest,
)

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?")],
        )
    ],
    output_mode="answerSynthesis",
)

result = agent_client.retrieve(retrieval_request=request)

Reference:KnowledgeBaseRetrievalClient, KnowledgeBaseRetrievalRequest

Bir alma isteğinde outputMode değerini "answerSynthesis" olarak ayarlayın.

### Enable answer synthesis in a retrieve request
POST {{search-endpoint}}/knowledgebases/{{knowledge-base-name}}/retrieve?api-version=2026-08-01-preview
Content-Type: application/json
Authorization: Bearer {{search-access-token}}

{
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "What is healthcare?"
                }
            ]
        }
    ],
    "outputMode": "answerSynthesis"
}

Referans:Bilgi Getirme - Getir

Sentezlenmiş bir yanıt alın

Yanıt sentezi etkinleştirildiğinde, bilgi bankası isteğe bağlı olarak bilgi bankasında belirttiğiniz yönergelere göre doğal dilde bir yanıt döndürür. Bilgi kaynaklarınıza yönelik alıntılar olarak [ref_id:<number>]biçimlendirilir.

Örneğin, yönergeleriniz Use concise bulleted lists ve sorgunuz ise What is healthcare?yanıt aşağıdaki örneğe benzer olmalıdır.

{
  "response": [
    {
      "content": [
        {
          "type": "text",
          "text": "- Healthcare encompasses various services provided to patients and the general population ..."
        }
      ]
    }
  ]
}

Tam text çıkış aşağıdaki gibidir:

"- 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]."

Bilgi bankanızın yapılandırmasına bağlı olarak, yanıt etkinlik günlükleri ve başvuru dizileri gibi diğer bilgileri içerebilir. Daha fazla bilgi için bkz. Bilgi bankası oluşturma.

İlgili içerik

  • Son güncelleştirme: