중요합니다
- 미리 보기 기능입니다.
- 미리 보기 기능은 프로덕션용이 아니며 기능이 제한될 수 있습니다. 이러한 기능은 추가 사용 약관의 적용을 받으며, 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 사용할 수 있습니다.
등록된 이벤트 이름을 기반으로 Microsoft Copilot Studio 토픽을 실행합니다. MCSResponse 형식의 배열을 반환합니다.
Syntax
Xrm.Copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);
매개 변수
| 매개 변수 이름 | 유형 | 필수 | Description |
|---|---|---|---|
eventName |
문자열 | Yes | Microsoft Copilot Studio 항목에 등록된 이벤트 이름 |
eventParameters |
알 수 없음 | Yes | 이벤트 실행에 필요한 매개 변수입니다. 이러한 항목은 토픽의 수행 내용에 따라 달라집니다. |
successCallback |
기능 | Yes | 작업이 성공할 때 호출할 함수입니다. |
errorCallback |
기능 | Yes | 작업이 실패할 때 호출하는 함수입니다. |
반환 값
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 이벤트 활동으로 반환합니다.
const response = await Xrm.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"
}
]