Deli z drugimi prek

executeEvent (predogled)

Pomembno

  • To je funkcija predogleda.
  • Predogledne različice funkcij niso za komercialno uporabo in njihovo delovanje je lahko omejeno. Za te funkcije veljajo dodatni pogoji uporabe in so na voljo pred uradno izdajo, tako da lahko stranke dobijo zgodnji dostop in pošljejo povratne informacije.

Izvede temo Microsoft Copilot Studio, ki temelji na registriranem imenu dogodka. Vrne matriko vrste MCSResponse.

Na voljo za

Aplikacije, ki temeljijo na modelu

Sintaksa

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

Parametrov

Ime parametra Vrsta Zahtevano Opis
eventName niz Da Ime dogodka, registrirano v temi Copilot Studio
eventParameters Neznano Da Parametri, potrebni za izvedbo dogodka. Te so odvisne od tega, kaj tema počne.
successCallback Function Da Funkcija, ki jo pokličete, ko je operacija uspešna.
errorCallback Function Da Funkcija, ki jo pokličete, ko operacija ne uspe.

Vrednost vračila

Vrsta: Promise<MCSResponse>

Glejte Promise in MCSResponse

Dostop do konteksta programa

Ko pokličete API agenta, se kontekst aplikacije prenese v temo copilot Studio prek nabora spremenljivk. Spodaj so navedene kontekstne spremenljivke, ki so na voljo kot globalne spremenljivke copilot Studio.

Spremenljivka Opis
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID zapisa tabele v glavnem obrazcu
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logično ime tabele na glavni strani
Global.PA__Copilot_Model_PageContext.pageContext.pageName Ime glavne strani
Global.PA__Copilot_Model_PageContext.pageContext.pageType Vrsta glavne strani
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Enolično ime aplikacije, ki temelji na modelu

Zapis obrazca lahko Global.PA__Copilot_Model_PageContext.pageContext.id.guidGlobal.PA__Copilot_Model_PageContext.pageContext.entityTypeNamena primer pridobite iz nabora Dataverse.

Dostopanje do »eventParameters«

V temi Copilot Studio lahko do eventParameters klica API-ja dostopate s spremenljivko Activity.Value. Z vozliščem razčlenjenih vrednosti pretvorite JSON v zapis z enim ali več polji. Če izberete Iz vzorčnihpodatkov za podatkovni tip, lahko ustvarite zapis z primerom JSON.

Primer

V programu Microsoft Copilot Studio, kjer je registrirana tema, ki sprejme ID (ID zapisa entitete) kot parameter vnosa. Na podlagi vnosa pridobi povezane dejavnosti tega zapisa entitete in vrne rezultate kot dejavnost dogodka Copilot Studio. API konteksta PCF omogoča izvajanje teh metod v kontekstu kontrolnikov PCF.

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

Kopilot
executePrompt
Sklic na VMESNIK API za ogrodje komponent Power Apps
Pregled ogrodja komponent power apps

  • Last updated on