Füge Fabric-Datenagenten mit Fabric IQ zu einem Foundry-Agenten hinzu (Vorschau)

Ein Fabric-Datenagent beantwortet Fragen zu Daten, die in Microsoft Fabric OneLake gespeichert sind. Ein in Microsoft Foundry eingebauter Agent kann einen Fabric-Datenagenten aufrufen, wenn er Antworten auf Basis von Unternehmensdaten in OneLake benötigt.

Dieser Artikel zeigt Ihnen, wie Sie einen Fabric-Datenagenten mit dem Fabric IQ (OneLake Catalog) Tool zu einem Foundry-Agenten hinzufügen können. Jeder Schritt findet im Microsoft Foundry Portal statt. Dasselbe kannst du auch im Code machen, wie beschrieben in Add a Data Agent, indem du Code später in diesem Artikel verwendest .

Was dir diese Integration gibt

Fabric IQ ist der Teil von Microsoft Fabric, der Ihre Daten Agenten und Anwendungen zur Verfügung stellt. Ein veröffentlichter Fabric-Datenagent ist eines der Artikel, die Fabric IQ offenlegt, und man fügt ihn einem Foundry-Agenten über den OneLake-Katalog hinzu.

Diese Methode unterscheidet sich von der früheren in drei Punkten:

• Du wählst Datenagenten aus einer Liste aus. Im Foundry-Portal zeigt der OneLake-Katalog die veröffentlichten Datenagenten, auf die Sie Zugriff haben, nach Namen. Du musst nicht zuerst eine Arbeitsbereichs-ID oder eine Artefakt-ID nachschlagen.
• Man kann mehr als einen Datenagenten hinzufügen. Ein einzelner Foundry-Agent kann mehrere Datenagenten anrufen, sodass er auf mehr als einen Bereich Ihrer Unternehmensdaten zurückgreifen kann. Die frühere Methode erlaubte nur eine.
• Jeder Datenagent ist als Endpunkt des Model Context Protocol verfügbar. Das Model Context Protocol ist ein offener Standard dafür, wie ein Agent ein Tool aufruft. Deine Fabric-Datenagenten erscheinen dem Foundry-Agenten als Werkzeuge, die er aufrufen kann, genauso wie jedes andere Werkzeug.

Für die frühere Methode, die einen einzelnen Datenagenten über Arbeitsbereichs-ID und Artefakt-ID verbindet, siehe Consume a Data Agent in Microsoft Foundry.

Voraussetzungen

• Eine kostenpflichtige Fabric-Kapazität der Stufe F2 oder höher oder eine Power BI Premium-Kapazitätseinheit (P1 oder höher) mit aktiviertem Microsoft Fabric.
• Ein Arbeitsbereich in einem Bereich, der den vollständigen Fabric-Stack unterstützt. Fabric IQ ist nicht in Regionen verfügbar, in denen Power BI die einzige Fabric-Workload ist. Weitere Informationen finden Sie unter Regionale Verfügbarkeit für Fabric.
• Cross-Geo-Verarbeitung und Cross-Geo-Speicherung für KI sind aktiviert, gemäß den in den Fabric-Datenagent-Mandanteneinstellungen erläuterten Anforderungen.
• Mindestens eine dieser Datenquellen mit Daten: ein Warehouse, ein Seehaus, ein Power BI-semantisches Modell, eine KQL-Datenbank oder eine gespiegelte Datenbank. Sie müssen über Lesezugriff auf die Datenquelle verfügen.
• Ein Foundry-Projekt mit einem bereits implementierten Modell. Informationen zum Erstellen eines Projekts finden Sie unter Erstellen eines Projekts.

Bevor Sie anfangen

Überprüfen Sie die folgenden Punkte, bevor Sie einen Fabric-Daten-Agenten zu einem Foundry-Agenten hinzufügen:

• Der Datenagent funktioniert. Bestätigen Sie, dass der Datenagent die Fragen wie erwartet in Fabric beantwortet.
• Der Datenagent wurde veröffentlicht. Im OneLake-Katalog erscheinen nur veröffentlichte Fabric-Datenagenten. Um einen solchen zu erstellen und zu veröffentlichen, siehe Create a Fabric Data Agent.
• Beide Agenten befinden sich im selben Mandanten. Der Fabric-Datenagent und der Foundry-Agent müssen sich im selben Mandanten befinden.
• Du benutzt dasselbe Konto. Melden Sie sich mit demselben Konto bei Microsoft Fabric und Microsoft Foundry an.
• Du hast die richtigen Erlaubnisse. Du brauchst mindestens Lesezugriff auf den Fabric-Datenagenten, Lesezugriff auf die zugrunde liegenden Datenquellen und die Berechtigung, Agenten in deinem Foundry-Projekt zu erstellen und zu verändern. Weitere Informationen zu Berechtigungen von Datenagenten finden Sie unter Fabric Data Agent Sharing and Permission Management.

Rollen in Microsoft Foundry

Microsoft Foundry verwendet rollenbasierte Zugriffskontrolle. Die folgende Tabelle zeigt die Rolle, die Sie für jede Aufgabe benötigen. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung für Microsoft Foundry.

So funktioniert es

1. Ein Nutzer stellt Ihrem Foundry-Agenten eine Frage.
2. Der Foundry-Agent entscheidet, ob einer seiner Fabric-Datenagenten diese Frage beantworten kann. Die Anweisungen, die du schreibst, leiten diese Entscheidung.
3. Der Foundry-Agent ruft den Fabric-Datenagenten an.
4. Der Datenagent fragt seine Datenquellen in Fabric OneLake ab und liefert eine Antwort.
5. Der Foundry-Agent verwendet diese Antwort, um dem Nutzer zu antworten.

Anfragen werden unter der für die Verbindung konfigurierten Identität ausgeführt. Für einen Fabric-Datenagenten verwendet diese Verbindung delegierte Benutzerauthentifizierung, sodass die Anfrage als angemeldeter Benutzer ausgeführt wird und Fabric die Berechtigungen dieses Benutzers anwendet. Ein Nutzer erhält nur Ergebnisse von Daten, auf die er Zugriff hat.

Schritt 1: Erstellen Sie einen Foundry-Agenten

Wenn du bereits einen Agenten hast, öffne ihn und gehe zu Schritt 2.

1. Melden Sie sich beim Microsoft Foundry-Portal an, und wählen Sie Ihr Projekt aus. Sie landen auf der Startseite .

   

2. Wählen Sie oben in der Navigation "Bauen" aus, das alle Agenten in Ihrem Projekt auflistet.

   

3. Wähle den Pfeil neben Neuer Agent und dann Agent erstellen.

   

4. Im Dialog "Einen Agenten erstellen " geben Sie einen Agentennamen ein, der beschreibt, was der Agent tut, und wählen Sie dann Erstellen.

   

Dein neuer Agent wird auf der Registerkarte Playground geöffnet. Im linken Bereich konfigurierst du den Agenten; dort gibt es Abschnitte für Modell, Anweisungen, Werkzeuge, Wissen und mehr. Das Fenster rechts ist der Chat, in dem du es testest. Die restlichen Schritte in diesem Artikel finden auf diesem Tab statt.

Schritt 2: Füge das Fabric IQ (OneLake Catalog) Tool hinzu

1. Im Bereich Werkzeuge wählen Sie Hinzufügen und dann alle Werkzeuge durchsuchen.
2. Im Dialogfeld "Ein Werkzeug auswählen" wählen Sie im Reiter "Konfiguriert" Fabric IQ (OneLake Catalog) aus.
3. Wählen Sie "Tool hinzufügen" aus.

Der OneLake-Katalog öffnet sich.

Schritt 3: Filtern Sie den Katalog auf Datenagenten

Der OneLake-Katalog listet verschiedene Arten von Fabric-Artikeln auf, also solltest du zuerst eingrenzen.

1. Wählen Sie Filter aus.
2. Unter Typ wählen Sie Data Agent aus.

Die Liste zeigt nun nur noch veröffentlichte Fabric-Datenagenten. Für jede sieht man seinen Namen, seinen Standort (den Arbeitsbereich, in dem er sich befindet), seine Empfehlung und das Sensitivitätslabel . Um die Liste weiter einzugrenzen, geben Sie einen Teil eines Namens in Filter nach Schlüsselwort ein.

Zwei Regeln bestimmen, was du in dieser Liste siehst:

• Der Datenagent muss veröffentlicht sein. Datenagenten, die noch im Entwurf sind, erscheinen nicht.
• Du musst Zugriff auf den Datenagenten haben. Wenn ein Kollege einen gebaut hat und ihn nicht mit dir geteilt hat, steht er nicht auf deiner Liste.

Schritt 4: Fügen Sie einen Datenagenten hinzu

1. In der gefilterten Liste wählen Sie den Fabric-Datenagenten aus, den Ihr Foundry-Agent verwenden soll.
2. Klicken Sie auf Hinzufügen.

Der Datenagent erscheint jetzt im Tools-Bereich Ihres Foundry-Agenten, als Fabric IQ mit dem Namen des Datenagenten in Klammern.

Schritt 5: Fügen Sie weitere Datenagenten hinzu

Du fügst Datenagenten einzeln hinzu. Um einen weiteren hinzuzufügen, wiederholen Sie Schritt 2 bis Schritt 4. Öffnen Sie den OneLake-Katalog erneut im Bereich Tools und wählen Sie den nächsten Datenagenten aus. Jedes erscheint als separater Eintrag in der Liste der Werkzeuge.

Fügen Sie für jeden Bereich Ihres Unternehmens, den der Foundry-Agent abdecken muss, einen Datenagenten hinzu. Zum Beispiel kann ein Agent Verkaufsdaten halten, ein anderer Lieferkettendaten und ein dritter Kundensupportdaten. Ihr Foundry-Agent wählt dann für jede Frage die passende aus.

Schritt 6: Schreiben Sie Anweisungen für Ihren Makler

Ihr Foundry-Agent muss wissen, wann er jeden Datenagenten einsetzen muss. Schreiben Sie diese Anleitung im Abschnitt Anleitungen .

Machen Sie präzise Angaben. Nennen Sie jeden Datenagenten und sagen Sie, welche Fragen er bearbeiten soll. Beispiel:

Nutzen Sie den Contoso Sales Data Agent für Fragen zu Umsatz, Bestellungen und Produkten. Nutzen Sie den Contoso Support Data Agent für Fragen zu Support-Tickets und Kundenbeschwerden. Wenn eine Frage beides benötigt, rufe beide auf und fasse die Ergebnisse zusammen.

Ohne klare Anweisungen ruft der Agent möglicherweise gar keinen Datenagenten an oder ruft den falschen an.

Schritt 7: Weitere Werkzeuge und Wissensquellen hinzufügen

Dieser Schritt ist optional. Neben Ihren Fabric-Datenagenten können Sie weitere Werkzeuge im Tools-Bereich hinzufügen und Wissensquellen im Knowledge-Bereich desselben Agenten hinzufügen. Füge alles andere hinzu, was der Makler für seine Arbeit braucht.

Schritt 8: Retten Sie Ihren Makler

Wählen Sie " Speichern" in der oberen rechten Ecke aus.

Schritt 9: Testen Sie Ihren Agenten

Nutze den Chat-Bereich auf der rechten Seite des Playground-Tabs , um den Agenten zu testen.

1. Senden Sie eine Frage, die einer Ihrer Datenagenten beantworten sollte, zum Beispiel Was war unser meistverkauftes Produkt letzten Monat?
2. Schau dir die Antwort an. Bestätigen Sie, dass die Daten verwendet werden, die Sie erwarten, und dass sie vom Datenagenten stammen, den Sie beabsichtigt haben.

Teste jeden Datenagenten, den du hinzugefügt hast, mit mindestens einer Frage und teste eine Frage, die mehr als eine davon benötigt. Wenn der Agent keinen Datenagenten anruft, überarbeite die in Schritt 6 geschriebenen Anweisungen, speichere und teste erneut.

Um zu sehen, was der Data Agent bei jeder Anfrage gemacht hat, einschließlich welcher Datenquellen er abgefragt hat und wie lange jeder Schritt dauerte, siehe Observability for Fabric Data Agents in Microsoft Foundry.

Langjährige Fragen

Manche Fragen brauchen für einen Data Agent länger, um beantwortet zu werden, als ein Standard-Tool-Aufruf zulässt. Damit diese Anrufe beendet werden können:

1. Wählen Sie in der Liste Model ein Modell aus, das den Hintergrundmodus unterstützt, wie etwa gpt-5.4 oder gpt-5.5.
2. Wählen Sie das Parametersymbol neben dem Modell aus, und aktivieren Sie den Hintergrundmodus.

Der Agent zeigt dann seinen Fortschritt an, während der Datenagent arbeitet, und gibt die Antwort zurück, wenn der Durchlauf abgeschlossen ist.

Fügen Sie einen Datenagenten mithilfe von Code hinzu

Die Schritte in diesem Artikel nutzen das Foundry-Portal. Dasselbe kannst du im Code mit dem Python-, C#- oder JavaScript-SDK oder mit der REST-API machen. Das Java SDK unterstützt kein Fabric IQ.

Zwei Dinge funktionieren im Code anders:

• Du stellst den Endpunkt selbst bereit. Es gibt keinen Katalog zum Durchsuchen, daher übergibst du den Model Context Protocol-Endpunkt des Datenagenten als server_url, in folgender Form:

  https://{host}/v1/mcp/workspaces/{workspaceId}/dataagents/{dataAgentId}/agent

  Hier {host} ist der Fabric-API-Host, meist api.fabric.microsoft.com. Suchen Sie im Microsoft Fabric-Portal nach {workspaceId} und {dataAgentId}: Öffnen Sie den Workspace, wählen Sie den Daten-Agenten aus, und kopieren Sie die beiden IDs aus der Adressleiste des Browsers.

• Du beziehst dich auf eine Projektverbindung. Du übergibst die Ressourcen-ID der Fabric IQ-Projektverbindung als project_connection_id. Erstelle diese Verbindung zuerst im Foundry-Portal.

Codebeispiele für die einzelnen Sprachen finden Sie unter Verbinden von Agents mit Microsoft Fabric mithilfe von Fabric IQ.

Verwandte Inhalte

• Was ist ein Fabric-Datenagent?
• Erstellen Sie einen Fabric-Datenagenten
• Teilen Sie einen Fabric-Datenagenten
• Verbrauche einen Datenagenten in Microsoft Foundry
• Beobachtbarkeit für Fabric-Datenagenten in Microsoft Foundry
• Verbinde Agenten mit Microsoft Fabric mit Fabric IQ