Bendrinti naudojant

executeEvent (peržiūra)

Svarbu

  • Tai yra peržiūros versijos funkcija.
  • Peržiūros versijos funkcijos nėra skirtos naudoti gamybai ir gali būti apribotas jų funkcionalumas. Šioms funkcijoms taikomos **papildomos naudojimo sąlygos** ir jos prieinamos prieš oficialų išleidimą, kad klientai galėtų gauti išankstinę prieigą ir pateikti atsiliepimus. ...

Vykdo "Microsoft Copilot Studio" temą pagal registruotą įvykio pavadinimą. Grąžina MCSResponse tipo masyvą.

Galima naudoti

Modeliu pagrįstos programos

Sintaksė

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

Parametrus

Parametro pavadinimas Rūšis Privalomas Aprašą
eventName eilutė Taip "Copilot Studio" temoje užregistruotas įvykio pavadinimas
eventParameters Nežinoma Taip Parametrai, reikalingi įvykiui vykdyti. Jie priklauso nuo to, ką daro tema.
successCallback Funkcija Taip Funkcija, kurią reikia iškviesti, kai operacija sėkminga.
errorCallback Funkcija Taip Funkcija, kurią reikia iškviesti, kai operacija nepavyksta.

Grąžinimo reikšmė

Tipas: Promise<MCSResponse>

Žr . Pažadas ir MCSResponse

Prieiga prie taikomosios programos konteksto

Iškvietus agento API, programos kontekstas perduodamas į "Copilot Studio" temą per kintamųjų rinkinį. Toliau pateikiami kontekstiniai kintamieji, galimi kaip "Copilot Studio" visuotiniai kintamieji.

Kintamasis Aprašą
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Pagrindinės formos lentelės įrašo ID
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Pagrindinio puslapio lentelės loginis pavadinimas
Global.PA__Copilot_Model_PageContext.pageContext.pageName Pagrindinio puslapio pavadinimas
Global.PA__Copilot_Model_PageContext.pageContext.pageType Pagrindinio puslapio tipas
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Unikalus modeliu pagrįstos programėlės pavadinimas

Pavyzdžiui, naudojant Global.PA__Copilot_Model_PageContext.pageContext.id.guid ir Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, formos įrašą galima gauti iš "Dataverse".

Prieiga prie eventParameters

"Copilot Studio" temoje API iškvietimą eventParameters galima pasiekti naudojant kintamąjį Activity.Value. Naudokite analizės reikšmių mazgą , kad konvertuotumėte JSON į įrašą su vienu ar daugiau laukų. Pasirinkus Iš duomenų tipopavyzdžių, galima pateikti JSON pavyzdį įrašui sukurti.

Pavyzdys

"Microsoft Copilot Studio", kur užregistruota tema, kuri priima ID (objekto įrašo ID) kaip įvesties parametrą. Atsižvelgiant į įvestį, ji nuskaito susijusią to objekto įrašo veiklą ir pateikia rezultatus kaip "Copilot Studio" įvykio veiklą. PCF konteksto API įgalina šių metodų vykdymą PCF valdiklių kontekste.

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

Atsakas

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

Antrasis pilotas
executePrompt
"Power Apps" komponento sistemos API nuoroda
"Power Apps" komponentų sistemos apžvalga

  • Last updated on