Een knowledge base maken voor agentische werkstromen die kunnen worden gebruikt in Azure Logic Apps (preview)

Van toepassing op: Azure Logic Apps (Standard)

Uw organisatie genereert ongestructureerde gegevens uit documenten, spreadsheets, API's en interne systemen. Met behulp van de KBaaS-functie (Knowledge Base-as-a-Service) in Azure Logic Apps kunt u deze inhoud converteren naar een gestructureerde en doorzoekbarere knowledge base die agentlussen in agentische werkstromen kunnen gebruiken om taken te voltooien. Een knowledge base is een logische container die gerelateerde kennisbronnen organiseert, zoals documenten of bestanden die zijn gerelateerd aan een specifiek domein.

U kunt bijvoorbeeld een knowledge base maken die alle documenten bevat die betrekking hebben op HR-beleid en -procedures. Wanneer u een knowledge base maakt, stelt de KBaaS automatisch de vereiste Azure Cosmos DB databases, containers en indexeringsbeleid in. Zie Azure Cosmos DB databases, containers en items voor meer informatie.

Deze handleiding laat zien hoe u een knowledge base maakt, kennisbronnen uploadt en de knowledge base toevoegt als een hulpprogramma dat een agentlus kan gebruiken in een standaardagentische werkstroom.

Limitations

Deze preview-versie heeft de volgende beperkingen:

• Deze preview ondersteunt de volgende mogelijkheden:

  • Geüploade bestanden als brontype voor kennisartefacten.
  • Bestanden met de volgende indelingen: DOC, DOCX, HTML, MD, PDF, PPT, PPTX, TXT, XLS, XLSX.
  • Op tekst gebaseerde inhoud parseren in documenten, niet afbeeldingen.
  • Standaardinstellingen voor segmentering, geen aangepaste segmentering.

• Nadat u de Knowledge Base-verbinding hebt gemaakt, kunt u alleen de weergavenamen voor de verbinding bewerken en Azure OpenAI-modellen. U kunt geen andere waarden, zoals het verificatietype of eindpuntgegevens, bewerken.

• Alleen de Azure-portal wordt momenteel ondersteund voor deze mogelijkheid.

Hoe een knowledge base werkt

KBaaS vereenvoudigt de gegevenstransformatie en biedt een abstractielaag boven Azure Cosmos DB en Azure OpenAI, zodat uw werkstromen gemakkelijker gestructureerde kennis kunnen gebruiken, verwerken en ophalen zonder een aangepaste RAG-pijplijn (Retrieval-Augmented Generation) te bouwen.

De KBaaS heeft de volgende pijplijnen:

• Opnamepijplijn: wanneer u een document of kennisbron uploadt naar uw Knowledge Base, parseert de service automatisch, segmenten, samenvattingen en vectoriseert de inhoud. De service slaat vervolgens de resultaten op in Azure Cosmos DB.

• Rerieval-pijplijn: Wanneer de agentlus query's uitvoert op uw knowledge base, herschrijft de service de query indien nodig, genereert een vectorweergave, voert een semantische zoekopdracht uit op Azure Cosmos DB en retourneert de meest relevante segmenten naar het grote taalmodel (LLM) voor het genereren van reacties.

Prerequisites

• Een Azure-account en -abonnement. Ontvang een gratis Azure-account.

• Een Azure OpenAI-resource. Zie Een Azure OpenAI Service-resource maken en implementeren voor meer informatie.

  • Uw resource heeft de volgende geïmplementeerde modellen nodig:

    • Een voltooiingsmodel, zoals gpt-4o.
    • Een embeddingmodel, zoals text-embedding-3-small.

• Een Azure Cosmos DB voor NoSQL account.

  • Voordat u uw Knowledge Base maakt, schakelt u vectorzoekopdrachten in op uw Cosmos DB-account. Deze bewerking kan maximaal 15 minuten duren voordat deze is voltooid.

    Voor meer informatie, zie:

    • Quickstart: Maak een Azure Cosmos DB voor NoSQL-account met behulp van de Azure-portal
    • Vectorzoekopdrachten in Azure Cosmos DB voor NoSQL

• Een standaard logische app en een agentische werkstroom.

  Voor meer informatie, zie:

  • Autonome agentische werkstromen maken zonder menselijke interacties in Azure Logic Apps
  • Werkstromen voor gespreksagenten maken met chatinteracties in Azure Logic Apps

Authentication

De KBaaS-functie ondersteunt verificatie met behulp van Microsoft Entra ID met een beheerde identiteit of een API-sleutel. Stel indien mogelijk een beheerde identiteit in en gebruik deze voor optimale en superieure beveiliging. U hoeft geen referenties, geheimen of toegangssleutels handmatig op te geven en te beheren.

Als u een API-sleutel gebruikt, beveilig en bescherm dan gevoelige en persoonlijke gegevens, zoals aanmeldingsgegevens, geheimen, toegangssleutels, verbindingsreeksen, certificaten, certificaatvingerafdrukken en vergelijkbare informatie, met het hoogste beschikbare of ondersteunde beveiligingsniveau. Sla dergelijke gegevens veilig op met behulp van Microsoft Entra ID en Azure Key Vault. Codeer deze informatie niet, deel deze met andere gebruikers of sla ze op in tekst zonder opmaak waar anderen toegang toe hebben. Stel een plan op om geheime sleutels te roteren of in te trekken voor het geval dat ze gecompromitteerd raken.

Zie de volgende bronnen voor meer informatie:

• Geheimenrotatie automatiseren in Azure Key Vault
• Aanbevolen procedures voor het beveiligen van geheimen
• Geheimen in Azure Key Vault

1: De Knowledge Base-verbinding maken

Volg deze stappen om de verbinding met de kennisbank te maken en uw Cosmos-database en de resourcemodellen van Azure OpenAI te koppelen:

1a: De Cosmos-databaseverbinding instellen

1. Open in de Azure portal uw standaard logische app-resource.

2. Selecteer knowledge base in de zijbalk van de logische app onder Agents.

3. Selecteer Instellen op de pagina Knowledge Base.

4. Geef in het deelvenster Instellen op het tabblad Basisinformatie de volgende informatie op:

   Parameter	Required	Description
   weergavenaam	Yes	Een door mensen leesbare naam voor uw Knowledge Base-verbinding. Gebruik dezelfde naam als de knowledge base die u wilt maken, zodat de ophaalactie de juiste verbinding kan koppelen.
   Authenticatietype	Yes	Identiteit van een beheerde service of op basis van een sleutel
   Subscription	Yes	Uw Azure-abonnement.
   Database	Yes	Uw Cosmos-database.
   URL-eindpunt	Yes	Je databasekeuze vult deze waarde automatisch in.
   Sleutel	Yes	Alleen beschikbaar als u verificatie op basis van sleutels selecteert. Je databasekeuze vult deze waarde automatisch in.

5. Wanneer u klaar bent, selecteert u Volgende.

1b: De Azure OpenAI-resourceverbinding instellen

1. Geef op het tabblad Model de volgende informatie op:

   Parameter	Required	Description
   Authenticatietype	Yes	URL en verificatie op basis van sleutels of Managed Service Identity
   Subscription	Yes	Uw Azure-abonnement.
   Azure OpenAI-resource	Yes	Uw Azure OpenAI-resource.
   API-eindpunt	Yes	Deze waarde wordt automatisch ingevuld in uw Azure OpenAI-resourceselectie.
   API-sleutel	Yes	Alleen beschikbaar als u URL en verificatie op basis van sleutels selecteert. Deze waarde wordt automatisch ingevuld in uw Azure OpenAI-resourceselectie.
   Voltooiingsmodel	Yes	Voer de weergavenaam in voor het voltooiingsmodel dat is geïmplementeerd voor uw Azure OpenAI-resource.
   Embeddingsmodel	Yes	Voer de weergavenaam in voor het insluitingsmodel dat is geïmplementeerd voor uw Azure OpenAI-resource.

2. Wanneer u klaar bent, selecteert u Maken.

2: Kennisartefacten toevoegen

Nadat u uw Knowledge Base-verbinding hebt gemaakt, voegt u de broninformatiebestanden toe die u als kennisartefacten in uw Knowledge Base wilt gebruiken.

1. Open in de Azure portal uw standaard logische app-resource.

2. Selecteer knowledge base in de zijbalk van de logische app onder Agents.

3. Als u een groep wilt maken voordat u bestanden toevoegt, selecteert u op de werkbalk van de Knowledge Base-paginaNieuwe>groep maken en volgt u de aanwijzingen om de groep te maken.

4. Selecteer Op de pagina Knowledge Basede optie Bestanden toevoegen. Of selecteer op de paginawerkbalk Nieuwe>bestanden toevoegen.

5. Voer in het deelvenster Bestanden toevoegen de volgende taken uit:

   1. Voer in de sectie Groep de volgende gegevens in:

      Parameter	Required	Description
      Naam	Yes	De naam van de groep die bestanden in uw Knowledge Base ordent. Voer een nieuwe naam in of selecteer een bestaande groep.
      Description	Nee	Een optionele beschrijving voor de groep.

   2. Selecteer in de sectie Bestanden toevoegende optie Bladeren om te uploaden of sleep en zet bestanden neer in uw groep. Voer voor elk bestand de volgende gegevens in:

      Parameter	Required	Waarde	Description
      Naam	Yes	< bronnaam>	Een naam voor het bestand als kennisbron, bijvoorbeeld HRPolicyDocument.
      Description	Nee	< bronbeschrijving>	Een optionele beschrijving voor het bestand als kennisbron.

6. Wanneer u klaar bent, selecteert u Toevoegen.

   De KBaaS maakt de volgende Cosmos DB-containers:

   Container	Purpose
   KnowledgeHubs	Slaat metagegevens van knowledge base op.
   KnowledgeArtifacts	Slaat bronmetagegevens en brondocumentverwijzingen op.
   KnowledgeArtifactChunks	Slaat segmenten van document met volledige tekst op.
   KnowledgeArtifactChunkSummaries	Slaat samengevatte segmenten op met vector insluitingen voor semantische zoekopdrachten.

   De KBaaS retourneert een 202 geaccepteerd antwoord met een bewerkings-id voor het bijhouden van de voortgang van de upload.

   Tijdens het uploadproces voert de KBaaS bewerkingen uit om gevectoriseerde inhoud in de Cosmos DB-container te parseren, segmenteren, samenvatten, insluiten en opslaan. Wanneer het proces is voltooid, wordt de bronstatus gewijzigd in Voltooid of Mislukt, op basis van het resultaat.

7. Controleer de uploadstatus in de Azure-portal of met behulp van de bewerkings-id.

8. Nadat KBaaS is voltooid, gaat u verder met de volgende sectie, zodat u de Knowledge Base kunt toevoegen als een hulpprogramma voor uw agentlus voor gebruik in uw agentische standaardwerkstroom.

3: De Knowledge Base toevoegen als een hulpprogramma

U kunt nu de Knowledge Base toevoegen aan uw agentlus om te gebruiken als een hulpprogramma in uw standaardwerkstromen voor agents. Agentlussen voeren automatisch een query uit op de Knowledge Base om semantisch relevante informatie op te halen uit uw geüploade documenten.

1. Open in dezelfde standaard logische app die uw Knowledge Base bevat, in de ontwerpfunctie uw agentische werkstroom en selecteer de gewenste agentlus.

2. Selecteer Maken in het informatievenster van de agent in de sectie Knowledge Base.

3. Selecteer in het deelvenster Verbinding maken in de lijst Bronnen de kennisbank.

4. Als u meer bestanden wilt uploaden naar uw Knowledge Base, selecteert u + Uploaden.

Kennisbanken en bronnen beheren

Als u knowledgebases of bronnen wilt opsommen, weergeven en verwijderen, gebruikt u de Azure-portal of de REST API.

Alle knowledge bases weergeven

1. Open in de Azure portal uw standaard logische app-resource.

2. Selecteer knowledge base in de zijbalk van de logische app onder Agents.

Of voer de volgende REST API-aanroep uit:

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

Een specifieke Knowledge Base weergeven

Selecteer in de Azure-portal op de pagina Knowledge base de naam van de Knowledge Base.

Of voer de volgende REST API-aanroep uit:

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

Het antwoord bevat de knowledge base-informatie, een lijst met de bijbehorende bronnen en de uploadstatus.

Bronnen in een knowledge base weergeven

Selecteer in de Azure-portal de knowledge base om de bijbehorende bronnen weer te geven.

Of voer de volgende REST API-aanroep uit:

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

Een kennisbron verwijderen

Met deze bewerking worden de bronmetagegevens, segmenten in volledige tekst en vector-insluitingen uit Cosmos DB verwijderd. De service retourneert een 202 Geaccepteerd antwoord met een bewerkings-id voor het bijhouden van de voortgang van het verwijderen.

1. Selecteer in de Azure-portal de knowledge base om de bijbehorende bronnen weer te geven.

2. Selecteer de bron. Selecteer Verwijderen op de werkbalk.

Of voer de volgende REST API-aanroep uit:

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

Een knowledge base verwijderen

Met deze bewerking worden de knowledge base en bijbehorende bronnen, segmenten en samenvattingen uit Cosmos DB verwijderd.

1. Selecteer de knowledgebase in de Azure-portal.

2. Selecteer Verwijderen op de werkbalk.

Of voer de volgende REST API-aanroep uit:

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

Verwante inhoud

• Wat is Azure Logic Apps?
• Azure OpenAI Service
• Azure Cosmos DB Vector Search
• Geïntegreerd vectorarchief - Azure Cosmos DB voor NoSQL