- Inicio
- /
- Artículo
La integración con Microsoft Copilot permite a los usuarios de Webex Meeting conectarse de forma segura con sus cuentas de Microsoft Copilot como una de sus fuentes de datos.
Resumen
Al aprovechar Cisco AI Assistant la aplicación Webex, los usuarios pueden buscar, analizar y resumir los resultados de las fuentes de datos de Microsoft, incluidos SharePoint, OneDrive y Copilot Connectors.
Descripción general de la arquitectura
La conexión a Microsoft Copilot le permite interactuar con las fuentes de datos de Microsoft mediante las API de recuperación de Microsoft. Cuando usa elCisco AI Assistant, recupera datos de sus fuentes de Microsoft en tiempo real.
Webex no almacena ni conserva los datos que se le devuelven a través Cisco AI Assistant de. Los datos se utilizan solo en el momento para generar su respuesta, asegurando que su privacidad permanezca protegida.
Pasos detallados del flujo de datos
Administración y asignación de usuarios
Los administradores pueden administrar usuarios que tienen licencias de Microsoft Copilot y activar o desactivar la función a nivel de organización, usuario o plantilla mediante Control Hub.
Autorización y conexión del usuario
-
El usuario inicia sesión en la aplicación Webex
-
El usuario navega a la página Configuración para conectar su cuenta Microsoft.
El usuario completa el proceso de autorización y selecciona las fuentes (SharePoint, OneDrive o Copilot Connector) a las que desea acceder.
Flujo de trabajo de preguntas y respuestas
El usuario hace una pregunta, por ejemplo: ¿cuál es el estado del proyecto ABC?
Los siguientes pasos se ejecutarán mediante varios subpasos por Webex Meeting Service:
-
Desencriptar: el sistema descifra la solicitud.
-
Contexto de carga: se carga el contexto relevante.
-
Razonamiento de LLM: LLM reescribe la pregunta para una recuperación óptima.
-
Obtener información de integración: el sistema recupera la configuración y los tokens para la búsqueda de múltiples rutas.
-
Búsqueda de múltiples rutas: el sistema ejecuta la recuperación a través de las herramientas compatibles de Microsoft.
-
Búsqueda: las herramientas de recuperación de múltiples rutas buscan contenido detallado.
-
Devolver el resultado de la búsqueda: las herramientas de recuperación de múltiples rutas devuelven el resultado de la búsqueda.
-
-
Reranking y filtrado: El servicio de reuniones de Webex utiliza el LLM para clasificar y filtrar el contenido en función de su relevancia.
-
Generación: LLM genera una respuesta final con citas.
-
Respuesta: publique la respuesta final a la aplicación Webex.
Manejo de datos
Manejo de datos
Esta función utiliza la siguiente información de configuración de datos y servicios para administrar la autorización, recuperar contenido autorizado de Microsoft 365 y proporcionar respuestas en Webex App:
-
Registro de aplicaciones de Microsoft:
El registro de aplicaciones de Microsoft representa la configuración del cliente OAuth 2.0 registrada en el portal de Microsoft Azure (ID de Entra) para la Cisco AI Assistant integración.
Este registro define los permisos delegados específicos requeridos durante el flujo de autorización de la cuenta Microsoft:
-
Leer.Todos y los sitios.Lectura. Todo: necesario para acceder al contenido de SharePoint y OneDrive.
-
ExternalItem.Read.All: requerido para acceder al contenido de Copilot Connectors.
Cisco AI Assistantutiliza este registro para localizar la configuración correcta de OAuth para el inicio de sesión y la adquisición de tokens antes de invocar la API de recuperación de Copilot de Microsoft 365. Para obtener más información, consulte “Registrarse Cisco AI Assistant en Microsoft Azure”.
-
-
Tokens de Microsoft OAuth:
Los tokens OAuth de Microsoft son tokens de acceso delegado de corta duración emitidos por Microsoft Entra ID una vez que un usuario inicie sesión en su cuenta Microsoft a través de la página de configuración de la aplicación Webex y otorga los permisos necesarios.
Cisco AI Assistantutiliza estos tokens para llamar a la API de recuperación de Copilot de Microsoft 365 en nombre del usuario. El ID de Microsoft Entra utiliza estos tokens para autenticar cada solicitud, identificar al usuario y hacer cumplir las políticas de control de acceso y barrera de información de Microsoft 365, asegurando que solo se devuelva el contenido al que el usuario que ha iniciado sesión puede acceder.
Renovación de token
En el momento de la autorización inicial, el ID de Microsoft Entra emite tanto un token de acceso de corta duración (válido por aproximadamente 60 a 90 minutos) como un token de actualización de larga duración. Webex almacena de forma segura el token de actualización del lado del servidor, vinculado a la identidad de Webex del usuario.
Los tokens de acceso no se renuevan continuamente. En su lugar, cuando un usuario envía una solicitud, Webexcomprueba si el token de acceso actual sigue siendo válido. Si ha expirado, Webexsilentemente intercambia el token de actualización por un nuevo token de acceso. La validez del token de actualización se extiende cada vez que se usa, lo que permite que la sesión permanezca activa sin intervención del usuario siempre que la función esté en uso regular.
Terminación de la sesión
Se termina la sesión y se requiere volver a autenticar bajo las siguientes condiciones:
-
Inactividad: el usuario no ha utilizado la función durante un período prolongado (normalmente 90 días, dependiendo de la directiva predeterminada del ID de Microsoft Entra y de la configuración del inquilino del cliente).
-
Desconexión manual: El usuario desconecta explícitamente su cuenta Microsoft de la configuración de la aplicación Webex.
-
Administrativo: Un administrador de Microsoft 365 revoca el acceso de la aplicación en Entra ID.
-
Cambios en la configuración: Se modifican los alcances de permiso otorgados o se cambia el registro de la aplicación.
Para obtener más información, consulte “Autorización de cuenta Microsoft en la aplicación Webex”.
-
-
Texto rápido:
El texto del mensaje se refiere a la entrada en idioma natural ingresada por un usuario dentro delCisco AI Assistant, como una solicitud para encontrar el estado de un proyecto o localizar un documento dentro de su cuenta de Microsoft. Este texto es generado por el usuario en tiempo de ejecución.
Flujo de trabajo de procesamiento
Cuando se envía un mensaje, Cisco AI Assistant siga estos pasos para recuperar y presentar información:
-
Interpretación y optimización: El asistente interpreta el mensaje, realiza el razonamiento y ejecuta la reescritura de consultas para producir una cadena de consulta optimizada.
-
Invocación de API: El asistente invoca la API de recuperación Copilot de Microsoft 365 contra uno o más orígenes de datos.
-
Filtrado: Cuando corresponda, las expresiones de filtro de Lenguaje de consulta de palabras clave (KQL) se aplican para el alcance de la recuperación a sitios específicos, bibliotecas de documentos, tipos de archivo o rangos de fechas.
-
Re-ranking y síntesis: El asistente vuelve a la lista y filtra los fragmentos de texto devueltos. A continuación, genera una respuesta final que combina el mensaje original con el contenido recuperado, incluidas las citas a los documentos de origen.
-
-
Contenido de SharePoint y OneDrive: El contenido de SharePoint y OneDrive está autorizado para obtener datos de Microsoft 365 a través de la API de recuperación Copilot de Microsoft 365 para responder a una solicitud de usuario. La API de recuperación extrae fragmentos de texto relevantes directamente del índice de contenido híbrido de Microsoft 365 sin duplicar, exportar o indexar por separado ningún dato.
Tipos de archivo admitidos: .docx, .pptx, .pdf, .aspx y.one; no se admite contenido no textual como imágenes y gráficos.
Todo el contenido se recupera dentro del límite de confianza de Microsoft 365 y está estrictamente limitado a los archivos y documentos a los que el usuario que ha ingresado está autorizado a acceder bajo el modelo de permisos de Microsoft 365.
-
Solicitud: Cisco AI Assistant envía una solicitud HTTPS POST a https://graph.microsoft.com/v1.0/copilot/retrieval, con el token de acceso delegado del ID de Microsoft Entra en el encabezado de autorización. El cuerpo de la solicitud contiene:
-
QueryString: consulta de lenguaje natural reescrita derivada del mensaje del usuario (máximo 1.500 caracteres).
-
DataSource: se establece en SharePoint o OneDrive (una por solicitud; se realizan llamadas separadas para cada origen).
-
FilterExpression (opcional): expresión KQL para el ámbito por URL del sitio, ruta, tipo de archivo o rango de fechas.
-
Número máximo de resultados: con un límite de 25 por llamada.
-
-
Respuesta: Microsoft 365 procesa la solicitud dentro de su límite de confianza y devuelve una matriz RetrievalHits, con cada entrada conteniendo:
-
ContentChunk: un fragmento de texto extraído del índice de contenido
-
RelevanceScore: puntuación de similitud de cosine entre la consulta y el fragmento, normalizada a un rango de 0 a 1
-
recurso—metadatos de origen que incluyen nombre de archivo, URL, autor y fecha de la última modificación
-
-
Manejo de datos: No se transfiere el contenido completo del archivo; solo se devuelven fragmentos de texto previamente extraídos del índice híbrido de Microsoft 365. Cisco AI Assistantpasa estos fragmentos transitoriamente a su LLM para reclasificar, filtrar y generar respuestas. Los metadatos de origen se utilizan para construir citas en la respuesta final. Webex no almacena fragmentos de texto más allá de la duración de la solicitud.
-
-
Contenido de los conectores Copilot: El contenido de Copilot Connectors es datos empresariales de terceros o personalizados que se ingieren en el índice de contenido de Microsoft 365 a través de conectores Microsoft Graph y se pueden recuperar a través de la API de recuperación de Copilot de Microsoft 365. Todo el contenido devuelto está limitado a los elementos a los que el usuario que ha accedido está autorizado a acceder bajo los permisos configurados del conector en Microsoft 365.
-
Solicitud: Cisco AI Assistant envía una solicitud HTTPS POST a https://graph.microsoft.com/v1.0/copilot/retrieval, con el token de acceso delegado del ID de Microsoft Entra en el encabezado de autorización. El cuerpo de la solicitud contiene:
-
QueryString: consulta de lenguaje natural reescrita derivada del mensaje del usuario (máximo 1.500 caracteres).
-
Fuente de datos: se establece en CoPilot Connectors.
-
FilterExpression (opcional): expresión KQL para el alcance de la recuperación a fuentes de conector o tipos de contenido específicos.
-
Número máximo de resultados: con un límite de 25 por llamada.
-
-
Respuesta: Microsoft 365 procesa la solicitud dentro de su límite de confianza y devuelve una matriz RetrievalHits, cada entrada contiene:
-
ContentChunk: un fragmento de texto extraído del contenido indexado de terceros.
RelevanceScore: puntuación de similitud de cosido entre la consulta y el fragmento, normalizada a un rango de 0 a 1. Tenga en cuenta que la puntuación de relevancia puede no estar presente en todos los resultados de Copilot Connector.
recurso: metadatos de origen, incluidos el nombre del elemento, la URL y los atributos definidos por el conector.
-
-
-
Manejo de datos: No se transfiere contenido de origen completo; solo se devuelven fragmentos de texto previamente extraídos del índice de contenido de Microsoft 365. Debido a que la API de recuperación se dirige a una fuente de datos por llamada, Cisco AI Assistant emite llamadas de recuperación separadas para los conectores SharePoint, OneDrive y Copilot y combina los resultados durante el paso de reranking.
Los fragmentos de texto se pasan transitoriamente al LLM para reclasificar, filtrar y generar respuestas, y Webex no los almacena más allá de la duración de la solicitud.
Autenticación y autorización
Webex interactúa con sus cuentas y contenido de Microsoft mediante la API de recuperación de Microsoft, que es autenticada y administrada por el proveedor de identidad (IdP) de Microsoft. Toda la comunicación con el IdP de Microsoft y la API de recuperación está protegida por conexiones protegidas por TLS.
Autenticación de Webex Service
Cisco AI Assistanten Webex App utiliza flujos estándar de OAuth 2.0 para interactuar con los servicios de Webex:
-
Proveedor de identidad: El servicio de identidad de Webex actúa como el IdP basado en la nube para autenticar a los usuarios y autorizar el acceso a la API.
-
Tokens portadores: Las solicitudes a las API de Webex se autorizan mediante tokens portadores emitidos por Webex Identity Service.
-
Comunicación segura: Todo el intercambio de datos entre WebexAI Assistant, Webex Identity Service y las API de Webex se lleva a cabo a través de conexiones seguras TLS.
Requisitos administrativos
Para habilitar esta integración, los administradores deben completar los siguientes pasos:
-
Configuración de Microsoft 365: Los administradores deben asignar las licencias adecuadas de Microsoft Copilot a los usuarios pertinentes.
-
Configuración de Webex: Los administradores pueden habilitar o deshabilitar la función a nivel de organización, usuario o plantilla directamente dentro de Control Hub.
Permisos consentidos por el usuario
Durante la configuración, se solicitan los siguientes permisos:
| Permiso requerido | Propósito |
|---|---|
| Webex App Inicie sesión y lea el perfil de usuario | Inicie sesión en la aplicación Webex con su cuenta. |
| Autorizar e iniciar sesión en su cuenta Microsoft | Valide y autorice la aplicación Webex para conectarse a su cuenta Microsoft. |
Estos permisos se utilizan solo durante el proceso de configuración y no se almacenan.
Permisos de servicio
NO se necesita permiso de servicio específico. Los administradores pueden administrar la función y la configuración en Control Hub con los detalles de la sección a continuación.
Administración y autorización de funciones de integración de Copilot en Control Hub
Los administradores pueden activar o desactivar la función para su organización, o pueden decidir qué una o más fuentes se pueden otorgar con casillas de verificación.
Para obtener más información, consulte Configurar integraciones de IA en Control Hub y Activar o desactivar las fuentes de Cisco AI Assistant búsqueda en Webex App
Configuración y configuraciones de la aplicación Webex
Los usuarios pueden iniciar sesión en la aplicación Webex y autorizar la conexión de la cuenta Microsoft después de que el administrador active la función con autorización mediante Control Hub
Para obtener más información, consulte Acceder a sus datos de Microsoft con Cisco AI Assistant