updateContext (klient-API-reference) (prøveversion)

Important

  • Dette er en prøveversionsfunktion.
  • Prøveversionsfunktioner er ikke beregnet til produktionsbrug og kan have begrænset funktionalitet. Disse funktioner er underlagt supplerende vilkår for anvendelse og er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

(eksempelvisning) Sender opdateret appkontekst til Microsoft 365 Copilot sidepanelet.

Syntaks

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

Parametre

Parameternavn Type Påkrævet Beskrivelse
context PowerAppsContent Yes Et objekt, der beskriver den aktuelle appkontekst, der skal sendes til Microsoft 365 Copilot sidepanel.
successCallback Function Yes En funktion, der skal kaldes, når handlingen lykkes.
errorCallback Function Yes En funktion, der skal kaldes, når handlingen mislykkes.

Returværdi

Type: Promise<void>

Remarks

API'en fletter automatisk basiskontekstfelter (appId, appType, orgId, geoschemaVersion). Du behøver ikke at angive disse felter. API'en gør ingenting, hvis Microsoft 365 Copilot ikke er aktiveret. Agenter, du opretter, kan endnu ikke bruge kontekst til at optimere deres svar.

Eksempel

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 (klient-API-reference)