Dijeli putem

executeEvent (pretpregled)

Važno

  • To je značajka pretpregleda.
  • Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te značajke podliježu dodatnim uvjetima korištenja i dostupne su prije službenog izdanja kako bi korisnici mogli dobiti rani pristup i dati povratne informacije.

Izvršava temu rješenja Microsoft Copilot Studio na temelju registriranog naziva događaja. Vraća polje vrste MCSResponse.

Dostupno za

Aplikacije stvorene prema modelu

Sintaksa

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

Parametri

Naziv parametra Tip Obvezno Opis
eventName niz Da Naziv događaja registriran u temi Copilot Studio
eventParameters Nepoznato Da Parametri potrebni za izvršavanje događaja. One ovise o tome što tema radi.
successCallback Function Da Funkcija koja se poziva kada operacija uspije.
errorCallback Function Da Funkcija za pozivanje kada operacija ne uspije.

Povratna vrijednost

Vrsta: Promise<MCSResponse>

Pogledajte Promise i MCSResponse

Pristup kontekstu aplikacije

Kada se API agenta poziva, kontekst za aplikaciju prosljeđuje se temi rješenja Copilot Studio putem skupa varijabli. U nastavku su navedene kontekstne varijable dostupne kao globalne varijable rješenja Copilot Studio.

Varijabla Opis
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID zapisa tablice na glavnom obrascu
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logički naziv tablice na glavnoj stranici
Global.PA__Copilot_Model_PageContext.pageContext.pageName Naziv glavne stranice
Global.PA__Copilot_Model_PageContext.pageContext.pageType Vrsta glavne stranice
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Jedinstveni naziv aplikacije utemeljene na modelu

Na primjer, korištenje Global.PA__Copilot_Model_PageContext.pageContext.id.guid i Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, zapis obrasca može se dohvatiti iz dataverse.

Pristup događajimaParametri

U sklopu teme Copilot Studio, eventParameters iz API poziva može se pristupiti pomoću varijable Activity.Value. Pomoću čvora vrijednosti raščlanjivanja pretvorite JSON u zapis s jednim ili više polja. Odabirom oglednih podatakaza vrstu podataka omogućuje se stvaranje zapisa pomoću primjera JSON-a.

Primjer

U programu Microsoft Copilot Studio, gdje je registrirana tema koja prihvaća ID (ID zapisa entiteta) kao ulazni parametar. Na temelju ulaza dohvaća povezane aktivnosti tog zapisa entiteta i vraća rezultate kao aktivnost događaja Copilot Studio. API konteksta PCF-a omogućuje izvođenje tih metoda u kontekstu PCF kontrola.

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

Odgovor

[
    {
        "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
Referenca za API komponente komponente Power Apps
Pregled komponente Power Apps

  • Last updated on