Skapa en kunskapsbas för agentiska arbetsflöden som ska användas i Azure Logic Apps (förhandsversion)

Gäller för: Azure Logic Apps (Standard)

Note

Den här förhandsgranskningsfunktionen omfattas av de kompletterande användningsvillkoren för Förhandsversioner av Microsoft Azure.

Din organisation genererar ostrukturerade data från dokument, kalkylblad, API:er och interna system. Genom att använda funktionen Kunskapsbas som en tjänst (KBaaS) i Azure Logic Apps kan du konvertera det här innehållet till en strukturerad och mer sökbar knowledge base som agentloopar i agentiska arbetsflöden kan använda för att slutföra uppgifter. En kunskapsbas är en logisk container som organiserar relaterade kunskapskällor, till exempel dokument eller filer som är relaterade till en specifik domän.

Du kan till exempel skapa en kunskapsbas som innehåller alla dokument som rör HR-principer och -procedurer. När du skapar en kunskapsbas konfigurerar KBaaS automatiskt de nödvändiga Azure Cosmos DB databaser, containrar och indexeringsprinciper. Mer information finns i Azure Cosmos DB databaser, containrar och objekt.

Den här guiden visar hur du skapar en kunskapsbas, laddar upp kunskapskällor och lägger till kunskapsbasen som ett verktyg som en agentloop kan använda i ett agentiskt standardarbetsflöde.

Skärmbilden visar Azure-portalen, Standard Logic App-resursen, det expanderade avsnittet Agenter i sidofältet med Kunskapsbas markerat och alternativet Konfigurera.

Limitations

Den här förhandsversionen har följande begränsningar:

  • Den här förhandsversionen stöder följande funktioner:

    • Uppladdade filer som källtyp för kunskapsartefakter.
    • Filer med följande format: DOC, DOCX, HTML, MD, PDF, PPT, PPTX, TXT, XLS, XLSX.
    • Textbaserad innehållsparsning i dokument, inte bilder.
    • Standardinställningar för segmentering, inte anpassad segmentering.

  • När du har skapat din kunskapsbasanslutning kan du bara redigera visningsnamnen för anslutningen och Azure OpenAI-modeller. Du kan inte redigera andra värden, till exempel autentiseringstyp eller slutpunktsinformation.

  • Endast Azure-portalen stöds för närvarande för den här funktionen.

Så här fungerar en kunskapsbas

KBaaS förenklar datatransformeringen och ger ett abstraktionslager över Azure Cosmos DB och Azure OpenAI så att dina arbetsflöden enklare kan använda, bearbeta och hämta strukturerad kunskap utan att skapa en anpassad Retrieval-Augmented Generation-pipeline (RAG).

KBaaS har följande pipelines:

  • Inmatningspipeline: När du laddar upp ett dokument eller en kunskapskälla till din kunskapsbas parsar tjänsten automatiskt, segment, sammanfattar och vektoriserar innehållet. Tjänsten lagrar sedan resultatet i Azure Cosmos DB.

  • Retrieval pipeline: När agentloopen frågar din kunskapsbas skriver tjänsten om frågan om det behövs, genererar en vektorrepresentation, utför en semantisk sökning mot Azure Cosmos DB och returnerar de mest relevanta segmenten till den stora språkmodellen (LLM) för svarsgenerering.

Förutsättningar

Authentication

KBaaS-funktionen stöder autentisering med hjälp av Microsoft Entra ID med en hanterad identitet eller en API-nyckel. Om möjligt konfigurerar och använder du en hanterad identitet för optimal och överlägsen säkerhet. Du behöver inte ange och hantera autentiseringsuppgifter, hemligheter eller åtkomstnycklar manuellt.

Om du använder en API-nyckel skyddar du känsliga och personliga data, till exempel autentiseringsuppgifter, hemligheter, åtkomstnycklar, anslutningssträngar, certifikat, tumavtryck och liknande information med högsta tillgängliga eller säkerhetsnivå som stöds. Lagra sådan information på ett säkert sätt med hjälp av Microsoft Entra ID och Azure Key Vault. Hårdkoda inte den här informationen, dela den med andra användare eller spara den i oformaterad text var som helst som andra kan komma åt. Konfigurera en plan för att rotera eller återkalla hemligheter om de skulle komprometteras.

Mer information finns i följande resurser:

1: Skapa kunskapsbasanslutningen

Om du vill skapa kunskapsbasanslutningen associerar du cosmos-databasen och Azure OpenAI-resursmodeller genom att följa dessa steg:

1a: Konfigurera Cosmos-databasanslutningen

  1. Öppna din standard-logikappresurs i Azure-portalen.

  2. I sidofältet för logikappen går du till Agenter och väljer Kunskapsbas.

  3. På sidan Kunskapsbas väljer du Konfigurera.

  4. I fönstret Konfigurera på fliken Grundläggande anger du följande information:

    Parameter Obligatoriskt Description
    Visningsnamn Ja Ett läsbart namn för din kunskapsbasanslutning. Använd samma namn som kunskapsbasen som du planerar att skapa så att hämtningsåtgärden kan associera rätt anslutning.
    Autentiseringstyp Ja Nyckelbaserad eller hanterad tjänstidentitet
    Subscription Ja Din Azure-prenumeration.
    Databas Ja Din Cosmos-databas.
    URL-slutpunkt Ja Databasvalet fyller automatiskt i det här värdet.
    Nyckel Ja Endast tillgängligt om du väljer Nyckelbaserad autentisering. Databasvalet fyller automatiskt i det här värdet.

  5. Välj Nästa när du är klar.

1b: Konfigurera Azure OpenAI-resursanslutning

  1. Ange följande information på fliken Modell :

    Parameter Obligatoriskt Description
    Autentiseringstyp Ja URL och nyckelbaserad autentisering eller hanterad tjänstidentitet
    Subscription Ja Din Azure-prenumeration.
    Azure OpenAI-resurs Ja Din Azure OpenAI-resurs.
    API-slutpunkt Ja Ditt Azure OpenAI-resursval fyller automatiskt i det här värdet.
    API-nyckel Ja Endast tillgängligt om du väljer URL och nyckelbaserad autentisering. Ditt Azure OpenAI-resursval fyller automatiskt i det här värdet.
    Modell för slutföranden Ja Ange visningsnamnet för slutförandemodellen som distribuerats för din Azure OpenAI-resurs.
    Inbäddningsmodell Ja Ange visningsnamnet för inbäddningsmodellen som distribuerats för din Azure OpenAI-resurs.

  2. När du är klar väljer du Skapa.

2: Lägga till kunskapsartefakter

När du har skapat din kunskapsbasanslutning lägger du till källinformationsfilerna som ska användas som kunskapsartefakter i din kunskapsbas.

  1. Öppna din standard-logikappresurs i Azure-portalen.

  2. I sidofältet för logikappen går du till Agenter och väljer Kunskapsbas.

  3. Om du vill skapa en grupp innan du lägger till filer går du till verktygsfältet kunskapsbassida och väljer Ny>skapa ny grupp och följer sedan anvisningarna för att skapa gruppen.

  4. På sidan Kunskapsbas väljer du Lägg till filer. Eller välj Nytt>Lägg till filer i verktygsfältet på sidan.

  5. Slutför följande uppgifter i fönstret Lägg till filer :

    1. I avsnittet Grupp anger du följande information:

      Parameter Obligatoriskt Description
      Namn Ja Namnet på den grupp som organiserar filer i din kunskapsbas. Ange ett nytt namn eller välj en befintlig grupp.
      Description No En valfri beskrivning för gruppen.

    2. I avsnittet Lägg till filer väljer du bläddra för att ladda upp eller drar och släpper filer till din grupp. Ange följande information för varje fil:

      Parameter Obligatoriskt Value Description
      Namn Ja < källnamn> Ett namn på filen som en kunskapskälla, HRPolicyDocumenttill exempel .
      Description No < källbeskrivning> En valfri beskrivning av filen som kunskapskälla.

  6. När du är klar väljer du Lägg till.

    KBaaS skapar följande Cosmos DB-containrar:

    Behållare Purpose
    KnowledgeHubs Lagrar kunskapsbasmetadata.
    KnowledgeArtifacts Lagrar källmetadata och källdokumentreferenser.
    KnowledgeArtifactChunks Lagrar heltextdokumentsegment.
    KnowledgeArtifactChunkSummaries Lagrar sammanfattade segment med vektorinbäddningar för semantisk sökning.

    KBaaS returnerar ett 202-godkänt svar med ett åtgärds-ID för att spåra uppladdningsstatusen.

    Under uppladdningsprocessen utför KBaaS åtgärder för att parsa, segmentera, sammanfatta, bädda in och lagra vektoriserat innehåll i Cosmos DB-containern. När processen är klar ändras källstatusen till Slutförd eller Misslyckad, baserat på resultatet.

  7. Övervaka uppladdningsstatusen i Azure-portalen eller med hjälp av åtgärds-ID:t.

  8. När KBaaS har slutförts fortsätter du till nästa avsnitt så att du kan lägga till kunskapsbasen som ett verktyg för agentloopen som ska användas i ditt agentiska Standard-arbetsflöde.

3: Lägg till kunskapsbasen som ett verktyg

Nu kan du lägga till kunskapsbasen i agentloopen som ska användas som ett verktyg i dina agentiska Standard-arbetsflöden. Agentloopar söker automatiskt i kunskapsbasen för att hämta semantiskt relevant information från dina uppladdade dokument.

  1. I samma standardlogikapp som innehåller din kunskapsbas öppnar du ditt agentiska arbetsflöde i designern och väljer den agentloop du vill använda.

  2. I fönstret agentinformation går du till avsnittet Kunskapsbas och väljer Skapa.

  3. I fönstret Skapa anslutning går du till listan Källor och väljer kunskapsbasen.

  4. Om du vill ladda upp fler filer till din kunskapsbas väljer du + Ladda upp.

Hantera kunskapsbaser och källor

Om du vill visa, visa och ta bort kunskapsbaser eller källor använder du Azure-portalen eller REST-API:et.

Visa en lista över alla kunskapsbaser

  1. Öppna din standard-logikappresurs i Azure-portalen.

  2. I sidofältet för logikappen går du till Agenter och väljer Kunskapsbas.

Eller gör följande REST API-anrop:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs

Visa en specifik kunskapsbas

I Azure-portalen går du till sidan Knowledge och väljer namnet på kunskapsbasen.

Eller gör följande REST API-anrop:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

Svaret innehåller kunskapsbasinformation, en lista med associerade källor och deras uppladdningsstatus.

Lista källor i en kunskapsbas

I Azure-portalen väljer du kunskapsbasen för att visa dess källor.

Eller gör följande REST API-anrop:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts

Ta bort en kunskapskälla

Den här åtgärden tar bort källmetadata, heltextsegment och vektorinbäddningar från Cosmos DB. Tjänsten returnerar ett 202-godkänt svar med ett åtgärds-ID för spårning av borttagningsframsteg.

  1. I Azure-portalen väljer du kunskapsbasen för att visa dess källor.

  2. Välj källan. Välj Ta bort i verktygsfältet.

Eller gör följande REST API-anrop:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts/{artifactName}

Ta bort en kunskapsbas

Den här åtgärden tar bort kunskapsbasen och associerade källor, segment och sammanfattningar från Cosmos DB.

  1. I Azure-portalen väljer du kunskapsbasen.

  2. Välj Ta bort i verktygsfältet.

Eller gör följande REST API-anrop:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}

Relaterat innehåll

  • Last updated on