共用方式為

executeEvent （預覽）

這很重要

  • 這是預覽功能。
  • 預覽功能不供生產時使用，而且可能功能受限。 這些功能應受補充使用條款所拘束，其為在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。

根據已註冊的事件名稱執行 Microsoft Copilot Studio 主題。 傳回類型為 MCSResponse 的陣列。

適用於

模型導向應用程式

語法

context.copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);

參數

參數名稱 類型 為必填項目 Description
eventName 字串 Yes 在 Copilot Studio 主題中註冊的事件名稱
eventParameters Unknown Yes 事件執行所需的參數。 這些取決於主題的作用。
successCallback 功能 Yes 作業成功時要呼叫的函式。
errorCallback 功能 Yes 作業失敗時要呼叫的函式。

傳回值

類型： Promise<MCS訊息>

請參閱 Promise 和 MCSResponse

存取應用程式上下文

呼叫代理程式 API 時，應用程式的內容會透過一組變數傳遞至 Copilot Studio 主題。 以下是可用作 Copilot Studio 全域變數的上下文變數。

Variable Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid 主表單上的資料表記錄識別碼
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 模型導向應用程式的唯一名稱

例如，使用 Global.PA__Copilot_Model_PageContext.pageContext.id.guid 和 Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName，可以從 Dataverse 擷取表單的記錄。

存取eventParameters

在 Copilot Studio 主題中， eventParameters 可以使用變數 Activity.Value存取 來自 API 呼叫。 使用 剖析值 節點 將 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
execute提示
Power Apps 元件架構 API 參考
Power Apps 元件架構概觀

  • Last updated on