Antwoordsynthese gebruiken voor antwoorden met bronvermeldingen in Azure AI Zoeken (preview)

Opmerking

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

Belangrijk

Functies, mogelijkheden of eigenschappen die zijn gemarkeerd (preview) vallen niet onder een service level agreement, worden niet aanbevolen voor productieworkloads en kunnen worden gewijzigd of beperkt voordat ze algemeen beschikbaar worden. De Azure AI Zoeken preview-voorwaarden zijn van toepassing op alle preview-functionaliteit, ongeacht of deze zelfstandig is of deel uitmaakt van een algemeen beschikbare functie.

Standaard voert een knowledge base in Azure AI Zoeken gegevensextractie uit, waardoor onbewerkte grondsegmenten uit uw kennisbronnen worden geretourneerd. Gegevensextractie is handig voor het ophalen van specifieke informatie, maar ontbreekt aan de context en redenering die nodig is voor complexe query's.

U kunt in plaats daarvan antwoordsynthese (preview) inschakelen, die gebruikmaakt van de LLM die is opgegeven in uw Knowledge Base om query's in natuurlijke taal te beantwoorden. Elk antwoord bevat bronvermeldingen voor de opgehaalde bronnen en volgt alle instructies die u opgeeft, zoals het gebruik van lijsten met opsommingstekens.

U kunt deze eigenschap instellen in een kennisbank of een ophaalverzoek. De instelling voor de Knowledge Base bepaalt de standaardinstelling voor alle query's, terwijl de instelling voor het ophaalverzoek deze standaardwaarde per query overschrijft.

Gebruiksondersteuning

Azure-portal Microsoft Foundry-portal .NET SDK Python SDK Java SDK JavaScript SDK REST API
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Voorwaarden

  • Een Azure AI Zoeken-service met een knowledge base waarmee een LLM wordt opgegeven.

  • Machtiging om knowledge bases bij te werken. Configureer sleutelloze verificatie met de rol Inzender voor zoekservice die is toegewezen aan uw gebruikersaccount (aanbevolen) of gebruik een beheer-API-sleutel.

  • Voor uitgaande aanroepen naar de LLM moet de zoekservice beschikken over een beheerde identiteit met Cognitive Services User machtigingen op de Microsoft Foundry-resource.

  • Het nieuwste preview-pakket Azure.Search.Documents: dotnet add package Azure.Search.Documents --prerelease

  • Voor sleutelloze verificatie is het Azure.Identity pakket: dotnet add package Azure.Identity

  • Het nieuwste preview-pakket azure-search-documents: pip install --pre azure-search-documents

  • Voor sleutelloze verificatie is het azure-identity pakket: pip install azure-identity

Beperkingen en overwegingen

  • De inspanning voor minimal retrieval reasoning schakelt LLM-verwerking uit, waardoor dit niet compatibel is met antwoordsynthese in zowel kennisbankdefinities als retrieve-aanvragen. Zie voor meer informatie De inspanning voor het ophalen van redeneringsvermogen instellen.

  • Voor antwoordsynthese worden kosten in rekening gebracht voor betalen per gebruik van Azure OpenAI, die zijn gebaseerd op het aantal invoer- en uitvoertokens. Kosten worden weergegeven onder de LLM die is toegewezen aan de Knowledge Base. Zie beschikbaarheid, limieten en facturering voor regio's voor meer informatie.

Antwoordsynthese inschakelen in een Knowledge Base

In deze sectie ziet u hoe u antwoordsynthese kunt inschakelen in een bestaande knowledge base. Hoewel u deze configuratie voor nieuwe knowledge bases kunt gebruiken, valt het maken van knowledge base buiten het bereik van dit artikel.

Stel OutputMode in op "answerSynthesis" in de definitie van KnowledgeBase. U kunt desgewenst AnswerInstructions instellen om de antwoorduitvoer aan te passen. In het volgende voorbeeld wordt de kennisbank opgedragen om Use concise bulleted lists.

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

Naslaginformatie:SearchIndexClient, KnowledgeBase

Stel output_mode in op "answerSynthesis" in de definitie van KnowledgeBase. U kunt desgewenst answer_instructions instellen om de antwoorduitvoer aan te passen. In het volgende voorbeeld wordt de kennisbank opgedragen om 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)

Naslaginformatie:SearchIndexClient, KnowledgeBase

Stel outputMode in op "answerSynthesis" in de definitie van de kennisbank. U kunt desgewenst answerInstructions instellen om de antwoorduitvoer aan te passen. In het volgende voorbeeld wordt de kennisbank opgedragen om Use concise bulleted lists.

### 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"
}

Referentie:Kennisbank - maken of bijwerken

Antwoordsynthese inschakelen in een ophaalaanvraag

Voor controle per query over de antwoordindeling kunt u antwoordsynthese inschakelen tijdens het uitvoeren van query's. Deze methode overschrijft de standaarduitvoermodus die is opgegeven in de Knowledge Base.

Stel OutputMode op "answerSynthesis" in op een KnowledgeBaseRetrievalRequest.

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

Naslaginformatie:KnowledgeBaseRetrievalClient, KnowledgeBaseRetrievalRequest

Stel output_mode op "answerSynthesis" in op een KnowledgeBaseRetrievalRequest.

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)

Naslaginformatie:KnowledgeBaseRetrievalClient, KnowledgeBaseRetrievalRequest

Stel outputMode in op "answerSynthesis" voor een ophaalverzoek.

### 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"
}

Naslaginformatie:Kennis ophalen - Ophalen

Een gesynthetiseerd antwoord ophalen

Wanneer antwoordsynthese is ingeschakeld, retourneert de knowledge base een antwoord in natuurlijke taal op basis van de instructies die u optioneel hebt opgegeven in de knowledge base. Bronvermeldingen in uw kennisbronnen worden opgemaakt als [ref_id:<number>].

Als uw instructies bijvoorbeeld zijn Use concise bulleted lists en uw query is What is healthcare?, moet het antwoord vergelijkbaar zijn met het volgende voorbeeld.

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

De volledige text uitvoer is als volgt:

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

Afhankelijk van de configuratie van uw Knowledge Base kan het antwoord andere informatie bevatten, zoals activiteitenlogboeken en referentiematrices. Zie Een knowledge base maken voor meer informatie.

Verwante inhoud

  • Laatst bijgewerkt om