중요합니다
- 미리 보기 기능입니다.
- 미리 보기 기능은 프로덕션용이 아니며 기능이 제한될 수 있습니다. 이러한 기능은 추가 사용 약관의 적용을 받으며, 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 사용할 수 있습니다.
토픽에 등록된 트리거 쿼리를 기반으로 Microsoft Copilot Studio 토픽을 실행합니다. MCSResponse 형식의 배열을 반환합니다.
사용할 수 있는 대상
모델 기반 앱
Syntax
context.copilot.executeEvent(promptText).then(successCallback, errorCallback);
매개 변수
| 매개 변수 이름 | 유형 | 필수 | Description |
|---|---|---|---|
promptText |
문자열 | Yes | MCS 토픽에서 트리거 쿼리로 등록된 텍스트입니다. |
successCallback |
기능 | Yes | 작업이 성공할 때 호출할 함수입니다. |
errorCallback |
기능 | Yes | 작업이 실패할 때 호출하는 함수입니다. |
반환 값
형식: Promise<MCSResponse>
Promise 및 MCSResponse 참조
Example
Microsoft Copilot Studio에서 토픽이 "hello" 또는 "hi"와 같은 쿼리에 의해 트리거되는 경우 일치promptText를 사용하여 실행하면 executePrompt 토픽을 활성화하고 응답 텍스트가 포함된 메시지 활동을 반환합니다.
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 구성 요소 프레임워크 개요