Partekatu honen bidez:

executeEvent (aurrebista)

Garrantzitsua da

  • Hau aurreikuspen-eginbidea da.
  • Aurreargitalpen-eginbideak ez daude ekoizpenerako diseinatuta, eta baliteke funtzionalitate murriztua izatea. Ezaugarri hauek **erabilera-baldintza osagarrien** menpe daude, eta kaleratze ofiziala baino lehen daude eskuragarri, bezeroek sarbide goiztiarra izan dezaten eta iritzia eman dezaten. ...

Microsoft Copilot Studio-ko gai bat exekutatzen du, erregistratutako gertaeraren izenean oinarrituta. MCSResponse motako matrizea itzultzen du.

Horretarako erabilgarri

Ereduetan oinarritutako aplikazioak

Sintaxia

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

Parametroak

Parametroaren izena Mota Beharrezkoa Deskribapena
eventName kate Bai Copilot Studio gaian erregistratutako gertaeraren izena
eventParameters Ezezaguna Bai Gertaeraren exekuziorako beharrezkoak diren parametroak. Gaiak egiten duenaren araberakoa da.
successCallback Function Bai Eragiketa behar bezala egiten denean deitzen zaion funtzioa.
errorCallback Function Bai Eragiketan akats bat gertatzen denean deitzen zaion funtzioa.

Itzuli balioa

Mota: Promise<MCSResponse>

Ikusi promesa eta MCSResponse

Aplikazioaren testuingurura atzitzea

Agente API bat deitzen denean, aplikazioaren testuingurua Copilot Studio gaiari pasatzen zaio aldagai multzo baten bidez. Hona hemen Copilot Studio aldagai global gisa eskuragarri dauden testuinguru-aldagaiak.

Aldagaia Deskribapena
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Inprimaki nagusiko taulako erregistroaren IDa
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Orrialde nagusiko taularen izen logikoa
Global.PA__Copilot_Model_PageContext.pageContext.pageName Orrialde nagusiaren izena
Global.PA__Copilot_Model_PageContext.pageContext.pageType Orrialde nagusiaren mota
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Ereduan oinarritutako aplikazioaren izen esklusiboa

Adibidez, Global.PA__Copilot_Model_PageContext.pageContext.id.guid eta Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, inprimakiaren erregistroa Dataverse-tik berreskuratu daiteke.

GertaeraParametroetara atzitzea

Copilot Studio gaiaren barruan, eventParameters API deiaren aldagaia Activity.Valueerabiliz sar daiteke. Erabili Parse balioaren nodoa JSON eremu bat edo gehiago dituen erregistro bihurtzeko. Datu motarenlagin-datuetatik hautatzeak JSON adibide bat ematen du erregistroa sortzeko.

Adibidez

Microsoft Copilot Studio-n, non ID bat (entitate-erregistroaren ID) sarrerako parametro gisa onartzen duen gai bat erregistratzen den. Sarreran oinarrituta, entitate-erregistro horren erlazionatutako jarduerak berreskuratzen ditu eta emaitzak Copilot Studio gertaera-jarduera gisa itzultzen ditu. PCF testuinguruko APIak metodo horiek PCF kontrolen testuinguruan exekutatzea ahalbidetzen du.

const response = await context.copilot.executeEvent( 
    "Microsoft.PowerApps.Copilot.RelatedActivities", 
    { id:"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"});

Response

[
    {
        "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"
    }
]

Kopilotoa
exekutatu gonbita
Power Apps-en osagaien esparruaren APIaren erreferentzia
Power Apps-en osagaien esparruaren ikuspegi orokorra

  • Last updated on