updateContext (referensi API Klien) (pratinjau)

Important

• Ini adalah fitur pratinjau.
• Fitur pratinjau tidak dimaksudkan untuk digunakan dalam produksi dan fungsinya mungkin terbatas. Fitur-fitur ini tunduk pada ketentuan penggunaan tambahan, dan tersedia sebelum rilis resmi sehingga pelanggan dapat memperoleh akses awal dan memberikan umpan balik.

(pratinjau) Mengirim konteks aplikasi yang diperbarui ke panel sisi Microsoft 365 Copilot.

Syntax

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

Parameters

Nama Parameter	Type	Required	Deskripsi
context	PowerAppsContent	Yes	Objek yang menjelaskan konteks aplikasi saat ini untuk dikirim ke panel samping Microsoft 365 Copilot.
successCallback	Function	Yes	Fungsi untuk memanggil saat operasi berhasil.
errorCallback	Function	Yes	Fungsi untuk memanggil saat operasi gagal.

Mengembalikan Nilai

Jenis: Promise<void>

Remarks

API secara otomatis menggabungkan bidang konteks dasar (appId, , appType, orgIdgeo, schemaVersion). Anda tidak perlu menyediakan bidang ini. API tidak melakukan apa pun jika Microsoft 365 Copilot tidak diaktifkan. Agen yang Anda buat belum dapat menggunakan konteks untuk mengoptimalkan responsnya.

Example

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

Artikel terkait

PowerAppsContent
Xrm.Copilot (Referensi API Klien)