Personnaliser Microsoft 365 Copilot avec un agent

Microsoft 365 Copilot dans Power Apps permet aux utilisateurs d’interagir avec des agents personnalisés qui étendent les capacités de Copilot. 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 365 Copilot.

Cet article décrit les types d’agents que vous pouvez créer pour Microsoft 365 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 365 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 à générer dans Microsoft 365 Copilot vue d’ensemble des agents.
Créez un agent déclaratif pour Microsoft 365 Copilot ou un agent de moteur personnalisé pour Microsoft 365.
Utilisez Microsoft Copilot Studio pour vous connecter et configurer un agent pour Teams et Microsoft 365 afin qu'il soit disponible dans Microsoft 365 Copilot.
Passez en revue les conseils sur la façon de choisir entre Microsoft 365 Copilot et Copilot Studio pour générer votre agent.

Une façon de créer un agent déclaratif pour une application pilotée par modèle consiste à activer Microsoft 365 Copilot directement dans votre application. Pour plus d’informations, consultez Activer votre application pour Microsoft 365 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 365 Copilot personnalisée qui s’ouvre pour les utilisateurs, et les API créent la connexion bidirectionnelle entre votre application et Microsoft 365 Copilot.

Définir un agent par défaut

Si vous générez 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 365 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 365 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 spécifique à l’application Microsoft 365 Copilot que vous souhaitez que les utilisateurs aient.

Xrm.API Copilot

Les Xrm.Copilot.* API clientes permettent aux développeurs d’intégrer Microsoft 365 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 365 Copilot et répondre aux actions pilotées par Microsoft 365 Copilot, afin de créer des scénarios agentiques de bout en bout plus riches.

Utilisées avec un agent par défaut, ces API complètent le modèle de mode agent : votre agent est le point de départ, votre application peut envoyer des invites et du contexte à Microsoft 365 Copilot, et Microsoft 365 Copilot peut invoquer des actions dans 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 :

Envoyez des invites à Microsoft 365 Copilot. Utilisez sendPromptToM365Copilot pour démarrer une interaction avec Microsoft 365 Copilot à partir de votre application.
Ouvrez et contrôlez le volet latéral Microsoft 365 Copilot. Utilisez cette option openM365CopilotPanel pour vous assurer que le volet Microsoft 365 Copilot est visible si nécessaire.
Passez le contexte de l’application à Microsoft 365 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 Microsoft 365 Copilot actions dans votre application. Utilisez addActionHandler pour enregistrer des gestionnaires personnalisés qui traitent les actions envoyées depuis les réponses de Microsoft 365 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 365 Copilot avec addActionHandler

Utilisez l’API addActionHandler lorsque votre application doit gérer des actions structurées qui Microsoft 365 Copilot émet.

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 365 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 365 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 ?

Last updated on 2026-07-16