Dans cet article
Résumé
Vue d'ensemble de l'architecture
Gestion des données
dropdown icon
Authentification et autorisation
    Autorisations consenties par l'utilisateur
    Autorisations de service
Intégration de Copilot, gestion des fonctionnalités et autorisation dans Control Hub
Paramètres et configurations de l'application Webex
Documentation de référence supplémentaire
Autoriser AI Assistant à effectuer des recherches dans des sources de données Microsoft externes
list-menuDans cet article
list-menuUn commentaire ?

L'intégration à Microsoft Copilot permet aux utilisateurs de Webex Meeting de se connecter en toute sécurité à leur compte Microsoft Copilot comme source de données.

Résumé

Cisco AI AssistantEn tirant parti de l'application Webex, les utilisateurs peuvent rechercher, analyser et résumer les résultats provenant de sources de données Microsoft, notamment SharePoint, OneDrive et Copilot Connectors.

Vue d'ensemble de l'architecture

La connexion à Microsoft Copilot vous permet d'interagir avec les sources de données Microsoft à l'aide des API Microsoft Retrieval. Lorsque vous utilisez leCisco AI Assistant, il extrait les données de vos sources Microsoft en temps réel.

Webex ne stocke ni ne conserve les données qui vous sont renvoyées parCisco AI Assistant. Les données ne sont utilisées que sur le moment pour générer votre réponse, garantissant ainsi la protection de votre vie privée.

Architecture overview for how Webex AI Assistant uses Microsoft data

Étapes détaillées du flux de données

Gestion et attribution des utilisateurs

Les administrateurs peuvent gérer les utilisateurs qui possèdent des licences Microsoft Copilot et activer ou désactiver cette fonctionnalité au niveau de l'organisation, de l'utilisateur ou du modèle à l'aide de Control Hub.

Autorisation utilisateur et connexion

  1. L'utilisateur se connecte à l'application Webex

  2. L'utilisateur accède à la page des paramètres pour connecter son compte Microsoft.

L'utilisateur termine le processus d'autorisation et sélectionne les sources (SharePoint, OneDrive ou Copilot Connector) auxquelles elle souhaite accéder.

Workflow des questions et réponses

L'utilisateur pose une question, par exemple : où en est le projet ABC ?

Les étapes suivantes seront exécutées en plusieurs sous-étapes par Webex Meeting Service :

  1. Décryptage : le système déchiffre la demande.

  2. Contexte de chargement : le contexte pertinent est chargé.

  3. Raisonnement du LLM : Le LLM réécrit la question pour une extraction optimale.

  4. Récupère les informations d'intégration : le système récupère la configuration et les jetons pour la recherche par chemins multiples .

  5. Recherche par chemins multiples : le système effectue la recherche via les outils Microsoft pris en charge.

    • Recherche : les outils de recherche multivoies permettent de rechercher du contenu détaillé.

    • Renvoie le résultat de la recherche : les outils de recherche par chemins multiples renvoient le résultat de la recherche.

  6. Reclassement et filtrage : le service de réunions Webex utilise le LLM pour classer et filtrer le contenu en fonction de sa pertinence.

  7. Génération : LLM génère une réponse finale avec des citations.

  8. Réponse : publiez la réponse finale sur l'application Webex.

Gestion des données

Gestion des données

Cette fonctionnalité utilise les données et informations de configuration de service suivantes pour gérer les autorisations, récupérer le contenu Microsoft 365 autorisé et fournir des réponses dans l'application Webex :

  • Enregistrement de l'application Microsoft :

    L'enregistrement de l'application Microsoft représente la configuration du client OAuth 2.0 enregistrée sur le portail Microsoft Azure (ID Entra) pour l'Cisco AI Assistant intégration.

    Cet enregistrement définit les autorisations déléguées spécifiques requises lors du flux d'autorisation des comptes Microsoft :

    • Read.All et Sites.Read.All : requis pour accéder au contenu de SharePoint et OneDrive.

    • ExternalItem.Read.all : obligatoire pour accéder au contenu de Copilot Connectors.

    Cisco AI Assistantutilise cet enregistrement pour trouver les bons paramètres OAuth pour la connexion et l'acquisition de jetons avant d'invoquer l'API Microsoft 365 Copilot Retrieval. Pour plus d'informations, voir « S'inscrire Cisco AI Assistant dans Microsoft Azure ».

  • Jetons Microsoft OAuth :

    Les jetons Microsoft OAuth sont des jetons d'accès délégué de courte durée émis par Microsoft Entra ID une fois qu'un utilisateur se connecte à son compte Microsoft via la page des paramètres de l'application Webex et obtient les autorisations nécessaires.

    Cisco AI Assistantutilise ces jetons pour appeler l'API Microsoft 365 Copilot Retrieval au nom de l'utilisateur. Microsoft Entra ID utilise ces jetons pour authentifier chaque demande, identifier l' utilisateur et appliquer les politiques de contrôle d'accès et de barrière de l'information de Microsoft 365, en veillant à ce que seul le contenu auquel l'utilisateur connecté est autorisé à accéder soit renvoyé.

    Renouvellement des jetons

    Au moment de l'autorisation initiale, Microsoft Entra ID émet à la fois un jeton d' accès de courte durée (valide pendant 60 à 90 minutes environ) et un jeton d'actualisation de longue durée. Webex stocke en toute sécurité le jeton d'actualisation côté serveur, lié à l'identité Webex de l'utilisateur.

    Les jetons d'accès ne sont pas renouvelés en permanence. Au lieu de cela, lorsqu'un utilisateur soumet une demande, Webex vérifie si le jeton d'accès actuel est toujours valide. S'il est expiré, Webex échange silencieusement le jeton d'actualisation contre un nouveau jeton d'accès. La validité du jeton d'actualisation est prolongée à chaque utilisation, ce qui permet à la session de rester active sans intervention de l' utilisateur tant que la fonctionnalité est utilisée régulièrement.

    Fin de session

    La session est terminée et une nouvelle authentification est requise dans les conditions suivantes :

    • Inactivité : L'utilisateur n'a pas utilisé la fonctionnalité depuis longtemps (généralement 90 jours, selon la politique par défaut de Microsoft Entra ID et la configuration des locataires du client).

    • Déconnexion manuelle : L'utilisateur déconnecte explicitement son compte Microsoft des paramètres de l'application Webex.

    • Administratif : Un administrateur Microsoft 365 révoque l' accès de l'application à Entra ID.

    • Changements de configuration : Les limites des autorisations accordées sont modifiées, ou l'enregistrement de la demande est modifié.

    Pour plus d'informations, voir « Autorisation du compte Microsoft dans l'application Webex ».

  • Texte rapide :

    Le texte rapide fait référence à la saisie en langage naturel saisie par un utilisateur dans leCisco AI Assistant, par exemple pour connaître l'état d'un projet ou localiser un document sur son compte Microsoft. Ce texte est généré par l'utilisateur au moment de l'exécution.

    Workflow de traitement

    Lorsqu'une invite est envoyée, procédez Cisco AI Assistant comme suit pour récupérer et présenter les informations :

    • Interprétation et optimisation : L'assistant interprète l'invite, raisonne et réécrit les requêtes pour produire une chaîne de requête optimisée.

    • Invocation d'API : L'assistant invoque l'API Microsoft 365 Copilot Retrieval par rapport à une ou plusieurs sources de données.

    • Filtrage : le cas échéant, des expressions filtrantes en langage de requête par mot clé (KQL) sont appliquées pour étendre la recherche à des sites, des bibliothèques de documents, des types de fichiers ou des plages de dates spécifiques.

    • Reclassement et synthèse : L'assistant reclasse et filtre les parties de texte renvoyées. Il génère ensuite une réponse finale qui combine l'invite d'origine avec le contenu récupéré, y compris des citations renvoyant aux documents sources.

  • Contenu SharePoint et OneDrive : les contenus SharePoint et OneDrive sont des données Microsoft 365 autorisées récupérées via l' API Microsoft 365 Copilot Retrieval pour répondre à la demande d'un utilisateur. L'API Retrieval extrait les parties de texte pertinentes directement à partir de l'index de contenu hybride de Microsoft 365 sans dupliquer, exporter ou indexer séparément aucune donnée.

    Types de fichiers pris en charge : .docx, .pptx, .pdf, .aspx et .one ; le contenu non textuel tel que les images et les graphiques n'est pas pris en charge.

    Tout le contenu est récupéré dans les limites de confiance de Microsoft 365 et se limite strictement aux fichiers et documents auxquels l'utilisateur connecté est autorisé à accéder conformément au modèle d'autorisations de Microsoft 365.

    • Demande : Cisco AI Assistant envoie une requête HTTPS POST à https://graph.microsoft.com/v1.0/copilot/retrieval, avec le jeton d'accès délégué Microsoft Entra ID dans l'en-tête Authorization. Le corps de la requête contient :

      • QueryString : la requête en langage naturel réécrite dérivée de l'invite de l'utilisateur (1 500 caractères maximum).

      • Source de données : paramétré sur SharePoint ou OneDrive (un par demande ; des appels distincts sont passés pour chaque source).

      • FilterExpression (facultatif) : expression KQL à définir par URL du site, chemin, type de fichier ou plage de dates.

      • Nombre maximum de résultats : plafonné à 25 par appel.

    • Réponse : Microsoft 365 traite la demande dans les limites de confiance et renvoie un tableau RetrievalHits, chaque entrée contenant :

      • ContentChunk : extrait de texte de l'index du contenu

      • RelevanceScore : score de similarité en cosinus entre la requête et le morceau, normalisé sur une plage de 0 à 1

      • ressource—les métadonnées de la source, y compris le nom du fichier, l'URL, l'auteur et la date de dernière modification

    • Gestion des données : Le contenu complet des fichiers n'est pas transféré. Seuls des extraits de texte préextraits de l' index hybride Microsoft 365 sont renvoyés. Cisco AI Assistanttransmet ces segments de façon transitoire à son LLM pour le reclassement, le filtrage et la génération de réponses. Les métadonnées des sources sont utilisées pour créer des citations dans la réponse finale. Les morceaux de texte ne sont pas stockés par Webex au-delà de la durée de la demande.

  • Contenu de Copilot Connectors : Le contenu de Copilot Connectors est constitué de données d'entreprise tierces ou personnalisées, intégrées dans l'index de contenu Microsoft 365 via des connecteurs Microsoft Graph et accessibles via l'API Microsoft 365 Copilot Retrieval. Tout le contenu renvoyé est limité aux éléments auxquels l'utilisateur connecté est autorisé à accéder conformément aux autorisations configurées par le connecteur dans Microsoft 365.

    • Demande : Cisco AI Assistant envoie une requête HTTPS POST à https://graph.microsoft.com/v1.0/copilot/retrieval, avec le jeton d'accès délégué Microsoft Entra ID dans l'en-tête Authorization. Le corps de la requête contient :

      • QueryString : la requête en langage naturel réécrite dérivée de l'invite de l'utilisateur (1 500 caractères maximum).

      • Source de données : paramétrez sur CoPilotConnectors.

      • FilterExpression (facultatif) : expression KQL permettant d'accéder à des sources de connecteurs ou à des types de contenu spécifiques.

      • Nombre maximum de résultats : plafonné à 25 par appel.

    • Réponse : Microsoft 365 traite la demande dans les limites de confiance et renvoie un tableau RetrievalHits, chaque entrée contenant :

      • ContentChunk : extrait de texte du contenu tiers indexé.

        RelevanceScore : score de similarité en cosinus entre la requête et le morceau, normalisé sur une plage de 0 à 1. Notez que le score de pertinence n'est peut-être pas présent pour tous les résultats de Copilot Connector.

        ressource-source, y compris le nom de l'article, l'URL et les attributs définis par le connecteur.

  • Gestion des données : aucun contenu source complet n'est transféré. Seuls des extraits de texte préextraits de l'index de contenu Microsoft 365 sont renvoyés. Parce que l'API de récupération cible une source de données par appel, Cisco AI Assistant émet des appels de récupération distincts pour les connecteurs SharePoint, OneDrive et Copilot et fusionne les résultats lors de l'étape de reclassement.

    Les morceaux de texte sont transmis de façon transitoire au LLM pour le reclassement, le filtrage et la génération de réponses, et ne sont pas stockés par Webex au-delà de la durée de la demande.

Authentification et autorisation

Webex interagit avec vos comptes et contenus Microsoft à l'aide de l'API Microsoft Retrieval, qui est authentifiée et gérée par le fournisseur d'identité Microsoft (IdP). Toutes les communications avec l'IdP Microsoft et l'API de récupération sont protégées par des connexions sécurisées TLS.

Authentification par le service Webex

Cisco AI Assistantin Webex App utilise les flux OAuth 2.0 standard pour interagir avec les services Webex :

  • Fournisseur d'identité : Le service Webex Identity fait office d'IdP basé sur le cloud pour authentifier les utilisateurs et autoriser l'accès à l'API.

  • Jetons au porteur : Les requêtes adressées aux API Webex sont autorisées à l'aide de jetons au porteur émis par le Webex Identity Service.

  • Communication sécurisée : tous les échanges de données entre le WebexAI Assistant, le Webex Identity Service et les API Webex se font via des connexions sécurisées TLS.

Exigences administratives

Pour activer cette intégration, les administrateurs doivent suivre les étapes suivantes :

  1. Configuration de Microsoft 365 : les administrateurs doivent attribuer les licences Microsoft Copilot appropriées aux utilisateurs concernés.

  2. Configuration Webex : les administrateurs peuvent activer ou désactiver cette fonctionnalité au niveau de l' organisation, de l'utilisateur ou du modèle directement dans Control Hub.

Autorisations consenties par l'utilisateur

Lors de la configuration, les autorisations suivantes sont demandées :

Autorisation requise Objectif
Application Webex Connectez-vous et lisez le profil utilisateur Connectez-vous à l'application Webex avec votre compte.
Autorisez votre compte Microsoft et connectez-vous à celui-ci Validez et autorisez l'application Webex à se connecter à votre compte Microsoft.

Ces autorisations ne sont utilisées que pendant le processus de configuration et ne sont pas stockées.

Autorisations de service

AUCUNE autorisation de service spécifique n'est requise. Les administrateurs peuvent gérer les fonctionnalités et les paramètres de Control Hub en suivant les détails de la section ci-dessous.

Paramètres et configurations de l'application Webex

Les utilisateurs peuvent se connecter à l'application Webex et autoriser la connexion au compte Microsoft une fois que l'administrateur a activé la fonctionnalité avec autorisation via Control Hub

Pour plus d'informations, voir Accédez à vos données Microsoft avec Cisco AI Assistant

Cet article était-il utile ?
Cet article était-il utile ?