Important
- これはプレビュー機能です。
- プレビュー機能は運用環境向けではなく、機能が制限されている可能性があります。 これらの機能は 補足的な使用条件の対象であり、お客様が早期にアクセスしてフィードバックを提供できるように、公式リリースの前に利用できます。
トピックに登録されたトリガー クエリに基づいて Microsoft Copilot Studio トピックを実行します。 MCSResponse タイプの配列を返します。
使用可能な対象
モデル駆動型アプリ
構文
context.copilot.executeEvent(promptText).then(successCallback, errorCallback);
パラメーター
| パラメーター名 | タイプ | 必須 | Description |
|---|---|---|---|
promptText |
文字列 | イエス | MCS トピックのトリガー クエリとして登録されているテキスト。 |
successCallback |
機能 | イエス | 処理が成功したときに呼び出す関数。 |
errorCallback |
機能 | イエス | 処理が失敗したときに呼び出す関数。 |
戻り値
型: Promise<MCSResponse>
Promise と MCSResponse を参照してください
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 コンポーネント フレームワークの概要