Del via

executeEvent (forhåndsvisning)

Viktig!

  • Dette er en forhåndsvisningsfunksjon.
  • Forhåndsvisningsfunksjoner er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er underlagt ekstra vilkår for bruk, og er tilgjengelige før en offisiell utgivelse, slik at kundene kan få tidlig tilgang og gi tilbakemelding.

Utfører et Microsoft Copilot Studio-emne basert på det registrerte hendelsesnavnet. Returnerer en matrise av typen MCSResponse.

Tilgjengelig for

Modelldrevne apper

Syntaks

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

Parametere

Parameternavn Type Obligatorisk Description
eventName streng Ja Hendelsesnavn registrert i Copilot Studio-emnet
eventParameters Ukjent Ja Parametere som kreves for kjøring av hendelsen. Disse avhenger av hva emnet gjør.
successCallback Function Ja En funksjon som skal kalles når operasjonen er vellykket.
errorCallback Function Ja En funksjon som skal kalles når operasjonen mislykkes.

Returverdi

Type: Promise<MCSResponse>

Se Promise og MCSResponse

Få tilgang til appkontekst

Når en agent-API kalles, sendes konteksten for appen til Copilot Studio-emnet gjennom et sett med variabler. Følgende er kontekstvariabler som er tilgjengelige som globale Copilot Studio-variabler.

Variabel Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID-en til tabellposten i hovedskjemaet
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logisk navn på tabellen på hovedsiden
Global.PA__Copilot_Model_PageContext.pageContext.pageName Navnet på hovedsiden
Global.PA__Copilot_Model_PageContext.pageContext.pageType Typen for hovedsiden
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Unikt navn for den modelldrevne appen

Hvis du for eksempel bruker Global.PA__Copilot_Model_PageContext.pageContext.id.guid og Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, kan skjemaets post hentes fra Dataverse.

Få tilgang til eventParameters

I Copilot Studio-emnet eventParameters kan du få tilgang til fra API-kallet ved hjelp av variabelen Activity.Value. Bruk Analyser verdinode til å konvertere JSON til en post med ett eller flere felt. Hvis du velger Fra eksempeldata for datatype , kan du gi et JSON-eksempel for å opprette posten.

Eksempel

I Microsoft Copilot Studio, der et emne er registrert som godtar en ID (enhetspost-ID) som inndataparameter. Basert på inndataene henter den relaterte aktiviteter for denne enhetsposten og returnerer resultatene som en Copilot Studio-hendelsesaktivitet. API-en for PCF-kontekst muliggjør kjøring av disse metodene i konteksten til PCF-kontroller.

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

Copilot
executePrompt
API-referanse for power apps-komponentrammeverket
Oversikt over komponentrammeverket for Power Apps

  • Last updated on