중요합니다
- 미리 보기 기능입니다.
- 미리 보기 기능은 프로덕션용이 아니며 기능이 제한될 수 있습니다. 이러한 기능은 추가 사용 약관의 적용을 받으며, 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 사용할 수 있습니다.
등록된 이벤트 이름을 기반으로 Microsoft Copilot Studio 토픽을 실행합니다. MCSResponse 형식의 배열을 반환합니다.
사용할 수 있는 대상
모델 기반 앱
Syntax
context.copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);
매개 변수
| 매개 변수 이름 | 유형 | 필수 | Description |
|---|---|---|---|
eventName |
문자열 | Yes | Copilot Studio 토픽에 등록된 이벤트 이름 |
eventParameters |
알 수 없음 | Yes | 이벤트 실행에 필요한 매개 변수입니다. 이러한 항목은 토픽의 수행 내용에 따라 달라집니다. |
successCallback |
기능 | Yes | 작업이 성공할 때 호출할 함수입니다. |
errorCallback |
기능 | Yes | 작업이 실패할 때 호출하는 함수입니다. |
반환 값
형식: Promise<MCSResponse>
Promise 및 MCSResponse 참조
앱 컨텍스트에 액세스
에이전트 API가 호출되면 앱의 컨텍스트가 변수 집합을 통해 Copilot Studio 토픽에 전달됩니다. 다음은 Copilot Studio 전역 변수로 사용할 수 있는 컨텍스트 변수입니다.
| 변수 | Description |
|---|---|
Global.PA__Copilot_Model_PageContext.pageContext.id.guid |
기본 폼의 테이블 레코드 ID |
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName |
기본 페이지에 있는 테이블의 논리적 이름 |
Global.PA__Copilot_Model_PageContext.pageContext.pageName |
기본 페이지의 이름 |
Global.PA__Copilot_Model_PageContext.pageContext.pageType |
기본 페이지의 유형 |
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName |
모델 기반 앱의 고유 이름 |
예를 들어 Dataverse에서 폼의 레코드를 사용 Global.PA__Copilot_Model_PageContext.pageContext.id.guid 및 Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName검색할 수 있습니다.
eventParameters 액세스
Copilot Studio 항목 eventParameters 내에서 API 호출에서 변수 Activity.Value를 사용하여 액세스할 수 있습니다.
구문 분석 값 노드를 사용하여 JSON을 하나 이상의 필드가 있는 레코드로 변환합니다.
데이터 형식에 대한 샘플 데이터에서 선택하면 JSON 예제를 제공하여 레코드를 만들 수 있습니다.
Example
Microsoft Copilot Studio에서 ID(엔터티 레코드 ID)를 입력 매개 변수로 허용하는 토픽이 등록됩니다. 입력에 따라 해당 엔터티 레코드의 관련 활동을 검색하고 결과를 Copilot Studio 이벤트 활동으로 반환합니다. PCF 컨텍스트 API를 사용하면 PCF 컨트롤의 컨텍스트 내에서 이러한 메서드를 실행할 수 있습니다.
const response = await context.copilot.executeEvent(
"Microsoft.PowerApps.Copilot.RelatedActivities",
{ id:"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"});
응답
[
{
"type": "event",
"timestamp": "2025-02-05T16:05:53.4074714+00:00",
"replyToId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
"attachments": [],
"value": {
"@odata.context": "https://*.dynamics.com/api/data/v9.2/$metadata#activitypointers(subject,prioritycode)",
"value": [
{
"@odata.etag": "W/\"6825587\"",
"@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
"activityid": "cccccccc-2222-3333-4444-dddddddddddd",
"activitytypecode": "phonecall",
"prioritycode": 2,
"subject": "Discuss new opportunity (sample)"
},
{
"@odata.etag": "W/\"6826236\"",
"@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
"activityid": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
"activitytypecode": "phonecall",
"prioritycode": 2,
"subject": "Likes our new products (sample)"
}
]
},
"name": "MS.CopilotApiDemo.RelatedActivities"
}
]
관련 문서
Copilot
executePrompt
Power Apps 구성 요소 프레임워크 API 참조
Power Apps 구성 요소 프레임워크 개요