Deli putem

executeEvent (pregled)

Važno

  • Ovo je preliminarna funkcija.
  • Funkcije verzije za pregled nisu namenjene za korišćenje u proizvodnji i možda imaju ograničene funkcionalnosti. Ove funkcije podležu dodatnim uslovima korišćenja i dostupne su pre zvaničnog izdanja, tako da korisnici mogu dobiti rani pristup i pružiti povratne informacije.

Izvršava temu Microsoft Copilot Studio na osnovu registrovanog imena događaja. Daje niz tipa MCSResponse.

Dostupno za

Aplikacije zasnovane na modelu

Sintaksa

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

Parametri

Ime parametra Tip Potrebne Opis
eventName string Da Ime događaja registrovano u temi Copilot Studio
eventParameters Nepoznat Da Parametri potrebni za izvršavanje događaja. To zavisi od toga šta tema radi.
successCallback Function Da Funkcija za pozivanje kada operacija uspe.
errorCallback Function Da Funkcija za pozivanje kada operacija ne uspe.

Povratna vrednost

Tip: Promise<MCSResponse>

Pogledajte Promise i MCSResponse

Pristup kontekstu aplikacije

Kada se zove API agenta, kontekst za aplikaciju se prosleđuje temi Copilot Studio kroz skup promenljivih. Slede kontekstne varijable dostupne kao Copilot Studio globalne varijable.

Promenljiva Opis
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID zapisa tabele na glavnom obrascu
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logično ime tabele na glavnoj stranici
Global.PA__Copilot_Model_PageContext.pageContext.pageName Naziv glavne stranice
Global.PA__Copilot_Model_PageContext.pageContext.pageType Tip glavne stranice
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Jedinstveno ime aplikacije zasnovane na modelu

Na primer, korišćenje Global.PA__Copilot_Model_PageContext.pageContext.id.guid i Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, zapis obrasca se može preuzeti iz usluge Dataverse.

Pristupanjeparametrima događaja

U okviru teme Copilot Studio, eventParameters iz API poziva se može pristupiti pomoću promenljive Activity.Value. Koristite čvor vrednosti raščlanjivanje da biste konvertovali JSON u zapis sa jednim ili više polja. Izbor stavke Od uzorka podataka za tip podataka omogućava obezbeđivanje JSON primera za kreiranje zapisa.

Primer

U programu Microsoft Copilot Studio, gde je registrovana tema koja prihvata ID (ID entitetskog zapisa) kao parametar unosa. Na osnovu unosa, preuzima povezane aktivnosti zapisa tog entiteta i vraća rezultate kao aktivnost događaja Copilot Studio. API konteksta PCF-a omogućava izvršavanje ovih metoda u kontekstu PCF kontrola.

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
Power Apps component framework API referenca
Pregled okvira komponente Power Apps

  • Last updated on