Jaa

executeEvent (esikatselu)

Tärkeää

  • Tämä on esiversiotoiminto.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Näihin toimintoihin sovelletaan lisäkäyttöehtoja ja ne ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niitä aikaisessa vaiheessa ja antaa palautetta.

Suorittaa Microsoft Copilot Studio -aiheen rekisteröidyn tapahtuman nimen perusteella. Palauttaa tyyppiä MCSResponse olevan matriisin.

Käytettävissä kohteelle

mallipohjaiset sovellukset

Syntaksi

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

Parametrit

Parametrin nimi Type Pakollinen Kuvaus
eventName merkkijono Kyllä Copilot Studio -aiheeseen rekisteröidyn tapahtuman nimi
eventParameters Tuntematon Kyllä Tapahtuman suorittamiseen tarvittavat parametrit. Ne riippuvat siitä, mitä aihe tekee.
successCallback Function Kyllä Funktio, jota kutsutaan, kun toiminto onnistuu.
errorCallback Function Kyllä Funktio, jota kutsutaan, kun toiminto epäonnistuu.

Palautusarvo

Tyyppi: Promise<MCSResponse>

Katso Lupaus ja MCSResponse

Sovelluskontekstin käyttäminen

Kun agentin ohjelmointirajapintaa kutsutaan, sovelluksen konteksti välitetään Copilot Studion aiheeseen muuttujien joukon kautta. Seuraavat ovat kontekstimuuttujat ovat käytettävissä yleisinä Copilot Studio -muuttujina.

Muuttuja Kuvaus
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Päälomakkeen taulukkotietueen tunnus
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Taulukon looginen nimi pääsivulla
Global.PA__Copilot_Model_PageContext.pageContext.pageName Pääsivun nimi
Global.PA__Copilot_Model_PageContext.pageContext.pageType Pääsivun tyyppi
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Mallipohjaisen sovelluksen yksilöllinen nimi

Esimerkiksi käyttämällä Global.PA__Copilot_Model_PageContext.pageContext.id.guid ja Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName,-lomakkeen tietue voidaan noutaa Dataversesta.

EventParameters-tapahtumien käyttäminen

Copilot Studio -aiheessa API-kutsua eventParameters voidaan käyttää muuttujan Activity.Valueavulla . Käytä Jäsennä-arvosolmua JSON-kohteen muuntamiseen tietueeksi, jossa on yksi tai useampi kenttä. Kun valitset tietotyypiksiMallitiedoista, voit luoda tietueen JSON-esimerkin avulla.

Esimerkki:

Microsoft Copilot Studiossa, jossa on rekisteröity aihe, joka hyväksyy syöteparametriksi tunnuksen (entiteetin tietuetunnuksen). Syötteen perusteella se noutaa kyseisen entiteettitietueen liittyvät aktiviteetit ja palauttaa tulokset Copilot Studio -tapahtuman toimintona. PCF-kontekstin ohjelmointirajapinta mahdollistaa näiden menetelmien suorittamisen PCF-ohjausobjektien kontekstissa.

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

Vastaus

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

Lentoperämies
executePrompt
Power Apps -osakehyksen API-tietoja
Power Apps -osakehyksen yleiskatsaus

  • Last updated on