Erstellen einer Wissensbasis für agentische Workflows, die in Azure Logic Apps verwendet werden sollen (Vorschau)

Gilt für: Azure Logic Apps (Standard)

Note

Dieses Vorschaufeature unterliegt den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.

Ihre Organisation generiert unstrukturierte Daten aus Dokumenten, Kalkulationstabellen, APIs und internen Systemen. Mithilfe der Knowledge Base-as-a-Service-Funktion (KBaaS) in Azure Logic Apps können Sie diesen Inhalt in eine strukturierte und durchsuchbare knowledge Base konvertieren, die Agentschleifen in agentischen Workflows zum Ausführen von Aufgaben verwenden kann. Eine Wissensdatenbank ist ein logischer Container , der verwandte Wissensquellen wie Dokumente oder Dateien im Zusammenhang mit einer bestimmten Domäne organisiert.

Sie können z. B. eine Wissensdatenbank erstellen, die alle Dokumente enthält, die sich auf Personalrichtlinien und -verfahren beziehen. Wenn Sie eine Wissensdatenbank erstellen, richtet das KBaaS automatisch die erforderlichen Azure Cosmos DB Datenbanken, Container und Indizierungsrichtlinien ein. Weitere Informationen finden Sie unter Azure Cosmos DB Datenbanken, Container und Elemente.

In diesem Leitfaden wird gezeigt, wie Sie eine Wissensbasis erstellen, Wissensquellen hochladen und die Wissensbasis als Tool hinzufügen, das eine Agentschleife in einem agentischen Standardworkflow verwenden kann.

Der Screenshot zeigt das Azure-Portal, die Standard-Logik-App-Ressource, den erweiterten Seitenleistenabschnitt „Agents“ mit ausgewählter Wissensdatenbank sowie die Option „Einrichten“.

Einschränkungen

Diese Vorschauversion hat die folgenden Einschränkungen:

  • Diese Vorschau unterstützt die folgenden Funktionen:

    • Hochgeladene Dateien als Quelltyp für Wissensartefakte.
    • Dateien mit den folgenden Formaten: DOCX, HTML, MD, PDF, PPT, PPT, PPTX, TXT, XLS, XLSX.
    • Textbasierte Inhaltsanalyse in Dokumenten, nicht Bilder.
    • Standardeinstellungen für das Chunking, nicht benutzerdefiniertes Chunking.

  • Nachdem Sie Ihre Knowledge Base-Verbindung erstellt haben, können Sie nur die Anzeigenamen für die Verbindung und Azure OpenAI-Modelle bearbeiten. Sie können keine anderen Werte wie den Authentifizierungstyp oder die Endpunktinformationen bearbeiten.

  • Für diese Funktion wird derzeit nur das Azure-Portal unterstützt.

Funktionsweise einer Wissensdatenbank

KBaaS vereinfacht die Datentransformation und bietet eine Abstraktionsebene über Azure Cosmos DB und Azure OpenAI, sodass Ihre Workflows strukturiertes Wissen einfacher nutzen, verarbeiten und abrufen können, ohne eine benutzerdefinierte Retrieval-Augmented Generation (RAG)-Pipeline zu erstellen.

Die KBaaS verfügt über die folgenden Pipelines:

  • Aufnahmepipeline: Wenn Sie ein Dokument oder eine Wissensquelle in Ihre Knowledge Base hochladen, analysiert der Dienst den Inhalt automatisch, Blöcke, fasst zusammen und vektorisiert den Inhalt. Der Dienst speichert dann die Ergebnisse in Azure Cosmos DB.

  • Retrieval-Pipeline: Wenn die Agentschleife Ihre Wissensbasis abfragt, schreibt der Dienst die Abfrage bei Bedarf neu, generiert eine Vektordarstellung, führt eine semantische Suche für Azure Cosmos DB aus und gibt die relevantesten Blöcke für das große Sprachmodell (LLM) für die Antwortgenerierung zurück.

Voraussetzungen

Authentication

Die KBaaS-Funktion unterstützt die Authentifizierung mithilfe von Microsoft Entra ID mit einer managed Identity oder einem API-Schlüssel. Richten Sie nach Möglichkeit eine verwaltete Identität ein, und verwenden Sie sie für optimale und überlegene Sicherheit. Sie müssen keine Anmeldeinformationen, geheimen Schlüssel oder Zugriffstasten manuell bereitstellen und verwalten.

Wenn Sie einen API-Schlüssel verwenden, sichern und schützen Sie vertrauliche und personenbezogene Daten wie Anmeldeinformationen, Geheimnisse, Zugriffsschlüssel, Verbindungszeichenfolgen, Zertifikate, Fingerabdrücke und ähnliche Informationen mit der höchsten verfügbaren oder unterstützten Sicherheitsstufe. Speichern Sie diese Informationen sicher mithilfe von Microsoft Entra ID und Azure Key Vault. Codieren Sie diese Informationen nicht, teilen Sie sie mit anderen Benutzern, oder speichern Sie sie an einer beliebigen Stelle, auf die andere Personen zugreifen können. Erstellen Sie einen Plan, um Geheimnisse zu rotieren oder zurückzuziehen, falls sie kompromittiert werden.

Weitere Informationen finden Sie in den folgenden Ressourcen:

1: Erstellen der Knowledge Base-Verbindung

Um die Knowledge Base-Verbindung zu erstellen, ordnen Sie Ihre Cosmos-Datenbank und Azure OpenAI-Ressourcenmodelle zu, indem Sie die folgenden Schritte ausführen:

1a: Einrichten der Cosmos-Datenbankverbindung

  1. Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.

  2. Wählen Sie auf der Randleiste der Logik-App unter "Agents" die Knowledge Base aus.

  3. Wählen Sie auf der Wissensbasisseite"Einrichten" aus.

  4. Geben Sie im Bereich "Einrichten " auf der Registerkarte " Grundlagen " die folgenden Informationen an:

    Parameter Required Description
    Anzeigename Ja Ein lesbarer Name für Ihre Wissensbasisverbindung. Verwenden Sie denselben Namen wie die Knowledge Base, die Sie erstellen möchten, damit die Abrufaktion die richtige Verbindung zuordnen kann.
    Authentifizierungstyp Ja Schlüsselbasierte oder verwaltete Dienstidentität
    Subscription Ja Ihr Azure-Abonnement.
    Datenbank Ja Ihre Cosmos-Datenbank.
    URL-Endpunkt Ja Ihre Datenbankauswahl füllt diesen Wert automatisch auf.
    Schlüssel Ja Nur verfügbar, wenn Sie die schlüsselbasierte Authentifizierung auswählen. Ihre Datenbankauswahl füllt diesen Wert automatisch auf.

  5. Klicken Sie abschließend auf Weiter.

1b: Einrichten der Azure OpenAI-Ressourcenverbindung

  1. Geben Sie auf der Registerkarte "Modell " die folgenden Informationen an:

    Parameter Required Description
    Authentifizierungstyp Ja URL und schlüsselbasierte Authentifizierung oder verwaltete Dienstidentität
    Subscription Ja Ihr Azure-Abonnement.
    Azure OpenAI-Ressource Ja Ihre Azure OpenAI-Ressource.
    API-Endpunkt Ja Ihre Azure OpenAI-Ressourcenauswahl füllt diesen Wert automatisch auf.
    API-Schlüssel Ja Nur verfügbar, wenn Sie DIE URL und die schlüsselbasierte Authentifizierung auswählen. Ihre Azure OpenAI-Ressourcenauswahl füllt diesen Wert automatisch auf.
    Abschlussmodell Ja Geben Sie den Anzeigenamen für das Abschlussmodell ein, das für Ihre Azure OpenAI-Ressource bereitgestellt wurde.
    Einbettungsmodell Ja Geben Sie den Anzeigenamen für das Einbettungsmodell ein, das für Ihre Azure OpenAI-Ressource bereitgestellt wurde.

  2. Wenn Sie fertig sind, wählen Sie Erstellen aus.

2: Hinzufügen von Wissensartefakten

Nachdem Sie Ihre Knowledge Base-Verbindung erstellt haben, fügen Sie die Quellinformationsdateien hinzu, die als Wissensartefakte in Ihrer Wissensdatenbank verwendet werden sollen.

  1. Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.

  2. Wählen Sie auf der Randleiste der Logik-App unter "Agents" die Knowledge Base aus.

  3. Wenn Sie eine Gruppe erstellen möchten, bevor Sie Dateien hinzufügen, wählen Sie auf der Symbolleiste der Knowledge Base-Seite "Neue Gruppe erstellen"> aus, und folgen Sie dann den Anweisungen zum Erstellen der Gruppe.

  4. Wählen Sie auf der Knowledge Base-Seite " Dateien hinzufügen" aus. Oder wählen Sie auf der Seitensymbolleiste "Neue>" aus.

  5. Führen Sie im Bereich "Dateien hinzufügen " die folgenden Aufgaben aus:

    1. Geben Sie im Abschnitt "Gruppe " die folgenden Informationen ein:

      Parameter Required Description
      Name Ja Der Name der Gruppe, die Dateien in Ihrer Wissensdatenbank organisiert. Geben Sie einen neuen Namen ein, oder wählen Sie eine vorhandene Gruppe aus.
      Beschreibung No Eine optionale Beschreibung für die Gruppe.

    2. Wählen Sie im Abschnitt " Dateien hinzufügen " die Option "Zum Hochladen durchsuchen" aus, oder ziehen Sie Dateien in Ihre Gruppe. Geben Sie für jede Datei die folgenden Informationen ein:

      Parameter Required Wert Description
      Name Ja < Quellname> Ein Name für die Datei als Wissensquelle, HRPolicyDocumentz. B. .
      Beschreibung No < Quellbeschreibung> Eine optionale Beschreibung für die Datei als Wissensquelle.

  6. Wenn Sie fertig sind, wählen Sie "Hinzufügen" aus.

    Die KBaaS erstellt die folgenden Cosmos DB-Container:

    Container Purpose
    KnowledgeHubs Speichert Knowledge Base-Metadaten.
    KnowledgeArtifacts Speichert Quellmetadaten und Quelldokumentverweise.
    KnowledgeArtifactChunks Speichert Volltextdokumentabschnitte.
    KnowledgeArtifactChunkSummaries Speichert zusammengefasste Blöcke mit Vektoreinbettungen für die semantische Suche.

    Der KBaaS gibt eine 202 akzeptierte Antwort mit einer Vorgangs-ID zum Nachverfolgen des Uploadfortschritts zurück.

    Während des Uploadvorgangs führt KBaaS Vorgänge durch, um Inhalte zu parsen, in Blöcke aufzuteilen, zusammenzufassen, einzubetten und als Vektoren im Cosmos DB-Container zu speichern. Wenn der Prozess abgeschlossen ist, ändert sich der Quellstatus basierend auf dem Ergebnis in "Abgeschlossen " oder "Fehlgeschlagen".

  7. Überwachen Sie den Uploadstatus im Azure Portal oder mithilfe der Vorgangs-ID.

  8. Nachdem KBaaS abgeschlossen ist, fahren Sie mit dem nächsten Abschnitt fort, damit Sie die Wissensbasis als Tool für Ihre Agentschleife hinzufügen können, um sie in Ihrem agentic Standard-Workflow zu verwenden.

3: Hinzufügen der Wissensbasis als Tool

Sie können Ihrer Agent-Schleife jetzt die Wissensdatenbank hinzufügen, um diese in Ihren agentischen Standard-Workflows als Werkzeug zu verwenden. Agent-Schleifen fragen automatisch die Wissensbasis ab, um semantisch relevante Informationen aus Ihren hochgeladenen Dokumenten abzurufen.

  1. Öffnen Sie in derselben Standardlogik-App, die Ihre Knowledge Base enthält, im Designer Ihren agentischen Workflow, und wählen Sie die gewünschte Agentschleife aus.

  2. Wählen Sie im Agentinformationsbereich im Abschnitt Wissensdatenbank die Option „Erstellen“ aus.

  3. Wählen Sie im Bereich "Verbindung erstellen " in der Liste " Quellen " die Wissensbasis aus.

  4. Wenn Sie weitere Dateien in Ihre Knowledge Base hochladen möchten, wählen Sie +Hochladen aus.

Verwalten von Wissensdatenbanken und Quellen

Verwenden Sie zum Auflisten, Anzeigen und Löschen von Wissensdatenbanken oder Quellen das Azure Portal oder die REST-API.

Alle Wissensdatenbanken auflisten

  1. Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.

  2. Wählen Sie auf der Randleiste der Logik-App unter "Agents" die Knowledge Base aus.

Oder führen Sie den folgenden REST-API-Aufruf aus:

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

Eine bestimmte Wissensdatenbank anzeigen

Wählen Sie im Azure-Portal auf der Seite Knowledge base den Knowledge Base-Namen aus.

Oder führen Sie den folgenden REST-API-Aufruf aus:

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

Die Antwort enthält die Wissensbasisinformationen, eine Liste mit den zugehörigen Quellen und deren Uploadstatus.

Auflisten von Quellen in einer Wissensbasis

Wählen Sie im Azure Portal die Wissensbasis aus, um die zugehörigen Quellen anzuzeigen.

Oder führen Sie den folgenden REST-API-Aufruf aus:

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

Löschen einer Wissensquelle

Mit diesem Vorgang werden die Quellmetadaten, Volltextblöcke und Vektoreinbettungen aus Cosmos DB entfernt. Der Dienst gibt eine 202 Akzeptierte Antwort mit einer Vorgangs-ID zum Nachverfolgen des Löschfortschritts zurück.

  1. Wählen Sie im Azure Portal die Wissensbasis aus, um die zugehörigen Quellen anzuzeigen.

  2. Wählen Sie die Quelle aus. Wählen Sie auf der Symbolleiste Löschen aus.

Oder führen Sie den folgenden REST-API-Aufruf aus:

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

Löschen einer Wissensbasis

Mit diesem Vorgang werden die Wissensbasis und die zugehörigen Quellen, Blöcke und Zusammenfassungen aus Cosmos DB entfernt.

  1. Wählen Sie im Azure-Portal die Wissensbasis aus.

  2. Wählen Sie auf der Symbolleiste Löschen aus.

Oder führen Sie den folgenden REST-API-Aufruf aus:

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

Verwandte Inhalte

  • Last updated on