Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Observera
Vissa funktioner för agentisk hämtning är allmänt tillgängliga i REST API-versionen 2026-04-01 via programmatisk åtkomst. Portalen Azure och Microsoft Foundry fortsätter att ge förhandsversionsåtkomst till alla funktioner för agentisk hämtning. Information om migrering, inklusive en uppdelning av vad som är allmänt tillgängligt och vad som finns kvar i förhandsversionen, finns i Migrera agentisk hämtningskod till den senaste versionen.
Om du väljer att använda en REST API-förhandsversion kan du komma åt agentiska hämtningsfunktioner som ännu inte är allmänt tillgängliga. Förhandsversionsfunktioner tillhandahålls utan serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.
En kunskapskälla anger det innehåll som används för agentisk hämtning. Det kapslar antingen in ett sökindex som fylls i av externa data, eller så är det en direkt anslutning till ett fjärrmål, till exempel Bing eller SharePoint som efterfrågas direkt. En kunskapskälla är en obligatorisk definition i en kunskapsbas.
Skapa en kunskapskälla som en resurs på den översta nivån i söktjänsten. Varje kunskapskälla pekar på exakt en datastruktur, antingen ett sökindex som uppfyller kriterierna för agentisk hämtning eller en extern resurs som stöds.
Referera till en eller flera kunskapskällor i en kunskapsbas. I en agentisk hämtningspipeline kan du köra frågor mot flera kunskapskällor i en enda begäran. Underfrågor genereras för varje kunskapskälla. De främsta resultaten returneras i hämtningssvaret.
För vissa kunskapskällor kan du använda en definition av kunskapskällan för att generera en fullständig indexeringspipeline (datakälla, kompetensuppsättning, indexerare och index) som fungerar för agentisk hämtning. I stället för att skapa flera objekt manuellt används informationen i kunskapskällan för att generera alla objekt, inklusive ett ifyllt, segmenterat och sökbart index.
Kontrollera att du har minst en kunskapskälla innan du skapar en kunskapsbas. Den fullständiga specifikationen för kunskapskällor och kunskapsbaser finns i REST API-referensen.
Arbeta med en kunskapskälla
Skapa sökväg: Skapa först en kunskapskälla och skapa sedan en kunskapsbas.
Borttagningssökväg: Uppdatera eller ta bort kunskapsbaser för att ta bort referenser till en kunskapskälla och ta sedan bort kunskapskällan sist.
En kunskapskälla, dess index och kunskapsbas måste finnas i samma söktjänst. Externt innehåll nås antingen via offentligt Internet (Bing) eller i en Microsoft klientorganisation (fjärr-SharePoint).
Kunskapskällor som stöds
Du kan skapa följande kunskapskällor:
| Typ | Indexerat eller fjärranslutet |
|---|---|
"searchIndex" API omsluter ett befintligt index. |
Indexerade |
"azureBlob" API genererar en indexerarpipeline som hämtar från en blobcontainer. |
Indexerade |
"indexedOneLake" API genererar en indexeringspipeline som hämtar från ett lakehouse. |
Indexerade |
"indexedSharePoint" API (förhandsversion) genererar en indexerarpipeline som hämtar från en SharePoint plats. |
Indexerade |
"remoteSharePoint" API (förhandsversion) hämtar innehåll direkt från SharePoint. |
Fjärr |
"web" API hämtar realtidsbaserade jordningsdata från Bing. |
Fjärr |
Indexerade kunskapskällor pekar på ett målindex på Azure AI-sökning. Frågekörning utförs lokalt för sökmotorn i din söktjänst. Nyckelord (fulltextsökning), vektor- och hybridfrågefunktioner används för att hämta data från indexerade kunskapskällor.
Du kommer åt fjärrkunskapskällor vid frågetillfället. Den agentiska hämtningsmotorn anropar de hämtnings-API:er som är inbyggda i plattformen (Bing eller SharePoint API:er).
Allt hämtat innehåll, oavsett om det är indexerat eller fjärranslutet, hämtas till rangordningspipelinen i Azure AI-sökning där det poängsätts för relevans, sammanfogas (antar flera frågor), rangordnas om och returneras i hämtningssvaret.
Skapa kunskapskällor
Skapa kunskapskällor som fristående objekt. Ange dem sedan i en kunskapsbas i en "knowledgeSources"-matris.
Om du vill skapa objekt i en söktjänst behöver du behörigheter för Search Service-deltagare. Om du använder en kunskapskälla som skapar en indexeringspipeline behöver du även behörigheter för Search Index Data Contributor för att läsa in ett index. Du kan också använda en API-administratörsnyckel i stället för roller.
Använd Azure-portalen, REST API eller ett Azure SDKs-paket för att skapa en kunskapskälla. Följande länkar innehåller instruktioner för att skapa en kunskapskälla:
- Så här skapar du en kunskapskälla för sökindex (omsluter ett befintligt index)
- Så här skapar du en blob-kunskapskälla (genererar en indexerarpipeline)
- Skapa en OneLake-kunskapskälla (genererar en indexerarpipeline)
- Skapa en SharePoint (indexerad) kunskapskälla (genererar en indexeringspipeline)
- Skapa en SharePoint (fjärransluten) kunskapsbas (frågar SharePoint direkt)
- Så här skapar du en resurs för webbkunskapskälla (ansluter till Bings offentliga slutpunkt)
När du har skapat kunskapskällan refererar du till den i en kunskapsbas.
Använda kunskapskällor
Du kan uttryckligen kontrollera användningen av kunskapskällor genom att ange alwaysQuery definitionen för kunskapskällan eller via styrinstruktioner som används under frågeplaneringen. Styrinstruktioner refererar till beskrivningar av ett index eller explicita instruktioner för hämtning i kunskapskällan som ger vägledning om när indexet ska användas. Frågeplanering sker när du använder en låg eller medelhög nivå av återhämtningsresonerande från LLM. För att minimera analysen är alla kunskapskällor som anges i kunskapsbasen aktuella för varje fråga. För låg och medelhög nivå kan kunskapsbasen och LLM vid förfrågningstillfället avgöra vilka kunskapskällor som sannolikt kommer att tillhandahålla den bästa sökkorpusen.
Logiken för val av kunskapskälla baseras på följande faktorer:
Är
alwaysQueryinställt? Om ja används kunskapskällan alltid i varje fråga.Källan för kunskapens
name.Den
descriptionav ett index, under förutsättning att en indexerad kunskapskälla.Den
retrievalInstructionssom anges i åtgärden hämta eller i kunskapsbasdefinitionen ger vägledning som innehåller eller exkluderar en kunskapskälla. Det liknar en uppmaning. Du kan ange korthet, ton och formatering som en hämtningsinstruktion.outputModepå en kunskapsbas påverkar även frågeutdata och vad som ingår i svaret.
Använda ett hämtningsskäl för att styra LLM-användningen
Inte alla lösningar drar nytta av LLM:s frågeplaneringsprocess och exekvering. Om enkelhet och hastighet överväger fördelarna med LLM-frågeplanering och kontextteknik anger du ett minimalt resonemang för att förhindra LLM-bearbetning i pipelinen.
För låg och medel är nivån på LLM-bearbetning antingen en balanserad eller maximal strategi som ökar relevansen. Mer information finns i Ange hämtningsskäl.
Observera
Om du använde attemptFastPath i föregående förhandsversion ersätts den metoden nu med retrievalReasoningEffort inställd på minimal.