Microsoft Dataverse Plug-In für KI-Agents –Referenz (Vorschau)

[Dieser Artikel ist die Vorabveröffentlichungsdokumentation und unterliegt Änderungen.]

Das Microsoft Dataverse-Plug-In für KI-Agents bietet aufgabenspezifische Fähigkeiten, die Ihr KI-Codierungs-Agent basierend auf Ihrer Anforderung lädt. In dieser Referenz werden die einzelnen Fähigkeiten, ihre Tools und Beispielaufforderungen beschrieben, damit Sie wissen, welche Dataverse-Entwicklungsaufgaben der Agent ausführen kann. Beschreiben Sie das Ergebnis, anstatt eine Fähigkeit zu benennen. Der Agent lädt Orientierungsleitfaden und kann spezielle Fähigkeiten für eine Aufgabe kombinieren.

Important

  • Dies ist eine Vorschaufunktion.
  • Vorschauangebote werden as-is bereitgestellt und können jederzeit geändert oder eingestellt werden. Bei nutzungsbasierten Diensten kann die Nutzung zugrunde liegender Anwendungsdienste während des Vorschauzeitraums weiterhin Lizenzgebühren verursachen.
  • Vorschaufeatures unterliegen ergänzenden Nutzungsbedingungen und stehen vor einer offiziellen Version zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Die Fähigkeiten verwenden die Dataverse CLI, Dataverse MCP-Server, Dataverse SDK für Python, Power Platform CLI und Dataverse Web API.

Informationen zum Einrichten finden Sie unter Verwenden des Plug-Ins mit AI-Codierungs-Agents. Informationen zu Authentifizierung und Kontrollen finden Sie unter "Sicherheit und Governance". Qualifikationsquelle befindet sich im Dataverse-Skills-Repository.

Dataverse Plugin Skill Index

Wählen Sie eine Fähigkeit aus, um ihre Tools, unterstützten Aufgaben und Beispielaufforderungen zu überprüfen.

Skill Verwendung für
dv-overview Ausrichtung, Planung und Toolauswahl
dv-connect Arbeitsbereichseinrichtung, Authentifizierung und Verbindungsdiagnose
dv-query Abfragen, Paging, Exporte und Analysen
dv-data Aufzeichnen von Schreibvorgängen, Importen, Dateien und Beispieldaten
dv-metadata Tabellen, Spalten, Beziehungen, Schlüssel, Formulare und Ansichten
dv-solution Herausgeber, Lösungen, Bereitstellung und Validierung
dv-admin Unterstützte Umgebungseinstellungen, Massenlöschung und Aufbewahrung
dv-security Benutzer- und Anwendungsbenutzerzugriff, Rollenzuweisung und Administrator self-elevation
erp-sql Temporärer LESE-SQL-Zugriff in berechtigten Finanz- und Operations-Entwicklerumgebungen aktivieren
erp-xpp X++-Entwicklung, Kompilierung, Bereitstellung und Datenbanksynchronisierung

dv-overview

Die Übersichtskompetenz bietet den Dataverse-Kontext, allgemeine Regeln und Anleitungen zur Toolauswahl. Der Agent lädt es vor spezialisierten Fähigkeiten.

Sie hilft dem Agenten:

  • Überprüfen sie den Arbeitsbereich und den Verbindungsstatus.
  • Wählen Sie ein verwaltetes Tool basierend auf dem Vorgang und dem Datenvolume aus.
  • Verwenden Sie die freigegebenen Authentifizierungsmuster, die von dv-connect.
  • Bestätigen Sie die Zielumgebung und Lösung, bevor Metadatenänderungen vorgenommen werden.
  • Folgen Sie einem Umgebungsworkflow: Nehmen Sie Änderungen in Dataverse vor, exportieren, entpacken Und übernehmen Sie den Commit.
  • Identifizieren Sie Lücken, anstatt nicht unterstützte Befehle oder SDK-Methoden zu erfinden.

Beispielaufforderung:

Erstellen Sie ein Recruiting-Datenmodell, laden Sie Beispieldatensätze, und verpacken Sie die Komponenten in einer Lösung.

Diese Anforderung kann kombiniert dv-metadata, dv-data, , dv-queryund dv-solution.

dv-connect

Verwenden Sie die Verbindungsanleitung zum Einrichten oder Diagnostizieren eines Codierungs-Agent-Arbeitsbereichs. Der Fluss überprüft die vorhandene Konfiguration und überspringt die abgeschlossenen Schritte.

Die Fähigkeit:

  • Überprüft Git, Node.js, Python, .NET SDK, Azure CLI, Power Platform CLI und dataverse CLI.
  • Installiert oder aktualisiert erforderliche Tools, wenn der Host sie unterstützt.
  • Ermittelt Umgebungen, wählt Authentifizierungsprofile aus und konfiguriert die interaktive oder Dienstprinzipalauthentifizierung.
  • Erstellt lokale Umgebungskonfigurationen und Ausschlüsse zur Quellcodeverwaltung.
  • Konfiguriert MCP für GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI und Google Antigravity.
  • Überprüft die CLI-, SDK- und MCP-Konnektivität, sofern verfügbar.

Gemini CLI verwendet die gebündelte MCP-Konfiguration und den GA-Endpunkt der Erweiterung. Antigravity verwendet die hostspezifische MCP-Registrierung. Bei eingeschränkten Hosts verwendet die Fähigkeit ihren Python SDK-Pfad und überspringt die lokale CLI- und MCP-Einrichtung.

Beispielaufforderungen:

Stellen Sie eine Verbindung mit meiner Dataverse-Umgebung her.

Wechseln Sie diesen Arbeitsbereich zur Entwicklungsumgebung, und überprüfen Sie die MCP-Verbindung.

Informationen zum Verbindungsfluss finden Sie unter "Herstellen einer Verbindung mit Dataverse".

dv-query

Die Abfragefähigkeit liest und analysiert Dataverse-Datensätze. Es verwendet MCP für kleine interaktive Lesevorgänge, dataverse CLI für kopflose Abfragen und das Python SDK für Massenlesevorgänge und Analysen.

Es unterstützt:

  • Auswählen, Filtern, Sortieren und Auslagerung von Datensätzen
  • Abrufen eines Datensatzes nach ID.
  • Auflösen von Nachschlageanzeigewerten und Erweitern verwandter Datensätze.
  • Unterstützte serverseitige Anzahl, Gruppierung, Aggregation und Verknüpfungen über SQL oder FetchXML.
  • Streaming großer Resultsets.
  • CSV-Exporte, Notizbücher und Pandas DataFrames.

Die Qualifikation fragt die Liveumgebung ab und begrenzt ausgewählte Spalten. Informationen zu SDK-Mustern finden Sie unter Abfragedaten mithilfe des Dataverse SDK für Python.

Für verknüpfte Finanz- und Betriebsumgebungen verwendet die Fähigkeit ERP MCP oder das ERP-Ziel der Dataverse CLI für Geschäftsdaten liest und Laufzeitentität, Schema oder Aktionsermittlung anstelle des Dataverse Python SDK. Direkter Entwicklerdatenbankzugriff ist ein separater, opt-in-Workflow erp-sql .

Beispielaufforderungen:

Gruppieren Sie aktive Verkaufschancen nach Vertriebsphase, und zeigen Sie die Anzahl und den geschätzten Gesamtwert an.

Exportieren Von Kontonamen, primären Kontakten und Städten in eine CSV-Datei.

dv-data

Die Datenkompetenz erstellt, korrigiert, importiert und saatgutt Datensätze. Es verwendet MCP für kleine interaktive Gruppen, die Dataverse CLI für einzelne Vorgänge und das Python SDK für Skript- und Massenschreibvorgänge.

Es unterstützt:

  • Einzeldatensatz-Erstellungs-, Aktualisierungs- und Löschvorgänge.
  • Alternativer Schlüssel-Upsert für idempotente Importe.
  • Massenerstellungs-, Aktualisierungs- und Upsert-Vorgänge.
  • CSV-Zuordnung und Nachschlageauflösung.
  • Multitabellenimporte nach Fremdschlüsselabhängigkeiten sortiert.
  • Pandas DataFrame-Zurückschreiben.
  • Dateispaltenuploads.
  • Schemagesteuerte Beispieldatengenerierung.

Bei großen Schreibvorgängen verwendet die Fähigkeit Dataverse-Massennachrichten wie CreateMultiple, UpdateMultipleund UpsertMultiple. Skripts teilen große Nutzlasten in Batches auf. In verknüpften Finanz- und Betriebsumgebungen verfügt die Qualifikation über separate Anleitungen für ERP-Datensatzschreibvorgänge und Datenverwaltung Framework -Paketimporte (DMF).

Beispielaufforderungen:

Importieren Sie contacts.csv und verwenden Sie E-Mails als alternativer Schlüssel, sodass beim erneuten Ausführen des Imports keine Duplikate erstellt werden.

Erstellen Sie effizient 500 Ticketdatensätze mit eindeutigen Titeln und gültigen Prioritätswerten.

Informationen zu SDK-Schreibmustern finden Sie unter "Arbeiten mit Daten mithilfe des Dataverse SDK für Python".

dv-metadata

Die Metadatenfähigkeit erstellt und prüft das Dataverse-Schema. Es verwendet MCP für unterstützte Tabellen- und Spaltenänderungen, das Python SDK für Schema- und Formular- oder Ansichtsdatensätze und verwaltete Web-API-Aufrufe für Lücken.

Es unterstützt:

  • Tabellen und Spalten, einschließlich Auswahl, Nachschlagevorgang und Dateispalten.
  • 1:n-Beziehungen und m:n-Beziehungen.
  • Alternative Tasten.
  • Formulare und Ansichten.
  • Vorhandene Schemaüberprüfung.
  • Hinzufügen von Komponenten zu einer Lösung.

Vor der ersten Änderung der Metadaten bestätigt der Agent die Umgebung, Lösung und das Herausgeberpräfix. Sie erstellt Komponenten in der Umgebung über verwaltete APIs und ruft das Ergebnis mithilfe von Lösungsexport- und Entpackbefehlen in das Repository ab, anstatt neue Lösungs-XML zu schreiben.

Beispielaufforderungen:

Erstellen Sie eine Kundenfeedbacktabelle mit Namen-, Bewertungs-, Kommentar- und Konto-Nachschlagespalten in der CustomerService-Lösung.

Fügen Sie dem Hauptformular des Tickets Priorität und zugewiesene Agentenfelder hinzu, und erstellen Sie eine Ansicht für nicht aufgelöste Tickets mit hoher Priorität.

Informationen zu SDK-Mustern finden Sie unter Arbeiten mit Tabellendefinitionen mithilfe des Dataverse SDK für Python.

dv-solution

Die Lösungskompetenz verwaltet den Lösungslebenszyklus. Es verwendet Power Platform CLI zum Exportieren, Entpacken, Packen und Importieren von Lösungen. Es verwendet das Python SDK zum Verwalten von Herausgeber- und Lösungseinträgen und zum Durchführen der Überprüfung.

Es unterstützt:

  • Entdecken oder Erstellen von Herausgebern und Lösungen.
  • Hinzufügen von Komponenten zu einer Lösung.
  • Exportieren und Entpacken nicht verwalteter Entwicklungslösungen.
  • Packen und Importieren von Lösungen in eine andere Umgebung.
  • Überprüfen des Importfortschritts und der Fehler.
  • Überprüfen von Tabellen, Formularen, Ansichten und Rollenzuweisungen nach der Bereitstellung.

Der Agent fordert Sie auf, vor dem Erstellen eines Herausgebers ein Herausgeberpräfix auszuwählen oder zu bestätigen. Sie werden aufgefordert, die Quell- oder Zielumgebung vor dem Exportieren oder Importieren zu bestätigen.

Beispielaufforderungen:

Ziehen Sie das Schema in die CustomerService-Lösung, exportieren Sie es aus der Entwicklung, und entpacken Sie es in das Repository.

Packen Sie die CustomerService-Lösung, importieren Sie sie in Test, und überprüfen Sie, ob die Tickettabelle, das Hauptformular und die aktive Ticketansicht verfügbar sind.

Siehe Power Platform CLI-Lösungsbefehle.

dv-admin

Die Verwaltungskompetenz verwaltet unterstützte Einstellungen auf Umgebungsebene und Datenlebenszyklusvorgänge. Es verwendet Power Platform CLI- und Python SDK- oder Web-API-Pfade, die durch die Einstellung oder den Vorgang ausgewählt wurden.

Es unterstützt:

  • Planen und Verwalten von Massenlöschaufträgen.
  • Konfigurieren von Aufbewahrung und Archivierung.
  • Lesen oder Aktualisieren zugelassener Organisations- und OrgDB-Einstellungen.
  • Verwalten der Konfiguration des Papierkorbs auf Organisationsebene.
  • Konfigurieren der unterstützten Überwachungseinstellungen.
  • Auflisten oder Abbrechen unterstützter Finanz- und Operations-Batchaufträge in verknüpften Umgebungen.

Die Einstellungen sind auf eine Liste mit schwierigen Zulassungen beschränkt. Verwenden Sie für andere Einstellungen das Power Platform Admin Center. Nicht gefilterte Massenlöschvorgänge sind unwiderruflich und umgehen den Papierkorb. Die Fähigkeit erfordert eine explizite Bestätigung, die die Tabelle benennt und besagt, dass alle Datensätze gelöscht werden sollen.

Beispielaufforderungen:

Zeigen Sie mir an, ob die Überwachungs- und Plug-In-Ablaufverfolgungsprotokollierung in dieser Umgebung aktiviert ist.

Erstellen Sie eine Aufbewahrungsrichtlinie für Aktivitäten, die älter als drei Jahre sind.

Informationen zu Organisationseinstellungen finden Sie unter Abrufen und Aktualisieren von Organisationseinstellungen.

dv-security

Die Sicherheitskompetenz verwaltet den Benutzerzugriff über CLIs von Erstanbietern und überprüft, ob Änderungen angewendet wurden. Es verwendet Power Platform CLI für Rollenzuweisung und Administrator self-elevation, wobei Dataverse liest, um Ergebnisse zu überprüfen.

Es unterstützt:

  • Zuweisen vorhandener Sicherheitsrollen zu Benutzern.
  • Zuweisen von Rollen zu Anwendungsbenutzern.
  • Arbeiten mit Geschäftseinheitskontext für Rollenzuweisungen.
  • Anwenden genehmigter Rollenänderungen in ausgewählten Umgebungen.
  • Administrator-Selbsterweiterung, wenn der Aufrufer über die erforderliche Mandantenrolle verfügt.

Rollenänderungen benötigen eine Vorschau, die den Benutzer, die Rolle und die Umgebung identifiziert, gefolgt von Bestätigung und Rückleseüberprüfung. Die Selbsterweiterung benötigt eine separate Risikoaufstellung, einen Grund und eine Bestätigung und wird bei Microsoft Purview protokolliert.

Beispielaufforderungen:

Weisen Sie der Entwicklung die Rolle "Standardbenutzer" zu user@contoso.com , und überprüfen Sie die Zuweisung.

Fügen Sie diese Anwendungs-ID als Anwendungsbenutzer hinzu, und weisen Sie die Integrationssicherheitsrolle zu.

erp-sql

Die ERP SQL-Fähigkeit beschreibt den temporären Lesezugriff und die gebundenen physischen Tabellen in berechtigten Finanz- und Operations-einheitlichen Entwicklungsumgebungen (UDEs). Es verwendet die verwaltete Dataverse CLI, Python Hilfsprogramme und sqlcmd. Dieser Workflow ist ein expliziter Opt-In-Prozess, kein gewöhnlicher Geschäftsdatenabfragepfad oder der Dataverse TDS-Endpunkt.

Die Fähigkeit erfordert die Rolle des Systemadministrators für die Umgebung und die Genehmigung des vom Benutzer bereitgestellten IP-Bereichs, des Grunds und der gebundenen Lesevorgänge. Durch eine neue Erteilung werden vorhandene SQL-Anmeldeinformationen für denselben Benutzer und dieselbe Umgebung ungültig. Die Fähigkeit behält Anmeldeinformationen im Arbeitsspeicher bei und erfordert eine überprüfte Verbindung, anstatt eine Anmeldeinformationsantwort als Erfolg zu behandeln.

Die Fähigkeit stellt fest, dass ihre Anmeldeinformationsaktion keinen dokumentierten öffentlichen API-Vertrag enthält und beendet, wenn ein kompatibler Vertrag nicht überprüft werden kann. Informationen zum dokumentierten Produktworkflow finden Sie unter "Finanz- und Betriebsproduktdatenbankzugriff".

Beispielaufforderung:

Erläutern Sie die Voraussetzungen und Zugriffswirkungen, bevor Sie temporären Reader-Zugriff auf meine Finanz- und Operations-Entwicklerdatenbank anfordern.

erp-xpp

Die X++-Fähigkeit umfasst die Codeentwicklung und -bereitstellung für eine verknüpfte Finanz- und Betriebsumgebung. Es verwendet Power Platform CLI-Paket- und X++-SDK-Befehle auf Windows mit ausgewählten Laufzeitüberprüfungen über ERP-Tools.

Die Kompetenzgerüstmodelle, führt Erstellungsklassen, benutzerdefinierte Dienste, APIs und Datenentitäten, installiert übereinstimmende SDKs, kompiliert bereitstellungsfähige Pakete, stellt Pakete bereit und synchronisiert Datenbanken. Für die SDK-Installation und Kompilierung ist Windows erforderlich.

Vor der Bereitstellung oder Datenbanksynchronisierung bestätigt der Agent das Dataverse-Ziel und überprüft die verknüpfte ERP-Umgebung. Sie werden aufgefordert, den Datenbanksynchronisierungsbereich auszuwählen, wenn die Anforderung mehrdeutig ist. Zusätzliche Überprüfungen nach der Bereitstellung sind opt-in: Der Agent fragt, welche Überprüfungen Sie autorisieren und bestätigen Eingaben und erwartete Effekte vor der Laufzeitausführung.

Beispielaufforderungen:

Erstellen Sie ein X++-Modell für diese Anpassung, und kompilieren Sie ein bereitstellungsfähiges Paket.

Stellen Sie dieses Paket ohne Datenbanksynchronisierung in der verknüpften Entwicklungsumgebung bereit.

Dataverse Plug-In-Auswahlbeispiele

Eine Anforderung kann mehrere Fähigkeiten verwenden.

Anforderung Fähigkeiten, die der Agent verwenden kann
Verbinden und Listentabellen dv-overview, dv-connectdv-query
Erstellen einer Tabelle und Laden einer CSV-Datei dv-overview, dv-metadatadv-data
Analysieren von Verkaufschancendaten in einem Notizbuch dv-overview, dv-query
Paketschemaänderungen und Bereitstellen der Schemaänderungen zum Testen dv-overview, dv-solution
Konfigurieren von Aufbewahrungs- und Überprüfungseinstellungen dv-overview, dv-admin
Hinzufügen eines Integrationsbenutzers und Zuweisen einer Rolle dv-overview, dv-security

Der Autor hat diesen Artikel mit Unterstützung von KI erstellt.