executePrompt (客户端 API 参考) (预览版)

重要

  • 这是一项预览功能。
  • 预览功能不适用于生产用途,并且可能具有受限功能。 这些功能受 补充使用条款的约束,在正式发布之前提供,以便客户能够提前访问并提供反馈。

根据主题中注册的触发器查询执行 Microsoft Copilot Studio 主题。 返回 MCSResponse 类型的数组。

Syntax

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

参数

参数名称 类型 必选 Description
promptText 字符串 是的 在 MCS 主题中注册为触发器查询的文本。
successCallback 功能 是的 作成功时要调用的函数。
errorCallback 功能 是的 作失败时要调用的函数。

返回值

MCSResponse 数组

Example

在 Microsoft Copilot Studio 中,主题由“hello”或“hi”等查询触发。当 executePrompt 使用匹配的 promptText 运行时,它会激活主题并返回包含响应文本的消息活动。

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

响应

这是可能返回的响应的示例。

[
    {
        "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 (客户端 API 参考)