Partager via

executeEvent (version préliminaire)

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Exécute une rubrique Microsoft Copilot Studio en fonction du nom de l’événement enregistré. Renvoie un tableau de type MCSResponse.

Disponible pour

Applications pilotées par modèle

Syntaxe

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

Paramètres

Nom du paramètre Type Requise Description
eventName chaine Oui Nom de l’événement enregistré dans la rubrique Copilot Studio
eventParameters Inconnu Oui Paramètres nécessaires à l’exécution de l’événement. Ceux-ci dépendent de ce que fait la rubrique.
successCallback Function Oui Fonctionnalité à appeler lorsque l’opération aboutit.
errorCallback Function Oui Fonction à appeler lorsque l’opération échoue.

Valeur renvoyée

Type : Promise<MCSResponse>

Voir Promesse et MCSResponse

Accès au contexte de l’application

Lorsqu’une API d’agent est appelée, le contexte de l’application est transmis à la rubrique Copilot Studio par le biais d’un ensemble de variables. Voici les variables de contexte disponibles en tant que variables globales Copilot Studio.

Variable Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID de l’enregistrement de table dans le formulaire principal
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Nom logique de la table dans la page principale
Global.PA__Copilot_Model_PageContext.pageContext.pageName Nom de la page principale
Global.PA__Copilot_Model_PageContext.pageContext.pageType Type de la page principale
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Nom unique de l’application pilotée par modèle

Par exemple, à l’aide de Global.PA__Copilot_Model_PageContext.pageContext.id.guid et de Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, l’enregistrement du formulaire peut être récupéré de Dataverse.

Accès à eventParameters

Dans la rubrique Copilot Studio, le paramètre eventParameters de l’appel d’API est accessible à l’aide de la variable Activity.Value. Utilisez le nœud Analyser la valeur pour convertir le JSON en un enregistrement avec un ou plusieurs champs. Sélectionnez À partir des exemples de données pour Type de données pour fournir un exemple de JSON pour créer l’enregistrement.

Exemple

Dans Microsoft Copilot Studio, où une rubrique est enregistrée qui accepte un ID (ID d’enregistrement d’entité) comme paramètre d’entrée. En fonction de l’entrée, il récupère les activités associées de cet enregistrement d’entité et renvoie les résultats en tant qu’activité d’événement Copilot Studio. L’API de contexte PCF permet l’exécution de ces méthodes dans le cadre des contrôles PCF.

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
Référence des API Power Apps component framework
Vue d'ensemble de Power Apps component framework

  • Last updated on