Kopīgot, izmantojot

executeEvent (priekšskatījums)

Svarīgi

  • Šis ir priekšskatījuma līdzeklis.
  • Priekšskatījuma līdzekļi nav paredzēti komerciālai lietošanai, un to funkcionalitāte var būt ierobežota. Uz šīm funkcijām attiecas papildu lietošanas noteikumi, un tās ir pieejamas pirms oficiālās izlaišanas, lai klienti varētu iegūt agrīnu piekļuvi un sniegt atsauksmes.

Izpilda Microsoft Copilot Studio tēmu, pamatojoties uz reģistrēto notikuma nosaukumu. Atgriež MCSResponse tipa masīvu.

Pieejams

Modeļa vadītas programmas

Sintakse

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

Parameters

Parametra nosaukums Tips Nepieciešams Apraksts
eventName virkne Jā Notikuma nosaukums reģistrēts Copilot Studio tēmā
eventParameters Nepazīstams Jā Notikuma izpildei nepieciešamie parametri. Tie ir atkarīgi no tā, ko tēma dara.
successCallback Function Jā Funkcija, kas jāizsauc, kad operācija ir veiksmīga.
errorCallback Function Jā Funkcija, kas jāizsauc, ja operācija neizdodas.

Atgrieztā vērtība

Tips: Promise<MCSResponse>

Skatīt solījumu un MCSResponse

Piekļuve lietotnes kontekstam

Kad tiek izsaukts aģenta API, programmas konteksts tiek nodots Copilot Studio tēmai, izmantojot mainīgo kopu. Tālāk ir norādīti konteksta mainīgie, kas pieejami kā Copilot Studio globālie mainīgie.

Mainīgais Apraksts
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Tabulas ieraksta ID galvenajā veidlapā
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Tabulas loģiskais nosaukums galvenajā lapā
Global.PA__Copilot_Model_PageContext.pageContext.pageName Galvenās lapas nosaukums
Global.PA__Copilot_Model_PageContext.pageContext.pageType Galvenās lapas veids
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Modeļa vadītas programmas unikālais nosaukums

Piemēram, izmantojot Global.PA__Copilot_Model_PageContext.pageContext.id.guid un Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, veidlapas ierakstu var izgūt no Dataverse.

Piekļuve eventParameters

Copilot Studio tēmā no API zvana var piekļūt, eventParameters izmantojot mainīgo .Activity.Value Izmantojiet Parse vērtības mezglu , lai pārvērstu JSON par ierakstu ar vienu vai vairākiem laukiem. Atlasot Datuparauga datus vienumam Datu tips , ieraksta izveidei var sniegt JSON piemēru.

Piemērs

Microsoft Copilot Studio, kur ir reģistrēta tēma, kas pieņem ID (entītijas ieraksta ID) kā ievades parametru. Pamatojoties uz ievadi, tas izgūst šī entītijas ieraksta saistītās darbības un atgriež rezultātus kā Copilot Studio notikuma darbību. PCF konteksta API ļauj izpildīt šīs metodes PCF kontroles kontekstā.

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

Atbilde

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

Otrais pilots
executePrompt
Power Apps komponentu struktūras API atsauce
Power Apps komponentu struktūras pārskats

  • Last updated on