updateContext (Client-API-Referenz) (Vorschau)

Important

  • Dies ist eine Vorschaufunktion.
  • Vorschaufunktionen sind nicht für den Produktionsgebrauch gedacht und haben möglicherweise eine eingeschränkte Funktionalität. Für diese Features gelten ergänzende Nutzungsbedingungen. Die Features werden vor einer offiziellen Veröffentlichung zur Verfügung gestellt, sodass die Kundschaft frühzeitig Zugriff erhält und Feedback geben kann.

(Vorschau) Sendet den aktualisierten App-Kontext an den Microsoft 365 Copilot Seitenbereich.

Syntax

Xrm.Copilot.updateContext(context).then(successCallback, errorCallback);

Parameter

Parametername Typ Erforderlich Beschreibung
context PowerAppsContent Yes Ein Objekt, das den aktuellen App-Kontext beschreibt, der an den Microsoft 365 Copilot Seitenbereich gesendet werden soll.
successCallback Funktion Yes Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich war.
errorCallback Funktion Yes Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Typ: Promise<void>

Remarks

Die API führt automatisch Basiskontextfelder (appId, appType, , orgIdgeo, ). schemaVersion Sie müssen diese Felder nicht angeben. Die API führt nichts aus, wenn Microsoft 365 Copilot nicht aktiviert ist. Agents, die Sie erstellen, können den Kontext noch nicht verwenden, um ihre Antworten zu optimieren.

Example

await Xrm.Copilot.updateContext({
    entity: "account",
    filterXML: "<fetch><entity name='account'><filter><condition attribute='statecode' operator='eq' value='0'/></filter></entity></fetch>"
});

PowerAppsContent
Xrm.Copilot (Client-API-Referenz)