Personnaliser Microsoft Copilot avec un agent

Microsoft Copilot dans Power Apps permet aux utilisateurs d’interagir avec des agents personnalisés qui étendent ce que Copilot peut faire. En personnalisant un agent, vous pouvez créer des expériences personnalisées qui correspondent aux processus et données métier de votre organisation. Pour plus d’informations, consultez Utiliser des agents dans Microsoft Copilot.

Cet article décrit les types d’agents que vous pouvez créer pour Microsoft Copilot dans Power Apps et vous aide à choisir l’approche appropriée pour votre scénario.

Choisir un type d’agent

Le tableau suivant compare les types d’agents que vous pouvez générer.

Type d’agent	Description	Cas d’utilisation courants
Agent déclaratif	Conçu avec des outils et des modèles à faible code pour configurer rapidement des scénarios courants dans Microsoft Copilot.	Automatisez les tâches de routine, répondez aux questions fréquentes et fournissez des flux de travail guidés.
Assistant de moteur personnalisé	Conçu avec une logique et des intégrations personnalisées pour des fonctionnalités avancées adaptées à votre entreprise.	Processus métier complexes, intégrations de données personnalisées et automatisation spécialisée.
agent de Copilot Studio	Intégré et géré dans Microsoft Copilot Studio, avec intégration à Teams et Microsoft 365 pour les expériences conversationnelles.	Chatbots interactifs, collaboration d’équipe et support personnalisé dans les applications Microsoft 365.

Pour trouver la meilleure option pour votre organisation, utilisez ces ressources :

Obtenez une vue d’ensemble et des conseils sur la façon de choisir le type d’agent à créer dans Vue d’ensemble des agents Microsoft Copilot.
Créez un agent déclaratif pour Microsoft Copilot ou un agent de moteur personnalisé pour Microsoft 365.
Utilisez Microsoft Copilot Studio pour connecter et configurer un agent pour Teams et Microsoft 365 afin qu'il soit disponible dans Microsoft Copilot.
Passez en revue les conseils sur la façon de choisir entre Microsoft Copilot et Copilot Studio pour créer votre agent.

Une façon de créer un agent déclaratif pour une application pilotée par modèle consiste à activer Microsoft Copilot directement dans votre application. Pour plus d’informations, consultez Activation de votre application pour Microsoft Copilot.

Vous pouvez créer votre propre mode d’agent spécifique à l’application dans Power Apps en combinant un agent par défaut avec les Xrm.Copilot.* API. L’agent par défaut définit l’expérience de Microsoft Copilot personnalisée qui s’ouvre pour les utilisateurs, et les API créent la connexion bidirectionnelle entre votre application et Microsoft Copilot.

Définir un agent par défaut

Si vous créez un agent personnalisé en tant que compagnon de votre application pilotée par modèle, vous pouvez le définir comme agent par défaut afin qu’il se charge automatiquement lorsque l’application et le volet latéral Microsoft Copilot s’ouvrent. Cela rend votre agent le point de départ de l’expérience et constitue la première partie de la création de votre propre mode agent.

Lorsque vous définissez un agent par défaut :

Votre agent est sélectionné sans aucune action de l’utilisateur.
Les utilisateurs accèdent directement à l’expérience personnalisée que vous avez conçue pour l’application.
Les flux de travail et conseils spécifiques à l’application sont prêts dès que Microsoft Copilot s’ouvre.

Un agent par défaut est particulièrement utile pour les agents axés sur les scénarios qui étendent l’expérience principale de l’application et agissent comme porte d’entrée de l’expérience de Microsoft Copilot spécifique à l’application que vous souhaitez que les utilisateurs aient.

Xrm.API Copilot

Les Xrm.Copilot.* API côté client permettent aux développeurs d’intégrer Microsoft Copilot directement dans les expériences d’application basées sur des modèles. Avec ces API, votre application peut interagir directement avec le volet latéral Microsoft Copilot et répondre aux actions pilotées par Microsoft Copilot, afin de créer des scénarios agentiques de bout en bout plus riches.

Lorsque vous utilisez ces API avec un assistant par défaut, elles complètent le modèle du mode assistant : votre assistant constitue le point de départ, votre application peut envoyer des requêtes et du contexte à Microsoft Copilot, et Microsoft Copilot peut déclencher des actions au sein de votre application.

Pour obtenir la surface complète de l’API, consultez Xrm.Copilot (référence de l’API cliente) dans les applications basées sur des modèles.

Ces API vous permettent de :

Envoyer des prompts à Microsoft Copilot. Utilisez sendPromptToM365Copilot pour démarrer une interaction Microsoft Copilot à partir de votre application.
Ouvrez et contrôlez le volet latéral Microsoft Copilot. Utilisez cette option openM365CopilotPanel pour vous assurer que le volet Microsoft Copilot est visible si nécessaire.
Passez le contexte de l’application à Microsoft Copilot. Utilisez updateContext (version préliminaire) pour envoyer des signaux de contextualisation supplémentaires depuis votre application.
Collaborez avec des agents. Utilisez getCurrentAgent pour vérifier quel agent est actif.
Gérez les actions de Microsoft Copilot dans votre application. Utilisez addActionHandler pour inscrire des gestionnaires personnalisés qui traitent les actions envoyées à partir des réponses de Microsoft Copilot.

Ensemble, ces API créent une expérience bidirectionnelle réelle entre l’interface utilisateur de l’application et l’agent, afin que les agents puissent générer des mises à jour de l’interface utilisateur, déclencher des flux de travail ou exécuter une logique métier personnalisée.

Gérer les actions Microsoft Copilot avec addActionHandler

Utilisez l’API addActionHandler lorsque votre application doit gérer des actions structurées émises par Microsoft Copilot.

Lorsque vous générez la charge utile d’action :

Définissez type sur PowerApps pour cibler l’hôte Power Apps.
Définissez action sur l’actionId que vous enregistrez dans MyNamespace.MyMessage (par exemple, addActionHandler).
Utilisez actionData pour la charge utile que votre code traite et transmet à l’hôte Power Apps.

Les sections suivantes présentent deux scénarios pris en charge.

Cartes adaptatives

Les réponses de Microsoft Copilot peuvent inclure des Cartes adaptatives avec des boutons Action.Submit qui envoient des messages d’action à l’hôte Power Apps.

Exemple :

{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Click Go and I will send data to the host to process.",
      "wrap": true,
      "id": "txtSendMessage"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Go",
          "id": "btnGo",
          "data": {
            "type": "PowerApps",
            "action": "MyNamespace.MyMessage",
            "actionData": {
              "foo": "bar"
            }
          }
        }
      ]
    }
  ]
}

Applications MCP

Les réponses de Microsoft Copilot peuvent inclure du code HTML qui envoie des messages d’action à l’hôte Power Apps.

Exemple :

<Button
  appearance="outline"
  icon={<ArrowLeft24Regular />}
  onClick={() => {
    try {
      const message = {
        eventName: 'powerapps.copilot.chat.action',
        action: 'MyNamespace.MyMessage',
        actionData: {
          foo: 'bar'
        },
      };
      window.parent.parent.postMessage(message, '*');
    } catch (error) {
      // eslint-disable-next-line no-console
      console.error('Error posting HOST_ACTION message to parent window:', error);
    }
  }}
>
  Test
</Button>

Limitations

Les agents que vous créez ne peuvent pas encore utiliser le contexte utilisateur dans l’application pour adapter leurs réponses.
Lors de la définition d’un agent par défaut, les invites de démarrage de l’agent ne s’affichent pas.

Commentaires

Cette page a-t-elle été utile ?

Dernière mise à jour : 2026-10-10