Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Le Miro Microsoft 365 Copilot permet à vos organization d’indexer des tableaux à partir de Miro. Après avoir configuré le connecteur, les utilisateurs peuvent rechercher ces tableaux à partir de Miro dans Microsoft 365 Copilot et n’importe quel client Recherche Microsoft.
Cet article s’adresse aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Miro Copilot.
Fonctionnalités
- Accédez aux tableaux dans Copilot en utilisant la puissance de la recherche sémantique.
- Personnalisez votre fréquence d’analyse.
- Créez un agent à l’aide de la source de données de la connexion à partir de Microsoft Copilot Studio.
Limitations
- Seul le contenu des pense-bêtes, des formes, des cadres, du texte et des documents incorporés sur un tableau est indexé. Le contenu des autres types d’objets n’est pas inclus. Pour plus d’informations, consultez La documentation Miro pour les développeurs.
- N’indexe pas les commentaires ou les réponses.
Configuration requise
1. Créer une équipe de développeurs pour votre compte Miro
Créez ou utilisez un compte Miro existant pour accéder à Miro, puis cliquez sur le lien pour créer une équipe de développeurs pour votre compte Miro actif. Si votre organization est sur un plan Entreprise, accédez à Équipes de développement d’entreprise. Pour plus d’informations, consultez Créer une équipe de développeurs.
2. Créer votre application dans Miro
Connectez-vous à Miro et créez une application dans Vos applications.
3. Ajouter des autorisations à votre application
Ajouter le boards:read Read boards you have access to plan dans l’application que vous avez créée dans la configuration de votre application
4. Ajouter une URL de redirection à votre application
Dans la page de création de l’application, ajoutez les liens suivants au champ « URL de redirection pour OAuth2.0 ».
Pour M365 Enterprise, copiez et collez :
https://gcs.office.com/v1.0/admin/oauth/callbackPour M365 Government, copiez et collez :
https://gcsgcc.office.com/v1.0/admin/oauth/callback
5. Installer votre application et enregistrer les informations d’identification
Cliquez sur Installer l’application et obtenez le jeton OAuth et enregistrez les Client ID et Client secret à partir des informations d’identification de l’application.
Prise en main
1. Configurer le nom d’affichage
Un nom d’affichage est utilisé pour identifier chaque citation dans Copilot afin d’aider les utilisateurs à reconnaître facilement le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé et est utilisé comme filtre source de contenu. Une valeur par défaut est fournie pour ce champ ; vous pouvez le personnaliser avec un nom que les utilisateurs de votre organization reconnaissent.
2. Ajouter l’ID d’entreprise
L’ID d’entreprise (également appelé ID d’organisation) est l’identificateur unique du compte Miro de votre organization. Vous pouvez le trouver en ouvrant le tableau de bord Miro, en cliquant sur votre profil dans le coin supérieur droit, en sélectionnant Paramètres, puis en vérifiant l’URL dans la barre d’adresse, où l’ID de société s’affichera.
Remarque
Vous ne pouvez associer qu’un seul ID d’entreprise dans la connexion. Si vous avez plusieurs ID d’entreprise dans votre espace de travail Miro, créez une connexion distincte.
3. Indiquez le type d’authentification
Entrez l’ID client et la clé secrète client que vous avez obtenus à partir de votre application Miro. Pour plus d’informations, consultez Prise en main d’OAuth 2.0 et Miro.
4. Déployer pour un public limité
Déployez cette connexion sur une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant d’étendre le déploiement à un public plus large. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Microsoft 365 Copilot.
Pour créer la connexion pour Miro, choisissez Créer pour publier vos tableaux de connexion et d’index à partir de votre compte Miro.
Pour les autres paramètres, tels que les autorisations d’accès, le schéma et la fréquence d’analyse, les valeurs par défaut sont définies en fonction de ce qui fonctionne le mieux avec les données Miro.
| Utilisateurs | Description |
|---|---|
| Autorisations d’accès | Seules les personnes ayant accès au contenu dans la source de données. |
| Identités des cartes | Identités de source de données mappées à l’aide d’ID de Microsoft Entra. |
| Contenu | Description |
|---|---|
| Gérer les propriétés | Pour case activée propriétés par défaut et leur schéma. |
| Synchronisation | Description |
|---|---|
| Analyse complète | Fréquence : tous les jours |
Configuration personnalisée
Dans une configuration personnalisée, vous pouvez modifier l’une des valeurs par défaut pour les utilisateurs, le contenu et la synchronisation.
Utilisateurs
Autorisations d’accès
Le connecteur Miro Copilot prend en charge les autorisations de recherche visibles par tout le monde ou uniquement par les personnes ayant accès à cette source de données. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées apparaissent dans les résultats de la recherche pour les utilisateurs qui y ont accès.
Mappage des identités
La méthode par défaut pour mapper vos identités de source de données avec l’ID de Microsoft Entra consiste à vérifier que l’ID d’e-mail des utilisateurs Miro est identique au nom d’utilisateur principal (UPN) ou à l’adresse e-mail des utilisateurs dans Microsoft Entra. Si le mappage par défaut ne fonctionne pas pour votre organization, vous pouvez fournir une formule de mappage personnalisée. Pour plus d’informations, consultez Mapper vos identités non-Azure AD.
Pour identifier l’option la mieux adaptée à votre organization :
- Choisissez l’option ID Microsoft Entra si l’ID d’e-mail des utilisateurs Miro est identique à l’UPN ou à l’adresse e-mail des utilisateurs dans Microsoft Entra ID.
- Choisissez l’option ID non Microsoft Entra si l’ID d’e-mail des utilisateurs Miro est différent de l’UPN et de l’adresse e-mail des utilisateurs dans Microsoft Entra ID.
Contenu
Gérer les propriétés
Pour ajouter ou supprimer des propriétés disponibles à partir de votre source de données Miro, affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, peut être recherchée, récupérable ou refinable), puis modifiez l’étiquette sémantique et ajoutez un alias à la propriété. Certaines propriétés sont sélectionnées par défaut.
| Source, propriété | Étiquette | Description | Schéma |
|---|---|---|---|
| Corps | N/A | N/A | Recherche |
| CreatedAt | Date et heure de création | Date et heure de création de l’élément dans la source de données | Interroger, Récupérer. |
| CreatedBy | Créé par | L’utilisateur qui a créé l’élément | Interroger, Récupérer, Rechercher. |
| Description | N/A | N/A | Interroger, Récupérer. |
| ID | N/A | N/A | Interroger, Récupérer. |
| ModifiedAt | Date et heure de la dernière modification | Date et heure de la dernière modification de l’élément dans la source de données | Interroger, Récupérer. |
| ModifiedBy | Auteur de la dernière modification | L’utilisateur qui a effectué la dernière modification | Interroger, Récupérer, Rechercher. |
| Nom | Titre | Titre de l’élément que vous souhaitez afficher dans Copilot et d’autres expériences de recherche | Interroger, Récupérer, Rechercher. |
| Équipe | N/A | N/A | Interroger, Récupérer. |
| ViewLink | url | URL cible de l’élément dans la source de données | Interroger, Récupérer. |
Afficher un aperçu des données
Cliquez sur Aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées et du filtre de requête.
Synchronisation
L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Miro Copilot. Seuls les intervalles d’actualisation d’analyse complets sont pris en charge. Pour plus d’informations, consultez Paramètres d’actualisation.
Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation.
Résolution des problèmes
Voici les erreurs courantes et la façon de les résoudre.
- Les étendues d’autorisation requises sont manquantes. Vérifiez que les étendues nécessaires sont sélectionnées dans l’application Miro.
Vous n’avez pas les étendues d’autorisation requises. Assurez-vous que vous avez sélectionné boards:read Read boards you have access to dans le champ d’autorisation de votre configuration Applications.
- Échec du flux OAuth 2.0. Vérifiez les informations d’identification et vérifiez que l’application Miro est configurée avec les paramètres appropriés.
Il s’agit d’une erreur d’authentification courante. Retour à l’application Miro et vérifiez que le OAuth2 dans Paramètres est correctement configuré.
- Échec du flux OAuth 2.0. Vérifiez que l’utilisateur Miro associé à ce jeton d’accès d’équipe détient le rôle d’administrateur d’équipe et qu’il est un utilisateur actif.
Il s’agit d’une erreur d’authentification courante. Retour à la console de l’application Miro et vérifiez que le créateur dispose d’un rôle d’administrateur et que le compte status est actif.
- Vos informations d’identification de sécurité ont expiré pour cette session. Retour et connectez-vous à nouveau avec votre clé d’application et votre secret d’application.
Vos informations d’identification ont expiré. Actualisez l’application Miro et copiez l’ID client et la clé secrète client les plus récents à partir de l’onglet Paramètres pour vous authentifier.
- Informations d’identification non valides détectées. Vérifiez les informations d’identification et case activée les étendues d’autorisation de l’application Miro.
Il s’agit d’une erreur d’informations d’identification courante. Retour à l’application Miro et vérifiez que les étendues dans Autorisations sont correctement configurées.
Étapes suivantes
Après avoir publié votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration. Pour plus d’informations, consultez Gérer votre connecteur.
Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, consultez prise en charge de Microsoft Graph.