Freigeben über


Fabric Daten-Agent-Freigabe und Berechtigungsverwaltung

Voraussetzungen

Veröffentlichung und Versionsverwaltung

Die Erstellung eines Daten-Agents in Microsoft Fabric ist ein iterativer Prozess. Es umfasst die Verfeinerung verschiedener Konfigurationen, z. B.:

  • Auswählen relevanter Tabellen
  • Anweisungen für Fabric-Datenagenten definieren
  • Erstellen von Beispielabfragen für jede Datenquelle

Wenn Sie Anpassungen vornehmen, um die Leistung des Fabric Daten-Agents zu verbessern, können Sie diesen Fabric Daten-Agent schließlich veröffentlichen. Nach der Veröffentlichung wird eine schreibgeschützte Version generiert, die Sie für andere Personen freigeben können.

Wenn Sie versuchen, den Fabric Daten-Agent zu veröffentlichen, können Sie eine Beschreibung einfügen, die erläutert, was der Fabric Daten-Agent tut. Die Beschreibung steht Verbrauchern des Fabric Datenagenten zur Verfügung, um ihnen zu helfen, ihren Zweck und ihre Funktionalität zu verstehen. Andere automatisierte Systeme und Orchestratoren können auch die Beschreibung verwenden, um den Fabric Datenagent außerhalb von Microsoft Fabric aufzurufen.

Hinweis

Sie können den Fabric Datenagent bitten, zu beschreiben, was er tut. Anschließend können Sie die Antwort verfeinern und zusammenfassen, die beim Veröffentlichen als Beschreibung verwendet werden soll.

Screenshot der Erstellung einer Beschreibung für einen Fabric-Datenagenten.

Nachdem Sie Ihren Fabric Daten-Agent veröffentlicht haben, können Sie die aktuelle Entwurfsversion weiter verfeinern, um die Leistung zu verbessern, ohne die veröffentlichte Version zu beeinträchtigen, die andere Personen verwenden. Auf diese Weise können Sie darauf vertrauen, dass Ihre Änderungen von der veröffentlichten Version isoliert bleiben. Sie können nahtlos zwischen der veröffentlichten Version und der Entwurfsversion wechseln, indem Sie denselben Satz von Abfragen auf beiden testen, um ihre Leistung zu vergleichen. Auf diese Weise können Sie die Auswirkungen Ihrer Änderungen bewerten und wertvolle Einblicke gewinnen, wie sie die Effektivität Ihres Fabric Datenagenten verbessern. Der folgende Screenshot zeigt, wie Sie zwischen veröffentlichten und entwickelten Fabric-Daten-Agent-Versionen wechseln:

Screenshot, in dem gezeigt wird, wie sie zwischen veröffentlichten und Entwicklungsversionen Fabric Data Agent-Versionen wechseln.

Um die Beschreibung des Fabric Daten-Agents zu aktualisieren, ohne andere Änderungen vorzunehmen, navigieren Sie zu Settings, wählen Sie Publishing aus, und aktualisieren Sie dann die Beschreibung, wie in diesem Screenshot gezeigt:

Screenshot, in dem gezeigt wird, wie die Beschreibung des Fabric Data Agent aktualisiert wird.

Freigabeberechtigungsmodelle und erforderlicher Quellzugriff

Mit der Funktion Freigabe von Fabric-Datenagenten können Sie Ihre Fabric-Datenagenten mit anderen Personen teilen und dabei eine Vielzahl von Berechtigungsmodellen nutzen, wie im folgenden Screenshot zu sehen ist:

Screenshot, in dem gezeigt wird, wie Sie eine Fabric Daten-Agent-Verknüpfung freigeben.

Sie haben die vollständige Kontrolle über den Zugriff auf Ihren Fabric Datenagenten und die vollständige Kontrolle über die Verwendung. Darüber hinaus müssen Sie beim Freigeben des Fabric-Daten-Agents auch den Zugriff auf die zugrunde liegenden Daten freigeben, die sie verwendet. Der Fabric-Datenagent berücksichtigt alle Benutzerberechtigungen für die Daten, einschließlich Row-Level Security (RLS) und Column-Level Security (CLS). Für Power BI semantischen Modelle, auf die über einen Fabric Daten-Agent zugegriffen wird, benötigen Benutzer nur Leseberechtigungen für das Modell. Der Arbeitsbereichszugriff ist nicht erforderlich. RLS und CLS werden weiterhin angewendet.

Zugrunde liegende Datenquellenberechtigungen

Damit ein Benutzer erfolgreich über einen Fabric-Daten-Agenten Abfragen durchführen kann, benötigt er die im Folgenden aufgeführten wirksamen Mindestberechtigungen für jeden verbundenen Datenquellentyp. Wenn sie weniger als die aufgelistete Berechtigung haben, schlagen Abfragen fehl oder geben leere Ergebnisse zurück.

Datenquellentyp Mindestberechtigung zum Abfragen über den Daten-Agent Hinweise
Power BI Semantikmodell Lesen Sie Lesevorgänge reichen aus, um ein semantisches Modell über einen Fabric-Daten-Agenten abzufragen. Build/Write ist nur erforderlich, um das Modell zu ändern oder Funktionen wie Prep für KI zu verwenden. Der Arbeitsbereichszugriff ist für die Interaktion über einen Daten-Agent nicht erforderlich.
Lakehouse Lesezugriff auf Lakehouse-Elemente (und Tabellenzugriff, falls erforderlich) Schreibvorgang nicht erforderlich, es sei denn, Daten werden geändert.
Lagerhalle Lesen (SELECT aus relevanten Tabellen) Höhere Berechtigungen nur für DML/DDL-Vorgänge.
KQL-Datenbank Leserrolle in der Datenbank Höhere Rollen nur für Verwaltungsbefehle.
Ontologie Lesen Sie das Ontologie-Element und lesen Sie das zugrunde liegende semantische Modell, Lakehouse oder die KQL-Datenbank, die mit der Ontologie verbunden ist.
Andere unterstützte Quellen Zugriff auf Abfrage-/Leseebene Muss Metadaten + Datenabruf zulassen.

Wichtig

Leseberechtigung für das semantische Modell reicht für Abfragen aus, die über einen Fabric-Daten-Agent initiiert werden. Build- oder Arbeitsbereichsrollen sind für diese Agentinteraktionen nicht erforderlich. Build/Write ist weiterhin für Modelländerungen oder Features erforderlich, die das Modell ändern (z. B. Vorbereiten für KI).

Folgen Sie den geringsten Berechtigungen: Erteilen Sie nur die erforderlichen Datenquellenberechtigungen. Erteilen Sie für semantische Modelle Lesezugriff, wenn Benutzer nur eine Abfrage über einen Daten-Agent durchführen müssen. Gewähren Sie Erstellungs- oder andere umfassendere Arbeitsbereichsrollen nur, wenn Benutzer das Modell ändern oder Funktionen wie Vorbereiten für KI verwenden müssen.

Hinweis

Diese Berechtigungsänderung gilt nur für Interaktionen über Fabric Daten-Agents. Andere Einstiegspunkte (z. B. "In Excel analysieren" oder "Direkte Berichtsautorschaft") erfordern möglicherweise weiterhin die Berechtigung "Build".

Wenn ein Benutzer den Fabric Daten-Agent öffnen kann, aber nicht die Mindestberechtigung für eine oder mehrere zugrunde liegende Quellen aufweist, schlagen Abfragen, die diese Quellen berühren, mit einem Autorisierungsfehler fehl oder geben leere Ergebnisse zurück, je nach Sicherheitsmodell der Quelle.

  • Keine Berechtigung ausgewählt: Wenn Sie keine andere Berechtigung auswählen, können Benutzer nur die veröffentlichte Version des Fabric Daten-Agents abfragen. Sie haben keinen Zugriff, um Konfigurationen oder Details zu bearbeiten oder sogar anzuzeigen. Dadurch wird die Integrität Ihrer Fabric-Daten-Agent-Einrichtung beibehalten.
  • Ansichtsdetails: Benutzer können die Details und Konfigurationen der veröffentlichten und Entwurfsversionen des Fabric Daten-Agents anzeigen, aber keine Änderungen daran vornehmen. Sie können jedoch weiterhin den Fabric-Daten-Agent abfragen und informative Einblicke erstellen, ohne das Risiko unbeabsichtigter Änderungen einzugehen.
  • Details bearbeiten und anzeigen: Benutzer haben Vollzugriff, um sämtliche Details und Konfigurationen sowohl der veröffentlichten als auch der Entwurfsversionen des Fabric Daten-Agents anzuzeigen und zu bearbeiten. Sie können auch den Fabric Daten-Agenten abfragen, was ihn ideal für die Zusammenarbeit macht.

Der folgende Screenshot zeigt die tatsächlichen Berechtigungen, die Sie auswählen können:

Screenshot mit der Auswahl der tatsächlichen Berechtigungen für die Freigabe des Fabric-Daten-Agenten.

Wenn Sie einen Fabric Daten-Agent freigeben, bevor Sie ihn veröffentlichen, können Benutzer mit Standardberechtigungen (ohne andere Berechtigungen) sie nicht abfragen. Dies funktioniert so, da benutzer mit der Standardberechtigung nur die veröffentlichte Version abfragen können– wenn noch keine veröffentlichte Version vorhanden ist, können Benutzer den Fabric Daten-Agent nicht abfragen. Benutzer mit anderen Berechtigungen (Details anzeigen oder Details bearbeiten und anzeigen) können nur auf die Entwurfsversion zugreifen. Der folgende Screenshot zeigt die Option zum Freigeben eines Fabric Daten-Agents ohne Veröffentlichung:

Screenshot mit der Option zum Freigeben eines Fabric-Daten-Agents ohne Veröffentlichung.