Partager via

Convertir votre agent déclaratif en agent de moteur personnalisé

Microsoft 365 Copilot fournit une fonctionnalité de migration qui vous permet de convertir des agents déclaratifs, y compris des extensions de message qui ont été promues en agents déclaratifs, en agents de moteur personnalisé. Lorsque vous convertissez votre agent déclaratif en agent de moteur personnalisé, vous avez le contrôle total de l’orchestration, des modèles IA et des intégrations de données, et vous pouvez tirer parti des fonctionnalités avancées pour créer des workflows plus sophistiqués.

Cet article décrit les étapes à suivre pour convertir un agent déclaratif en agent de moteur personnalisé afin de tirer parti de votre propre orchestration afin de mieux répondre aux besoins uniques de votre organization.

Configuration requise

Les étapes décrites dans cet article nécessitent les prérequis suivants :

  • Agent déclaratif existant créé avec microsoft 365 Agents Toolkit.

    Remarque

    Les agents créés à l’aide de Microsoft 365 Copilot ne sont pas pris en charge actuellement.

  • Un bot personnalisé et l’ID du bot. Pour plus d’informations sur la création d’un bot personnalisé, consultez Bots et agents.

  • Visual Studio Code avec l’extension Microsoft 365 Agents Toolkit installée.

  • Le Microsoft 365 Agents SDK ou le Kit de développement logiciel (SDK) Teams, si vous souhaitez implémenter des fonctionnalités spécifiques à Copilot, telles que le streaming ou les citations.

  • Autorisations pour charger des manifestes d’application dans votre environnement.

Convertir votre agent déclaratif

Pour convertir votre agent déclaratif existant en agent de moteur personnalisé, vous effectuez des mises à jour de votre manifeste d’application et de votre package d’application.

Mettre à jour le manifeste de l’application

Pour mettre à jour le manifeste de votre application :

  1. Dans Visual Studio Code, ouvrez le fichier manifeste de l’application pour votre agent déclaratif.

  2. Ajoutez un nœud bots et incluez votre ID de bot dans le champ ID . L’exemple suivant montre le schéma du nœud bots .

        "bots": [ 
        { 
            "botId": "${{BOT_ID}}", 
            "scopes": [ 
                "copilot", 
                "personal", 
                "team" 
            ], 
            "supportsFiles": false, 
            "isNotificationOnly": false, 
            "commandLists": [ 
                { 
                    "scopes": [ 
                        "copilot", 
                        "personal" 
                    ], 
                    "commands": [ 
                        { 
                            "title": "How can you help me?", 
                            "description": "How can you help me?" 
                        } 
                    ] 
                } 
            ] 
        } 
    ],

    Pour plus d’informations sur le schéma du nœud bots, consultez objet bots.

    Remarque

    Utilisez le schéma de manifeste d’application version 1.21 ou ultérieure. Les agents de moteur personnalisé sont pris en charge dans le manifeste version 1.21 et les versions ultérieures.

  3. Dans l’objet copilotAgents, remplacez le nœud declarativeAgents par un nœud customEngineAgents , comme illustré dans les exemples suivants.

    Nœud agents déclaratifs

    "copilotAgents": { 
    "declarativeAgents": [             
        { 
            "id": "declarativeAgent", 
            "file": "declarativeAgent.json" 
        } 
    ] 
},

    Remplacer par un nœud d’agents de moteur personnalisé

    "copilotAgents": {
    "customEngineAgents": [
        {
            "type": "bot",
            "id": "${{BOT_ID}}"
        }
    ]
},
"bots": [
    { 
      "botId": "${{BOT_ID}}",
        "scopes": [
            "copilot",
            "personal",
            "team"
        ], 
        "supportsFiles": false,
        "isNotificationOnly": false,
        "commandLists": [
            {
                "scopes": [
                    "copilot",
                    "personal"
                ],
                "commands": [
                    {
                        "title": "How can you help me?",
                        "description": "How can you help me?"
                    }
                ]
            }
        ]
    }
],

    Pour obtenir des informations de référence sur le schéma, consultez l’objet copilotAgents.

    Remarque

    Votre manifeste d’application peut inclure un nœud d’agent déclaratif ou un nœud d’agent de moteur personnalisé, mais pas les deux.

  4. Mettez à jour le numéro de version de votre application dans la propriété version .

  5. Vérifiez que la propriété id utilise le même ID que celui que vous avez utilisé dans le manifeste de l’application pour l’agent déclaratif.

Personnaliser l’expérience utilisateur de votre agent

Définissez votre expérience d’agent pour les utilisateurs. Vous pouvez ajouter des starters de conversation et des invites suggérées, implémenter des réponses et des citations en streaming, etc. Notez que vous devez définir et tester les fonctionnalités de votre agent de moteur personnalisé.

Pour plus d’informations, consultez Fonctionnalités de l’expérience utilisateur de l’agent de moteur personnalisé.

Mettre à jour et envoyer votre package d’application

Après avoir mis à jour le manifeste de votre agent, repackagez votre application :

  1. Ajoutez votre manifeste d’agent mis à jour, l’icône d’application et toutes les autres ressources à un nouveau fichier .zip.

  2. Envoyez le nouveau package pour mettre à jour votre application existante. Si votre agent est interne à votre organization, utilisez le Centre d’administration Microsoft 365 (nécessite des autorisations d’administrateur client).

    Remarque

    La soumission de votre package d’application à la Place de marché commerciale via l’Espace partenaires n’est pas prise en charge actuellement.

Expérience utilisateur

La transition d’un agent déclaratif à un agent de moteur personnalisé est transparente pour l’utilisateur. Si le nom et le logo que vous utilisez dans votre package d’application sont identiques, les utilisateurs ne voient aucune modification visible.

Si les utilisateurs ont épinglé l’agent, ils doivent épingler à nouveau l’agent après la publication de la mise à jour.

Contenu connexe

  • Last updated on