Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Dieser Artikel ist eine Vorabdokumentation und kann geändert werden.]
Mit den Dataverse-Ask-APIs kann Ihre Anwendung Fragen in natürlicher Sprache zu in Microsoft Dataverse gespeicherten Geschäftsdaten stellen. Sie definieren ein semantisches Modell , das die Dataverse-Tabellen identifiziert, die für ein Geschäftsszenario relevant sind, und stellen dann Fragen zu diesem Modell ein.
Important
- Dies ist eine Vorschauversion.
- Vorschau-Angebote werden wie besehen 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.
Eine Anwendung kann z. B. ein semantisches Modell erstellen, das die account Tabellen opportunity und die folgenden Fragen enthält:
- Welche offenen Chancen werden in diesem Quartal voraussichtlich geschlossen?
- Fassen Sie die Vertriebschancen für einen bestimmten Account zusammen.
- Welche Konten haben den höchsten geschätzten Umsatz?
Die Antwort kann Zeilen enthalten, die die Frage beantworten, eine Zusammenfassung in natürlicher Sprache, Quelllinks, die Anzahl der übereinstimmenden Zeilen und ein Paginierungstoken, wenn weitere Ergebnisse verfügbar sind.
Warum verwenden Sie die Dataverse Ask-APIs?
Verwenden Sie diese APIs, wenn Sie Zugriff in natürlicher Sprache auf Dataverse-Daten hinzufügen möchten, ohne dass Benutzer Tabellenbeziehungen, Abfragesyntax oder logische Spaltennamen kennen müssen.
Die API hilft Ihnen bei:
- Definieren Sie wiederverwendbare Bereiche über eine oder mehrere Dataverse-Tabellen.
- Fügen Sie benutzerdefinierten Anwendungen und Diensten Frage-und-Antwort-Funktionen hinzu.
- Geben Sie sowohl strukturierte Zeilen als auch eine Zusammenfassung in natürlicher Sprache zurück.
- Respektieren Sie den Dataverse-Datenzugriff auf die Identität, die die Frage übermittelt.
- Durchblättern größerer Resultsets mithilfe von Pagingtoken.
Die Dataverse Ask-APIs ergänzen die Dataverse-Web-API. Verwenden Sie die Dataverse-Web-API , wenn Ihre Anwendung präzise Vorgänge zum Erstellen, Abrufen, Aktualisieren, Löschen oder Abfragen benötigt. Verwenden Sie die Dataverse Ask-APIs, wenn es sich bei der Eingabe um eine Frage in natürlicher Sprache handelt, und die Anwendung benötigt den Dienst, um zu bestimmen, wie sie aus einer definierten Gruppe von Tabellen beantwortet werden soll.
Lizenzierung
Informationen und Bedingungen zur Work IQ-Lizenzierung finden Sie unter Lizenzierungsanforderungen.
Dataverse Ask API-Vorgänge
| Operation | Beschreibung |
|---|---|
| Auflisten semantischer Modelle | Listet semantische Modelle auf, die in der aktuellen Umgebung verfügbar sind. |
| Erstellen eines semantischen Modells | Erstellt ein benanntes semantisches Modell, das einer oder mehreren Dataverse-Tabellen zugeordnet ist. |
| Semantikmodell löschen | Löscht ein semantisches Modell. |
| Fragen mithilfe des semantischen Modells | Stellt eine Frage in natürlicher Sprache an ein benanntes semantisches Modell. |
Dataverse Ask API-Merkmale
Die Dataverse Ask-APIs verwenden JSON über HTTP unter:
https://<environment-url>/api/iq/v1.0/
Er ist nicht Teil des OData-Diensts unter /api/data/. Es stellt kein OData-Dienstdokument oder Metadatendokument bereit und unterstützt keine OData-Abfrageoptionen wie $select, oder $filter$expand.
Für diese Vorgänge werden keine Dataverse SDK für .NET oder SDK für Python Clientklassen bereitgestellt. Verwenden Sie einen HTTP-Client und authentifizieren Sie sich mit einem Microsoft Entra ID Zugriffstoken für die Dataverse-Umgebung.
Get started
- Fordern Sie Den Zugriff an, und bereiten Sie Ihre Anwendung vor.
- Verwalten sie semantische Modelle.
- Stellen Sie Fragen mithilfe eines semantischen Modells.