Bagikan melalui


executePrompt (referensi API Klien) (pratinjau)

Penting

  • 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.

Menjalankan topik Microsoft Copilot Studio berdasarkan kueri pemicu yang terdaftar dalam topik. Mengembalikan array jenis MCSResponse.

Syntax

Xrm.Copilot.executePrompt(promptText).then(successCallback, errorCallback);

Parameter-parameternya

Nama Parameter Tipe Diperlukan Description
promptText string Yes Teks yang terdaftar sebagai kueri pemicu dalam topik MCS.
successCallback Function Yes Fungsi untuk memanggil saat operasi berhasil.
errorCallback Function Yes Fungsi untuk memanggil saat operasi gagal.

Mengembalikan Nilai

Array MCSResponse

Example

Di Microsoft Copilot Studio, topik dipicu oleh kueri seperti "halo" atau "hai." Saat executePrompt dijalankan dengan promptText yang cocok, promptText mengaktifkan topik dan mengembalikan aktivitas Pesan dengan teks respons.

const response = await Xrm.Copilot.executePrompt("hello"); 

Jawaban

Ini adalah contoh respons yang dapat dikembalikan.

[
    {
        "type": "message",
        "timestamp": "2025-02-05T16:46:07.7799759+00:00",
        "replyToId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "attachments": [],
        "textFormat": "markdown",
        "text": "Hello, how can I help you today?",
        "speak": "Hello, <break strength=\"medium\" /> how can I help?"
    }
]

Xrm.Copilot (Referensi API Klien)