Бөлісу құралы:

executeEvent (алдын ала қарау)

Маңызды

  • Бұл алдын ала қарау мүмкіндігі болып табылады.
  • Алдын ала қарау нұсқасының мүмкіндіктері өндірісті пайдалану үшін арналмаған және функционалдық шектеулі болуы мүмкін. Бұл мүмкіндіктер қосымша пайдалану шарттарына бағынады және тұтынушылар ертерек қол жеткізу және кері байланыс орнату үшін ресми шығарылымға дейін қолжетімді.

Тіркелген оқиға атауына негізделген Microsoft Copilot Studio тақырыбын орындайды. MCSResponse типті массивті береді.

Қол жетімді

Модельге негізделген бағдарламалар

Синтаксис

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

РаT�

Параметр атауы Түр Талап етіледі Сипаттама
eventName жол Иә Copilot Studio тақырыбында тіркелген оқиға атауы
eventParameters Беймәлім Иә Оқиғаны орындау үшін қажетті параметрлер. Бұл тақырыптың не істейтініне байланысты.
successCallback Function Иә Операция табысқа жеткенде қоңырау шалуға арналған функция.
errorCallback Function Иә Операция істен шыққанда қоңырау шалу функциясы.

Қайтаратын мән

Түрі: Promise<MCSResponse>

Уәде және MCSResponse бөлімін қараңыз

Қолданба мәтінмәніне қатынасу

Agent API шақырылған кезде, бағдарламаның контексті айнымалылар жиынтығы арқылы Copilot Studio тақырыбына беріледі. Төменде Copilot Studio жаһандық айнымалылар ретінде қолжетімді мәтінмәндік айнымалылар берілген.

Айнымалы мән Сипаттама
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 тақырыбында API қоңырауына eventParameters айнымалы Activity.Valueарқылы қол жеткізуге болады. JSON-ды бір немесе бірнеше өрістері бар жазбаға түрлендіру үшін Талдау мәні түйінін пайдаланыңыз. Деректер түрі үшін Үлгі деректерінен таңдау жазбаны жасау үшін JSON үлгісін ұсынуға мүмкіндік береді.

Мысал

Microsoft Copilot Studio-да, енгізу параметрі ретінде идентификаторды (нысан жазба идентификаторын) қабылдайтын тақырып тіркелген. Кіріс негізінде ол сол нысан жазбасының байланысты әрекеттерін алады және нәтижелерді 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"
    }
]

Қосалқы ұшқыш
орындауPrompt
Power Apps компоненттері құрылымының API анықтамасы
Power Apps компоненттері құрылымына шолу

  • Last updated on