Les agents Copilot sont des applications pour Microsoft 365

Lorsque vous créez un agent Copilot, vous créez également une application pour Microsoft 365. Les applications pour Microsoft 365 partagent un schéma de manifeste et un format d’empaquetage communs, ainsi que des processus et des outils de distribution et de gestion unifiés. Le résultat final est que vos applications et agents Copilot atteignent le public le plus large possible et apparaissent en contexte dans le flux de travail de vos utilisateurs.

Cet article vous guide tout au long des principales parties du modèle d’application Microsoft 365 pour le développement de l’agent Copilot.

Modèle d’application pour Microsoft 365

L’écosystème Microsoft 365 évolue en une plateforme d’application intégrée, où vous pouvez utiliser un modèle d’application commun pour définir et empaqueter votre application. Ce qui a commencé comme un moyen d’étendre les applications Teams à exécuter dans d’autres applications Microsoft 365 s’est depuis étendu pour prendre en charge la distribution des connecteurs Microsoft Graph, descompléments Outlook et maintenant des agents Copilot.

Package de l’application

Le package d’application pour Microsoft 365, y compris les agents Copilot, est un fichier zip qui contient un ou plusieurs fichiers de configuration (manifeste) et les icônes de votre application. Votre logique d’application et votre stockage de données sont hébergés ailleurs et accessibles par l’application hôte Microsoft 365 via HTTPS. Vous allez soumettre le package d’application à votre administrateur pour le publier sur votre organization ou à l’Espace partenaires pour le publier sur Microsoft AppSource.

Au minimum, un package d’application contient :

• le manifeste de l’application (manifest.json), qui décrit la configuration de l’application, les fonctionnalités, les ressources requises et les attributs importants,
• une grande icône de couleur (color.png), une icône 92 x 92 couleurs pour afficher votre agent dans l’interface utilisateur et le magasin Microsoft Copilot, et
• une petite icône de plan (outline.png), une icône 32 x 32 avec arrière-plan transparent (actuellement non utilisée dans Copilot, mais requise pour réussir la validation)

Le package d’application peut également contenir des définitions d’agent déclaratif et de plug-in d’API, ainsi que des fichiers de localisation pour d’autres langues prises en charge.

Icônes d’application

Votre package d’application doit inclure à la fois une version couleur et hiérarchique de l’icône de votre application, comme .png fichiers. Ces icônes ont des exigences de taille spécifiques pour réussir la validation du magasin.

Pour obtenir des conseils de conception supplémentaires sur les icônes de couleur et de plan pour le package d’application Microsoft 365, icônes d’application pour le Store Teams et barre de l’application.

Icône de couleur

L’icône de couleur représente votre agent dans l’interface utilisateur Microsoft Copilot et les magasins d’applications dans le produit (Teams, Outlook, Microsoft 365).

Icône de contour

L’icône de plan est utilisée pour représenter les applications épinglées et/ou actives dans la barre de l’application Teams. Il n’est actuellement pas utilisé pour les agents Copilot, mais il est toujours nécessaire pour que le package d’application réussisse la validation.

Manifeste d'application

Le manifeste de l’application pour Microsoft 365 est un fichier JSON qui décrit les fonctionnalités et les caractéristiques de votre application. À la base, le manifeste d’application pour Microsoft 365 est le schéma de création d’applications Teams, mais il a depuis développé (depuis la version 1.13) pour définir des applications qui s’exécutent sur des hôtes Microsoft 365, en plus de Teams.

Si vous utilisez Microsoft Copilot Studio pour générer un agent déclaratif, le manifeste d’application est généré pour vous en fonction des informations que vous fournissez pendant le processus de création.

Chaque manifeste d’application doit inclure les informations suivantes :

L’exemple suivant montre un manifeste d’application avec des sections d’espace réservé à la fin pour les fonctionnalités d’extension de message et d’application d’agent déclaratif :

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.18/MicrosoftTeams.schema.json",
    "manifestVersion": "1.18",
    "version": "1.0.0",
    "id": "00000000-0000-0000-0000-000000000000",
    "developer": {
        "name": "Northwind Traders",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/termofuse",
        "termsOfUseUrl": "https://www.example.com/privacy"
    },
    "icons": {
        "color": "Northwind-Logo-196.png",
        "outline": "Northwind-Logo-32.png"
    },
    "name": {
        "short": "Northwind Inventory",
        "full": "Northwind Inventory App"
    },
    "description": {
        "short": "App allows you to find and update product inventory information",
        "full": "Northwind Inventory is the ultimate tool for managing your product inventory. With its intuitive interface and powerful features, you'll be able to easily find your products by name, category, inventory status, and supplier city. You can also update inventory information with the app."
    },
    "accentColor": "#3690E9",
    "composeExtensions": {
        ...
    },
    "copilotAgents": {
        ...
    }
}

Pour plus d’informations, consultez les informations de référence sur le schéma du manifeste de l’application en préversion pour les développeurs.

copilotAgents Définitions

Les agents déclaratifs et les plug-ins d’API ont chacun leurs propres schémas de définition. Le fichier de définition d’un agent déclaratif est référencé à partir de l’objet copilotAgents du manifeste de l’application.

L’exemple suivant montre comment référencer un agent déclaratif :

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

La définition d’un plug-in d’API est référencée à partir de la définition de l’agent déclaratif.

Notez également ce qui suit:

• Actuellement, une seule définition d’agent déclaratif est prise en charge par manifeste d’application. Un seul plug-in d’API est pris en charge par agent déclaratif.

• Lorsque vous utilisez Copilot Studio pour générer des agents Copilot, un unique id est généré pour chacun, dans le cadre de la génération globale du manifeste d’application. Lorsque vous créez des agents avec Teams Toolkit ou votre propre IDE, vous attribuez vous-même, id selon vos propres conventions ou votre nom convivial.

Manifeste de l’agent déclaratif

Le manifeste de l’agent déclaratif inclut des instructions pour les réponses Copilot, les invites d’exemples de démarrage de conversation, les sources de données utilisées pour la mise à la terre et une liste d’actions (compétences de plug-in d’API) que l’agent est en mesure d’effectuer.

Pour plus d’informations, consultez Schéma de manifeste d’agent déclaratif pour Microsoft 365 Copilot.

Manifeste du plug-in d’API

Le manifeste du plug-in d’API décrit les fonctionnalités du plug-in, notamment les API qu’il prend en charge et les opérations qu’il peut effectuer. Il inclut également des métadonnées telles que le nom, la description, la version et une référence à la définition OpenAPI des API REST avec lesquelles il interagit. Les plug-ins d’API peuvent être référencés à partir d’un manifeste d’agent déclaratif à utiliser dans l’expérience de l’agent déclaratif.

Pour plus d’informations, consultez Schéma de manifeste de plug-in d’API pour Microsoft 365 Copilot.

Localisation de votre agent

La façon dont vous localisez un agent Copilot est légèrement différente de la façon dont vous localisez d’autres fonctionnalités (telles que les onglets, les bots et les extensions de message) dans le manifeste de l’application.

Vous utiliserez le même fichier de localisation (par langue) pour les fonctionnalités d’application Teams classiques et l’agent Copilot. Toutefois, alors que tous les autres champs de manifeste d’application sont référencés à l’aide d’expressions JSONPath dans les fichiers de langage, les champs liés à l’agent Copilot sont simplement référencés à l’aide de clés de dictionnaire. Contrairement aux fonctionnalités d’application Teams classiques, qui utilisent des chaînes de langue par défaut dans le manifeste de l’application lui-même, les agents Copilot localisés nécessitent un fichier de langue pour la langue par défaut ainsi que pour chaque langue supplémentaire.

Les étapes suivantes montrent comment prendre en charge des langues supplémentaires (au-delà de la valeur par défaut) pour vos agents Copilot.

1. Mettre à jour vos manifestes d’agent Copilot avec des clés tokenisées

Mettez à jour vos manifestes d’agent déclaratif et/ou de plug-in d’API avec des clés tokenisées (indiquées par des crochets doubles, par exemple [[PLUGIN_NAME]]) pour toutes les valeurs de champ que vous souhaitez localiser. Les clés de localisation correspondent beaucoup à cette expression régulière : ^[a-zA-Z_][a-zA-Z0-9_]*$

L’exemple suivant montre un manifeste d’agent déclaratif avec des valeurs tokenisées pour son nom et sa description :

{
    "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.0/schema.json",
    "name": "[[DA_Name]]",
    "description": "[[DA_Description]]",
    "instructions": "# You are an assistant..."
}

2. Ajouter localizationInfo au manifeste de votre application

Ajoutez la localizationInfo section au manifeste de votre application, avec des balises de langue et des chemins d’accès relatifs à chaque fichier de langue pris en charge dans votre package d’application.

Si votre agent Copilot prend en charge plusieurs langues, vous devez spécifier un fichier de langue autonome pour chaque langue prise en charge, y compris votre langue par défaut.

L’exemple suivant montre la section informations de localisation dans un manifeste d’application :

"localizationInfo": {
    "defaultLanguageTag": "en",
    "defaultLanguageFile": "en.json",
    "additionalLanguages": [
        {
            "languageTag": "fr",
            "file": "fr.json"
        }
    ]
},

Si votre agent Copilot ne prend pas en charge d’autres langues, les chaînes de langue par défaut sont représentées dans le fichier manifeste de l’application lui-même. (Les packages d’application mono language ne nécessitent pas de fichier de langue distinct pour la langue par défaut.)

3. Créer un fichier de localisation pour chaque langue supplémentaire

Créez un fichier de localisation pour chaque langue prise en charge supplémentaire avec des valeurs pour les clés tokenisées, en utilisant les noms de fichiers spécifiés (pour defaultLanguageFile les propriétés et file ) dans le manifeste de l’application de l’étape précédente.

L’exemple suivant montre un fichier de langue, fr.json, avec des chaînes localisées pour un agent Copilot et des onglets personnels :

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.Localization.schema.json`",
    "name.short": "Agent de Communications",
    "name.full": "Agent pour les Communications",
    "description.short": "Outils pour les professionnels de la communication",
    "description.full": "Outils pour les professionnels de la communication Contoso, y compris la galerie de ressources et les assistants personnels",
    "localizationKeys": {
        "DA_Name": "Agent de Communications",
        "DA_Description": "Un assistant pour les professionnels de la communication et des relations publiques chez Contoso."
    },
    "staticTabs[0].name": "Accueil",
    "staticTabs[1].name": "Galerie de ressources",
    "staticTabs[2].name": "À propos de Contoso"
}

Champs localisables dans le manifeste de l’application

Pour chaque fichier de langue, spécifiez les propriétés suivantes du schéma de localisation de l’application qui doivent être localisées :

Pour plus d’informations, consultez Localiser votre application (Microsoft Teams) et informations de référence sur le schéma de localisation.

Champs localisables dans le manifeste de l’agent déclaratif

Les champs suivants sont localisables dans le manifeste de l’agent déclaratif :

Pour plus d’informations, consultez Informations de référence sur le manifeste de l’agent déclaratif.

Champs localisables dans le manifeste du plug-in d’API

Les champs suivants peuvent être localisés dans le manifeste du plug-in d’API :

Pour plus d’informations, consultez Informations de référence sur le manifeste de plug-in d’API.

Voir aussi

• Gérer l’extensibilité pour Microsoft 365 Copilot
• Publier des agents pour Microsoft 365 Copilot