Partager via


Connecteur asana Microsoft 365 Copilot

Le connecteur asana Microsoft 365 Copilot permet à votre organization d’indexer des tâches Asana. Après avoir configuré le connecteur et indexé le contenu des espaces de travail Asana, les utilisateurs peuvent rechercher ces éléments dans Recherche Microsoft et Microsoft 365 Copilot.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Asana Copilot.

Fonctionnalités

  • Tâches d’index.
  • Permettre à vos utilisateurs de poser des questions relatives au suivi du projet et aux informations sur les tâches dans Copilot. Par exemple :
    • Identifier les tâches qui n’ont pas été affectées dans tous mes projets.
    • Identifiez les tâches en retard dans un projet.
    • Résumez mes tâches pour les deux prochaines semaines.
  • Utilisez la recherche sémantique dans Copilot pour permettre aux utilisateurs de trouver du contenu pertinent en fonction des mots clés, des préférences personnelles et des connexions sociales.

Limitations

  • Le connecteur n’indexe pas les commentaires.
  • Le connecteur n’indexe pas les champs personnalisés.

Configuration requise

  • Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.
  • Pour vous connecter à votre espace de travail Asana, vous avez besoin de l’URL Asana. L’URL est généralement la suivante : https://app.asana.com.
  • Pour vous connecter à Asana et autoriser le connecteur Copilot à mettre à jour régulièrement les tâches Asana, vous avez besoin d’un compte de service avec des autorisations de lecture. Le compte de service doit avoir le rôle Administration.

Prise en main

Choisir un nom d’affichage

Le 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 ; vous pouvez le personnaliser avec un nom que les utilisateurs de votre organization reconnaissent.

Ajouter l’URL Asana

Pour vous connecter à votre espace de travail Asana, vous avez besoin de l’URL Asana. L’URL est généralement la suivante : https://app.asana.com.

Choisir le type d’authentification

Pour utiliser Asana OAuth pour l’authentification, un administrateur Asana doit créer une application dans la console de développement Asana.

Utilisez les informations du tableau suivant pour remplir le formulaire de création du client OAuth.

Field Description Valeur recommandée
Nom de l'application Valeur unique qui identifie l’application pour laquelle vous avez besoin d’un accès OAuth. Recherche Microsoft
Laquelle décrit le mieux ce que votre application fera ? Décrire l’objectif de l’application. Récupérez les données d’Asana pour créer des rapports.
URL de redirection URL de rappel obligatoire vers laquelle le serveur d’autorisation redirige. Pour Microsoft 365 Entreprise : https://gcs.office.com/v1.0/admin/oauth/callback

Pour Microsoft 365 Government :https://gcsgcc.office.com/v1.0/admin/oauth/callback
Gérer la distribution Choisissez les espaces de travail à distribuer. Ajoutez des espaces de travail spécifiques auxquels le connecteur peut accéder ou sélectionnez N’importe quel espace de travail.

Copiez l’ID client et la clé secrète client à partir de l’onglet OAuth de l’application Asana que vous avez créée et collez-les dans la configuration du connecteur. Choisissez Autoriser et utilisez les mêmes informations d’identification du compte administrateur Asana pour authentifier l’autorisation d’analyse.

Remarque

Vous devez autoriser l’accès à l’application Asana dans une fenêtre contextuelle. Assurez-vous que votre navigateur autorise les fenêtres contextuelles ou accorde l’accès si la fenêtre contextuelle est bloquée.

Déployer sur un public limité

Déployez la connexion à une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant de la déployer auprès d’un public plus large. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs.

À ce stade, vous êtes prêt à créer la connexion pour Asana. Choisissez Créer pour publier votre connexion et indexer des articles à partir de votre compte Asana.

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 Asana.

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 plus d’informations sur les propriétés par défaut et leur schéma, consultez le contenu.
Synchronisation Description
Analyse incrémentielle S’exécute toutes les 15 minutes.
Analyse complète S’exécute tous les jours.

Si vous souhaitez modifier l’une de ces valeurs, choisissez l’option Configuration personnalisée .

Configuration personnalisée

Dans l’installation personnalisée, vous pouvez modifier l’une des valeurs par défaut pour les utilisateurs, le contenu et la synchronisation.

Utilisateurs

Capture d’écran montrant l’onglet Utilisateurs dans lequel vous pouvez configurer des autorisations d’accès et des règles de mappage d’utilisateurs.

Autorisations d’accès

Le connecteur Asana Copilot prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement pour 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. Dans Atlassian Asana, les autorisations de sécurité sont définies à l’aide de schémas d’autorisation de projet contenant des groupes au niveau du site et des rôles de projet. La sécurité au niveau des tâches peut également être définie à l’aide de schémas d’autorisation au niveau de la tâche.

Mappage des identités

La méthode par défaut pour mapper vos identités de source de données avec Microsoft Entra ID consiste à vérifier que l’ID de messagerie des utilisateurs Asana est identique au nom d’utilisateur principal (UPN) des utilisateurs dans Microsoft Entra ID. 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 :

  1. Choisissez l’option Microsoft Entra ID si l’ID de messagerie des utilisateurs Asana est identique à l’UPN dans Microsoft Entra ID.
  2. Choisissez l’option Non Microsoft Entra ID si l’ID de messagerie des utilisateurs Asana est différent de l’UPN et de l’adresse e-mail des utilisateurs dans Microsoft Entra ID.

Contenu

Capture d’écran montrant l’onglet Contenu dans lequel vous pouvez configurer les propriétés et le schéma.

Gérer les propriétés

Pour pouvoir ajouter ou supprimer des propriétés disponibles à partir de votre Asana, affectez un schéma à la propriété (définissez si une propriété peut faire l’objet d’une recherche, peut être interrogé, récupérable ou refinable), modifiez l’étiquette sémantique et ajoutez un alias à la propriété. Les propriétés suivantes sont indexées par défaut.

Propriété par défaut Étiquette Description Schéma
Cessionnaire Non applicable La personne qui doit effectuer cette tâche Interroger, Récupérer, Rechercher
Terminé Non applicable Le corps principal de l’article Requête, récupération
CompletedAt Non applicable Date et heure d’achèvement de la tâche Requête, récupération
CreatedAt Date et heure de création Date et heure de création de la tâche Requête, récupération
CreateBy Créé par La personne qui a créé cette tâche Interroger, Récupérer, Rechercher
DueOn Non applicable Quand cette tâche doit être terminée Requête, récupération
Gid Non applicable ID global de cette tâche Requête, récupération
ModifiedAt Date et heure de la dernière modification Date et heure de modification de la tâche Requête, récupération
Nom Titre Nom de la tâche Interroger, Récupérer, Rechercher
Notes Non applicable Description de la tâche. Recherche
Id de projet Non applicable ID de projet Non applicable
ProjectNames Non applicable Noms de projet Requête, récupération
Tags étiquettes Balises affectées à cette tâche Requête, récupération
TaskUrl url Lien de la tâche Interroger, Récupérer, Rechercher
Nom de l’espace de travail Non applicable Nom de l’espace de travail Interroger, Récupérer, Rechercher

Afficher un aperçu des données

Utilisez le bouton d’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

Capture d’écran montrant l’onglet Synchronisation dans lequel vous pouvez configurer la fréquence d’analyse.

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 Asana Copilot. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, consultez Paramètres d’actualisation.

Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation.

Étapes suivantes

Après avoir publié votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, 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.