updateContext (rujukan API klien) (pratonton)

Penting

• Ini adalah ciri pratonton.
• Ciri pratonton bukan untuk kegunaan pengeluaran dan mungkin mempunyai kefungsian yang terbatas. Ciri-ciri ini tertakluk kepada syarat penggunaan tambahan, dan tersedia sebelum keluaran rasmi supaya pelanggan boleh mendapatkan access awal dan memberikan maklum balas.

(pratonton) Menghantar konteks aplikasi yang dikemas kini ke panel sisi Microsoft 365 Copilot.

Syntax

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

Parameter

Nama Parameter	Jenis	Diperlukan	Perihalan
context	PowerAppsContent	Ya	Objek yang menerangkan konteks aplikasi semasa untuk dihantar ke panel sisi Microsoft 365 Copilot.
successCallback	Fungsi	Ya	Fungsi untuk memanggil apabila operasi berjaya.
errorCallback	Fungsi	Ya	Fungsi untuk memanggil apabila operasi gagal.

Nilai Kembali

Jenis: Promise<void>

Kenyataan

API secara automatik menggabungkan medan konteks asas (appId, appType, , orgIdgeoschemaVersion, ). Anda tidak perlu menyediakan medan ini. API tidak melakukan apa-apa jika Microsoft 365 Copilot tidak didayakan. Ejen yang anda tulis belum boleh menggunakan konteks untuk mengoptimumkan respons mereka.

Contoh

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

Artikel berkaitan

PowerAppsContent
Xrm.Copilot (Rujukan API Pelanggan)