Поделиться через

executeEvent (предварительная версия)

Это важно

  • Это предварительная версия функции.
  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Для этих функций действуют дополнительные условия использования и они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Выполняет раздел Microsoft Copilot Studio на основе зарегистрированного имени события. Возвращает массив типа MCSResponse.

Доступно для

Приложения на основе модели

Синтаксис

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

Параметры

Имя параметра Тип Обязательно Description
eventName струна Да Имя события, зарегистрированное в разделе Copilot Studio
eventParameters Неизвестно Да Параметры, необходимые для выполнения события. Они зависят от того, что делает тема.
successCallback Функция Да Функция, вызываемая при успешном выполнении операции.
errorCallback Функция Да Функция, вызываемая при сбое операции.

Возвращаемое значение

Тип: Promise<MCSResponse>

См . обещание и 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

В разделе eventParameters Copilot Studio можно получить доступ к вызову API с помощью переменной Activity.Value. Используйте узел значения синтаксического анализа для преобразования JSON в запись с одним или несколькими полями. Выборка из примера данных для типа данных позволяет предоставить пример JSON для создания записи.

Example

В Microsoft Copilot Studio, где раздел зарегистрирован, который принимает идентификатор (идентификатор записи сущности) в качестве входного параметра. На основе входных данных он извлекает связанные действия этой записи сущности и возвращает результаты в качестве действия события Copilot Studio. API контекста PCF позволяет выполнять эти методы в контексте элементов управления 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
Справочник по API платформы компонентов Power Apps
Обзор платформы компонентов Power Apps

  • Last updated on