Del via

executeEvent (prøveversion)

Vigtige oplysninger

  • Dette er en prøveversionsfunktion.
  • Prøveversionsfunktioner er ikke beregnet til produktionsbrug og kan have begrænset funktionalitet. Disse funktioner er underlagt supplerende vilkår for anvendelse og er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Udfører et emne i Microsoft Copilot Studio baseret på det registrerede hændelsesnavn. Returnerer en matrix af typen MCSResponse.

Tilgængelig for

Modelbaserede apps

Syntaks

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

Parametre

Parameternavn Type Obligatorisk Beskrivelse
eventName streng Ja Hændelsesnavn registreret i emnet Copilot Studio
eventParameters Ukendt Ja Parametre, der er nødvendige for udførelsen af hændelsen. Disse afhænger af, hvad emnet gør.
successCallback Funktion Ja En funktion, der skal kaldes, når handlingen lykkes.
errorCallback Funktion Ja En funktion, der skal kaldes, når handlingen mislykkes.

Returværdi

Type: Promise<MCSResponse>

Se Promise og MCSResponse

Adgang til appkontekst

Når en Agent API kaldes, overføres konteksten for appen til emnet Copilot Studio via et sæt variabler. Følgende er kontekstvariabler, der er tilgængelige som globale Copilot Studio-variabler.

Variabel Beskrivelse
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Id for tabelposten i hovedformularen
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logisk navn på tabellen på hovedsiden
Global.PA__Copilot_Model_PageContext.pageContext.pageName Navn på hovedsiden
Global.PA__Copilot_Model_PageContext.pageContext.pageType Type af hovedside
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Entydigt navn på den modelbaserede app-designer

Hvis du f.eks. bruger Global.PA__Copilot_Model_PageContext.pageContext.id.guid og Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, kan formularens post hentes fra Dataverse.

Adgang til eventParameters

I emnet eventParameters Copilot Studio kan du få adgang til fra API-kaldet ved hjælp af variablen Activity.Value. Brug Fortolk værdinoden til at konvertere JSON til en post med et eller flere felter. Hvis du vælger Fra eksempeldata for Datatype , kan du angive et JSON-eksempel for at oprette posten.

Eksempel

I Microsoft Copilot Studio, hvor der registreres et emne, der accepterer et id (objektpost-id) som en inputparameter. På baggrund af inputtet henter den de relaterede aktiviteter for den pågældende objektpost og returnerer resultaterne som en Copilot Studio-hændelsesaktivitet. PCF-kontekst-API'en muliggør udførelse af disse metoder i forbindelse med PCF-kontrolelementer.

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

Respons

[
    {
        "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
API-reference til Power Apps Component Framework
Oversigt over Komponentstruktur i Power Apps

  • Last updated on