次の方法で共有


executePrompt (プレビュー)

Important

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

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

使用可能な対象

モデル駆動型アプリ

構文

context.copilot.executeEvent(promptText).then(successCallback, errorCallback);

パラメーター

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

戻り値

型: Promise<MCSResponse>

PromiseMCSResponse を参照してください

Example

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

const response = await context.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?"
    }
]

Copilot
executeEvent
Power Apps コンポーネント フレームワーク API リファレンス
Power Apps コンポーネント フレームワークの概要