- Главная
- /
- Статья
Интеграция с Microsoft Copilot позволяет пользователям Webex Meeting безопасно подключаться к своим учетным записям Microsoft Copilot в качестве одного из источников данных.
Сводка
Используя Cisco AI Assistant приложение Webex, пользователи могут искать, анализировать и суммировать результаты из источников данных Microsoft, включая SharePoint, OneDrive и Copilot Connectors.
Обзор архитектуры
Подключение к Microsoft Copilot позволяет взаимодействовать с источниками данных Microsoft с помощью API-интерфейсов Microsoft Retrieval. При использовании программа извлекает данные из ваших источников Microsoft в режиме реального времени. Cisco AI Assistant
Webex не хранит и не сохраняет данные, возвращенные вам через. Cisco AI Assistant Данные используются только в момент получения ответа, что обеспечивает защиту вашей конфиденциальности .
Подробные инструкции по потоку данных
Управление пользователями и их назначение
Администраторы могут управлять пользователями с лицензиями Microsoft Copilot и включать или отключать эту функцию на уровне организации, пользователя или шаблона с помощью Control Hub.
Авторизация и подключение пользователей
-
Пользователь входит в приложение Webex
-
Пользователь переходит на страницу настроек, чтобы подключить свою учетную запись Microsoft.
Пользователь завершает процесс авторизации и выбирает источники (SharePoint, OneDrive или Copilot Connector) для доступа.
Рабочий процесс вопросов и ответов
Пользователь задает вопрос, например: каков статус проекта ABC?
Следующие шаги будут выполнены службой Webex Meeting Service с использованием нескольких подшагов:
-
Расшифровка: система расшифровывает запрос.
-
Загрузка контекста: соответствующий контекст загружен.
-
Обоснование LLM: LLM переписывает вопрос для оптимального поиска.
-
Получите информацию об интеграции: система извлекает конфигурацию и токены для многопутевого поиска.
-
Многопутевой поиск: система выполняет поиск по всем поддерживаемым инструментам Microsoft.
-
Поиск: инструменты многопутевого поиска позволяют осуществлять поиск подробного содержимого.
-
Возвращает результат поиска: инструменты многопутевого поиска возвращают результат поиска.
-
-
Переранжирование и фильтрация. Служба конференций Webex использует LLM для изменения рейтинга и фильтрации контента на предмет релевантности.
-
Генерация: LLM генерирует окончательный ответ с цитатами.
-
Ответ: опубликуйте окончательный ответ в приложении Webex.
Обработка данных
Обработка данных
Эта функция использует следующие данные и сведения о конфигурации сервиса для управления авторизацией, получения авторизованного содержимого Microsoft 365 и предоставления ответов в приложении Webex:
-
Регистрация приложения Microsoft:
Регистрация приложений Microsoft представляет собой конфигурацию клиента OAuth 2.0, зарегистрированную на портале Microsoft Azure (Entra ID) для интеграции. Cisco AI Assistant
Эта регистрация определяет конкретные делегированные разрешения, необходимые в процессе авторизации учетной записи Microsoft:
-
Read.All и Sites.Read.All: необходимы для доступа к содержимому SharePoint и OneDrive.
-
ExternalItem.read.all: требуется для доступа к содержимому Copilot Connectors.
Cisco AI Assistantиспользует эту регистрацию, чтобы найти правильные настройки OAuth для входа и получения токенов перед вызовом API Microsoft 365 Copilot Retrieval. Дополнительные сведения см. в разделе «Регистрация в Microsoft Azure». Cisco AI Assistant
-
-
Токены Microsoft OAuth:
Токены Microsoft OAuth — это токены делегированного доступа с коротким сроком действия, выдаваемые Microsoft Entra ID после входа пользователя в свою учетную запись Microsoft на странице настроек приложения Webex и предоставления необходимых разрешений.
Cisco AI Assistantиспользует эти токены для вызова API Microsoft 365 Copilot Retrieval от имени пользователя. Microsoft Entra ID использует эти токены для аутентификации каждого запроса, идентификации пользователя и обеспечения соблюдения политик управления доступом и информационных барьеров Microsoft 365, гарантируя возврат только того контента, к которому разрешен доступ вошедшему пользователю.
Продление токена
Во время первоначальной авторизации Microsoft Entra ID выдает токен доступа с коротким сроком действия (срок действия примерно 60—90 минут) и токен обновления с длительным сроком действия. Webex надежно хранит токен обновления на стороне сервера, привязанный к учетной записи пользователя Webex.
Токены доступа не обновляются постоянно. Вместо этого, когда пользователь отправляет запрос, Webex проверяет, действителен ли текущий токен доступа. Если срок его действия истек, Webexsilently обменивает токен обновления на новый токен доступа. Срок действия токена обновления продлевается при каждом его использовании, что позволяет сеансу оставаться активным без вмешательства пользователя, пока функция используется регулярно.
Прекращение сеанса
Сеанс прерван, и требуется повторная аутентификация при следующих условиях:
-
Бездействие: пользователь не использовал эту функцию в течение длительного периода времени (обычно 90 дней, в зависимости от политики Microsoft Entra ID по умолчанию и конфигурации клиента).
-
Отключение вручную: пользователь явно отключает свою учетную запись Microsoft от настроек приложения Webex.
-
Административное управление: администратор Microsoft 365 отменяет доступ приложения к Entra ID.
-
Изменения конфигурации: изменены предоставленные области разрешений или изменена регистрация приложения.
Дополнительные сведения см. в разделе «Авторизация учетной записи Microsoft в приложении Webex».
-
-
Текст подсказки:
Текст запроса — это введенные пользователем данные на естественном языкеCisco AI Assistant, например запрос на определение статуса проекта или поиск документа в своей учетной записи Microsoft. Этот текст генерируется пользователем во время выполнения.
Рабочий процесс обработки
После отправки запроса выполните Cisco AI Assistant следующие действия для получения и представления информации:
-
Интерпретация и оптимизация: помощник интерпретирует запрос, выполняет аргументацию и переписывает запрос, чтобы получить оптимизированную строку запроса.
-
Вызов API. Помощник запускает API извлечения данных Microsoft 365 Copilot для одного или нескольких источников данных .
-
Фильтрация. Там, где это применимо, используются выражения фильтров на языке запросов по ключевым словам (KQL), чтобы охватить извлечение данных определенными сайтами, библиотеками документов, типами файлов или диапазонами дат.
-
Переранжирование и синтез: помощник повторно ранжирует и фильтрует возвращенные фрагменты текста. Затем он генерирует окончательный ответ, в котором исходная подсказка сочетается с полученным содержимым, включая ссылки на исходные документы.
-
-
Содержимое SharePoint и OneDrive. Содержимое SharePoint и OneDrive — это авторизованные данные Microsoft 365, полученные с помощью API извлечения Microsoft 365 Copilot Retrieval для ответа на запрос пользователя. API извлечения извлекает соответствующие фрагменты текста непосредственно из индекса гибридного содержимого Microsoft 365 без дублирования, экспорта или отдельной индексации данных.
Поддерживаемые типы файлов: .docx, .pptx, .pdf, .aspx и .one; нетекстовое содержимое, такое как изображения и диаграммы, не поддерживается.
Все содержимое извлекается в пределах границ доверия Microsoft 365 и строго ограничено файлами и документами, доступ к которым зарегистрированному пользователю разрешен в соответствии с моделью разрешений Microsoft 365.
-
Запрос: Cisco AI Assistant отправляет запрос HTTPS POST по адресу https://graph.microsoft.com/v1.0/copilot/retrieval с токеном делегированного доступа Microsoft Entra ID в заголовке авторизации. Тело запроса содержит:
-
QueryString — переписанный запрос на естественном языке, полученный из командной строки пользователя (максимум 1500 символов).
-
DataSource — задано значение SharePoint или OneDrive (по одному на запрос; для каждого источника выполняются отдельные вызовы).
-
FilterExpression (необязательно) — выражение KQL, определяемое URL-адресом сайта, путем, типом файла или диапазоном дат.
-
Максимальное количество результатов — не более 25 за вызов.
-
-
Ответ: Microsoft 365 обрабатывает запрос в пределах своего доверия и возвращает массив RetrievalHits, каждая запись которого содержит:
-
ContentChunk — фрагмент текста, извлеченный из индекса содержимого
-
Показатель релевантности — показатель косинусного сходства между запросом и фрагментом, нормализованный до диапазона 0—1
-
метаданные ресурса — источника, включая имя файла, URL-адрес, автора и дату последнего изменения
-
-
Обработка данных: полное содержимое файла не передается — возвращаются только предварительно извлеченные фрагменты текста из гибридного индекса Microsoft 365. Cisco AI Assistantвременно передает эти фрагменты в свой LLM для переранжирования, фильтрации и генерации ответов. Исходные метаданные используются для создания ссылок в окончательном ответе. Фрагменты текста не сохраняются Webex по истечении срока действия запроса.
-
-
Содержимое Copilot Connectors: содержимое Copilot Connectors — это сторонние или пользовательские корпоративные данные, которые поступают в индекс содержимого Microsoft 365 с помощью коннекторов Microsoft Graph и доступны для извлечения с помощью API извлечения Microsoft 365 Copilot. Весь возвращаемый контент ограничен элементами, доступ к которым зарегистрированному пользователю разрешен в соответствии с настроенными разрешениями соединителя в Microsoft 365.
-
Запрос: Cisco AI Assistant отправляет запрос HTTPS POST по адресу https://graph.microsoft.com/v1.0/copilot/retrieval с токеном делегированного доступа Microsoft Entra ID в заголовке авторизации. Тело запроса содержит:
-
QueryString — переписанный запрос на естественном языке, полученный из командной строки пользователя (максимум 1500 символов).
-
В качестве источника данных задано значение CopilotConnectors.
-
FilterExpression (опционально) — выражение KQL, предназначенное для извлечения данных в определенные источники или типы содержимого коннектора.
-
Максимальное количество результатов — не более 25 за вызов.
-
-
Ответ: Microsoft 365 обрабатывает запрос в пределах своего доверия и возвращает массив RetrievalHits, каждая запись которого содержит:
-
ContentChunk — фрагмент текста, извлеченный из проиндексированного стороннего контента.
Показатель релевантности — показатель косинусного сходства между запросом и фрагментом, нормализованный до диапазона 0—1. Обратите внимание, что оценка релевантности может быть представлена не для всех результатов Copilot Connector.
метаданные источника ресурсов, включая имя элемента, URL-адрес и атрибуты, определенные соединителем.
-
-
-
Обработка данных: полное исходное содержимое не передается — возвращаются только предварительно извлеченные фрагменты текста из индекса содержимого Microsoft 365. Поскольку API Retrieval нацелен на один источник данных за каждый вызов, на этапе изменения рейтинга он выполняет отдельные Cisco AI Assistant запросы на извлечение данных для SharePoint, OneDrive и Copilot Connectors и объединяет результаты.
Фрагменты текста временно передаются в LLM для изменения рейтинга, фильтрации и генерации ответов и не сохраняются в Webex по истечении срока действия запроса.
Аутентификация и авторизация
Webex взаимодействует с вашими учетными записями и контентом Microsoft с помощью Microsoft Retrieval API, аутентификация и управление которым осуществляет поставщик удостоверений Microsoft ( IdP). Вся связь с Microsoft IdP и API поиска защищена соединениями, защищенными TLS.
Аутентификация в службе Webex
Cisco AI Assistantв приложении Webex для взаимодействия со службами Webex используются стандартные потоки OAuth 2.0:
-
Поставщик удостоверений: служба идентификации Webex выступает в качестве облачного IdP для аутентификации пользователей и авторизации доступа к API.
-
Токены предъявителя: запросы к API Webex авторизуются с использованием токенов на предъявителя, выпущенных службой идентификации Webex.
-
Безопасная связь: весь обмен данными между Webex, службой идентификации Webex и API Webex осуществляется через соединенияAI Assistant, защищенные TLS.
Административные требования
Чтобы включить эту интеграцию, администраторы должны выполнить следующие шаги:
-
Конфигурация Microsoft 365: администраторы должны назначить соответствующие лицензии Microsoft Copilot соответствующим пользователям.
-
Конфигурация Webex: администраторы могут включать или отключать эту функцию на уровне организации, пользователя или шаблона непосредственно в Control Hub.
Разрешения, согласованные пользователем
Во время настройки запрашиваются следующие разрешения:
| Требуется разрешение | Назначение |
|---|---|
| Приложение Webex Войдите в систему и прочитайте профиль пользователя | Войдите в приложение Webex со своей учетной записью. |
| Авторизуйтесь и войдите в свою учетную запись Microsoft | Подтвердите и авторизуйте приложение Webex для подключения к учетной записи Microsoft. |
Эти разрешения используются только в процессе установки и не сохраняются.
Разрешения на обслуживание
Специальное разрешение на обслуживание НЕ требуется. Администраторы могут управлять функцией и настройками в Control Hub, подробно описав раздел ниже.
Интеграция со всеми функциями интеграции с Copilot, управление ими и авторизация в Control Hub
Администраторы могут включить или выключить эту функцию в своей организации или решить, какой из источников можно предоставить, установив флажки.
Дополнительные сведения см. в разделах Настройка интеграции искусственного интеллекта в Control Hub и Включение или выключение источников Cisco AI Assistant поиска в приложении Webex
Настройки и конфигурации приложения Webex
Пользователи могут войти в приложение Webex и авторизоваться на подключение учетной записи Microsoft после того, как администратор включит эту функцию с авторизацией с помощью Control Hub
Дополнительные сведения см. в разделе Доступ к данным Microsoft с помощью Cisco AI Assistant