次の方法で共有


executePrompt (クライアント API リファレンス) (プレビュー)

Important

  • これはプレビュー機能です。
  • プレビュー機能は運用環境向けではなく、機能が制限されている可能性があります。 これらの機能は 補足的な使用条件の対象であり、お客様が早期にアクセスしてフィードバックを提供できるように、公式リリースの前に利用できます。

トピックに登録されているトリガー クエリに基づいて、Microsoft Copilot Studio トピックを実行します。 MCSResponse 型の配列を返します。

構文

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

パラメーター

パラメーター名 タイプ 必須 Description
promptText 文字列 イエス MCS トピックのトリガー クエリとして登録されているテキスト。
successCallback 機能 イエス 処理が成功したときに呼び出す関数。
errorCallback 機能 イエス 処理が失敗したときに呼び出す関数。

戻り値

MCSResponse の配列

Example

Microsoft Copilot Studio では、"hello" や "hi" などのクエリによってトピックがトリガーされます。一致する promptText で実行 executePrompt 、トピックをアクティブ化し、応答テキストを含むメッセージ アクティビティを返します。

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 リファレンス)