Freigeben über

executeEvent (Vorschauversion)

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschauversion sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen unterliegen den ergänzenden Nutzungsbedingungen und stehen vor dem offiziellen Release zur Verfügung, damit die Kundschaft frühen Zugriff darauf erhalten und Feedback geben können.

Führt ein Microsoft Copilot Studio Thema basierend auf dem registrierten Ereignisnamen aus. Gibt das Array vom Typ MCSResponse zurück.

Verfügbar für

Modellbasierte Apps

Syntax

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

Parameter

Parametername typ Erforderlich Eigenschaft
eventName string Ja Der Ereignisname, der im Copilot Studio Thema registriert ist
eventParameters Unknown Ja Parameter, die für die Ausführung des Ereignisses benötigt werden. Diese hängen davon ab, was das Thema tut.
successCallback Function Ja Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich war.
errorCallback Function Ja Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Typ: Promise<MCSResponse>

Informationen finden Sie unter Promise und MCSResponse

Zugreifen auf App-Kontext

Wenn eine Agent-API aufgerufen wird, wird der Kontext für die App über einen Variablensatz an das Copilot Studio Thema übergeben. Im Folgenden sind Kontextvariablen aufgeführt, die als Copilot Studio globale Variablen verfügbar sind.

Variable Eigenschaft
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID des Tabellendatensatzes auf dem Hauptformular
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logischer Name der Tabelle in der Hauptseite
Global.PA__Copilot_Model_PageContext.pageContext.pageName Der Name der Hauptseite
Global.PA__Copilot_Model_PageContext.pageContext.pageType Typ der Hauptseite
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Eindeutigwer Name der modellgesteuerten App

Beispielsweise kann der Datensatz des Formulars mithilfe von Global.PA__Copilot_Model_PageContext.pageContext.id.guid und Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName von Dataverse abgerufen werden.

Zugriff auf eventParameters

Innerhalb des Copilot Studio Themas kann auf die eventParameters über den API-Aufruf mithilfe der Variablen Activity.Value zugegriffen werden. Verwenden Sie den Wertkniten parsen, um das JSON in einen Datensatz mit einem oder mehreren Feldern zu konvertieren. Wenn Sie die Option Aus Beispieldaten für Datentyp auswählen, können Sie ein JSON-Beispiel zum Erstellen des Datensatzes bereitstellen.

Beispiel

In Microsoft Copilot Studio, wo ein Thema registriert ist, das eine ID (Entitätsdatensatz-ID) als Eingabeparameter akzeptiert. Basierend auf der Eingabe ruft es die zugehörigen Aktivitäten dieses Entitätsdatensatzes ab und gibt die Ergebnisse als Copilot Studio Ereignisaktivität zurück. Die PCF Kontext-API ermöglicht die Ausführung dieser Methoden im Kontext von PCF-Steuerelementen.

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

Antworten

[
    {
        "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
Power Apps Component Framework-API-Referenz
Power Apps component framework Übersicht

  • Last updated on