updateContext (Referència a l'API del client) (previsualització)

Important

  • Aquesta és una característica de visualització prèvia.
  • Les característiques en versió preliminar no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes funcions estan subjectes a termes d'ús suplementaris, i estan disponibles abans d'una versió oficial perquè els clients puguin obtenir access primerenc i donar comentaris.

(avançament) Envia el context actualitzat de l'aplicació al panell lateral del Microsoft 365 Copilot.

Sintaxi

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

Paràmetres

Nom del paràmetre Tipus Necessari Descripció
context PowerAppsContingut Un objecte que descriu el context actual de l'aplicació per enviar al panell lateral de Microsoft 365 Copilot.
successCallback Funció Una funció per cridar quan l'operació té èxit.
errorCallback Funció Una funció per cridar quan l'operació falla.

Valor retornat

Tipus: Promise<void>

Observacions

L'API fusiona automàticament els camps de context base (appId, appType, orgId, geo, schemaVersion). No cal que proporcionis aquests camps. L'API no fa res si Microsoft 365 Copilot no està activat. Els agents que escrius encara no poden utilitzar el context per optimitzar les seves respostes.

Exemple

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

PowerAppsContingut
Xrm.Copilot (Referència de l'API del client)