- Головна
- /
- Стаття
Інтеграція з Microsoft Copilot дозволяє користувачам зустрічей Webex безпечно підключатися до своїх облікових записів Microsoft Copilot як одного з їхніх джерел даних.
Короткий зміст
Використовуючи Cisco AI Assistant додаток Webex, користувачі можуть шукати, аналізувати та узагальнювати результати з джерел даних Microsoft, включаючи SharePoint, OneDrive та Copilot Connectors.
Огляд архітектури
Підключення до Microsoft Copilot дозволяє взаємодіяти з джерелами даних Майкрософт за допомогою API Microsoft Retrieval. Коли ви використовуєтеCisco AI Assistant, він отримує дані з ваших джерел Microsoft у режимі реального часу.
Webex не зберігає і не зберігає дані, повернуті вам черезCisco AI Assistant. Дані використовуються лише в даний момент для створення вашої відповіді, гарантуючи, що ваша конфіденційність залишається захищеною.
Детальні кроки потоку даних
Управління та призначення користувачів
Адміністратори можуть керувати користувачами, які мають ліцензії Microsoft Copilot, і вмикати або вими кати функцію на рівні організації, користувача або шаблону за допомогою центру керування.
Авторизація користувача та підключення
-
Користувач увійде в додаток Webex
-
Користувач переходить на сторінку Н алаш тування, щоб підключити свій обліковий запис Microsoft.
Користувач завершує процес авторизації та вибирає джерела (SharePoint, OneDrive або Copilot Connector) для доступу.
Робочий процес запитань і відповідей
Користувач задає питання, наприклад: який статус проекту ABC?
Наступні кроки будуть виконані за допомогою декількох підкроків службою Meeting Service Webex:
-
Розшифрувати: система розшифровує запит.
-
Завантажити контекст: завантажується відповідний контекст.
-
Міркування LLM: LLM переписує питання для оптимального пошуку.
-
Отримати інформацію про інтеграцію: система отримує конфігурацію та токени для пошуку за кількома шляхами.
-
Пошук за кількома шляхами: система виконує пошук у підтримуваних інструментах Microsoft.
-
Пошук: інструменти пошуку декількох шляхів пошуку детального вмісту.
-
Повернути результат пошуку: інструменти пошуку за кількома шляхами повертають результат пошуку.
-
-
Переоцінка та фільтрація: служба нарад Webex використовує LLM для перенаправлення та фільтрації вмісту за релевантністю.
-
Генерація: LLM генерує остаточну відповідь з цитатами.
-
Відповідь: опу блікувати остаточну відповідь на додаток Webex.
Обробка даних
Обробка даних
Ця функція використовує такі дані та інформацію про конфігурацію служби для керування авторизацією, отримання авторизованого вмісту Microsoft 365 та надання відповідей у програмі Webex:
-
Ре@@ єстрація програми Microsoft:
Реєстрація програми Microsoft представляє конфігурацію клієнта OAuth 2.0, зареєстровану на порталі Microsoft Azure (ідентифікатор Entra) для інтеграції. Cisco AI Assistant
Ця реєстрація визначає конкретні делеговані дозволи, необхідні під час потоку авторизації облікового запису Microsoft:
-
Read.All і Сайти.Читати.Все: необхідні для доступу до вмісту SharePoint та OneDrive.
-
ExternalItem.READ.ALL: необхідний для доступу до вмісту роз'ємів Copilot.
Cisco AI Assistantвикористовує цю реєстрацію для пошуку правильних налаштувань OAuth для входу та отримання токенів перед викликом API відновлення Microsoft 365 Copilot. Докладніші відомості див. у розділі «Ре Cisco AI Assistant єстрація в Microsoft Azure».
-
-
Токени OAuth Майкрософт:
Токени Microsoft OAuth — це короткочасні делеговані токени доступу, видані Microsoft Entra ID, коли користувач ввійде до свого облікового запису Microsoft через сторінку налаштувань програми Webex і надає необхідні дозволи.
Cisco AI Assistantвикористовує ці токени для виклику API відновлення Microsoft 365 Copilot від імені користувача . Microsoft Entra ID використовує ці токени для автентифікації кожного запиту, ідентифікації користувача та забезпечення політики контролю доступу та інформаційного бар'єру Microsoft 365, гарантуючи, що повертається лише вміст, доступ до якого користувачеві дозволено отримати доступ.
Поновлення токена
Під час первинної авторизації Microsoft Entra ID видає як короткочасний токен доступу (дійсний приблизно 60—90 хвилин), так і довговічний маркер оновлення. Webex надійно зберігає маркер оновлення на стороні сервера, прив'язаний до ідентичності користувача Webex.
Токени доступу не оновлюються постійно. Натомість, коли користувач подає запит, Webex перевіряє, чи поточний маркер доступу все ще дійсний. Якщо термін дії закінчився, Webex безшумно обмінює токен оновлення на новий токен доступу. Термін дії токена оновлення продовжується кожного разу, коли він використовується, що дозволяє сеансу залишатися актив ним без втручання користувача до тих пір, поки функція регулярно використовується.
Припинення сеансу
Сеанс припиняється і необхідна повторна аутентифікація за наступних умов:
-
Бездіяльність: користувач не використовував цю функцію протягом тривалого періоду (зазвичай 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, щоб відповісти на запит користувача. 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 символів).
-
Джерело даних — встановлено на SharePoint або OneDrive (по одному на запит; для кожного джерела проводяться окремі викли ки).
-
FilterExpression (необов'язково) —Вираз KQL для сфери застосування за URL-адресою сайту, шляхом, ти пом файлу або діапазоном дат.
-
Максимальна кількість результатів — обмежена 25 за дзвінок.
-
-
Відповідь: Microsoft 365 обробляє запит у межах своєї межі довіри та повертає масив RetrievalHits, причому кожен запис містить:
-
ContentChunk — витягнутий фрагмент тексту з індексу вмісту
-
Релевантність Оцінка подібності ядра — косинуса між запитом і фрагментом, нормалізована до діапазону 0—1
-
ресурс — вихідні метадані, включаючи ім'я файлу, URL-адресу, автора та дату останньої зміни
-
-
Обробка даних: повний вміст файлу не передається — повертаються лише попередньо витягнуті фрагменти тексту з гі бридного індексу Microsoft 365. Cisco AI Assistantтимчасово передає ці фрагменти своєму LLM для повторного аналізу, фільтрації та генерації відповідей. Метадані джерела використовуються для побудови цитат у остаточній відповіді. Текстові фрагменти не зберігаються Webex після тривалості запиту.
-
-
Вміст конекторів Copilot: Вміст 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 символів).
-
Джерело даних — встановлено значення Копілот-з'єднувачі.
-
FilterExpression (необов'язково) —вираз KQL для пошуку сфери застосування до певних джерел роз 'ємів або типів вмісту.
-
Максимальна кількість результатів — обмежена 25 за дзвінок.
-
-
Відповідь: Microsoft 365 обробляє запит у межах своєї межі довіри та повертає масив RetrievalHits, кожен запис містить:
-
ContentChunk — витягнутий фрагмент тексту з індексованого стороннього вмісту.
Значення релевантності Core—косинусоподібність між запитом і фрагментом, нормалізована до діапазону 0—1. Зверніть увагу, що оцінка релевантності може бути відсутня для всіх результатів Copilot Connector.
ресурс — метадані джерела, включаючи назву елемента, URL-адресу та атрибути, визначені з'єднувачем.
-
-
-
Обробка даних: повний вихідний вміст не передається — повертаються лише попередньо витягнуті фрагменти тексту з індексу вмісту Microsoft 365. Оскільки API пошуку націлений на одне джерело даних за виклик, видає окремі Cisco AI Assistant виклики пошуку для SharePoint, OneDrive та Copilot Connectors та об'єднує результати під час кроку повторного анкетування.
Текстові фрагменти тимчасово передаються LLM для повторного аналізу, фільтрації та генерації відповідей , і не зберігаються Webex після тривалості запиту.
Аутентифікація та авторизація
Webex взаємодіє з вашими обліковими записами та вмістом Microsoft за допомогою API Microsoft Retrieval API, який автенти фікується та керується постачальником ідентифікацій Microsoft (IdP). Весь зв'язок з Microsoft IdP та API пошуку захищено з'єднаннями, захищеними TLS.
Аутентифікація служби Webex
Cisco AI Assistantу програмі Webex використовує стандартні потоки OAuth 2.0 для взаємодії з службами Webex:
-
Постачальник ідентифікації: Служба ідентифікації Webex діє як хмарний Іден тифікатор для автентифікації користувачів та авторизації доступу до API.
-
Токени на пред'явника: Запити до API Webex авторизуються за допомогою токенів на пред'явника, виданих служ бою ідентифікації Webex.
-
Безпечний зв'язок: Весь обмін даними між WebexAI Assistant, службою іденти фікації Webex та API Webex здійснюється через з'єднання, захищені TLS.
Адміністративні вимоги
Щоб увімкнути цю інтеграцію, адміністратори повинні виконати наступні дії:
-
Кон@@ фігурація Microsoft 365: Адміністратори повинні призначити відповід ним користувачам відповідні ліцензії Microsoft Copilot.
-
Кон@@ фігурація Webex: Адміністратори можуть ввімкнути або вимкнути функцію на рівні організації, користувача або шаблону безпосередньо в Центрі керування.
Дозволи, погоджені користувачем
Під час налаштування вимагаються такі дозволи:
| Потрібен дозвіл | Призначення |
|---|---|
| Додаток Webex Увійдіть і прочитайте профіль користувача | Увійдіть у додаток Webex за допомогою свого облікового запису. |
| Авторизація та вхід у свій обліковий запис Microsoft | Перевірте та авторизуйте додаток Webex для підключення до вашого облікового запису Microsoft. |
Ці дозволи використовуються лише під час процесу налаштування і не зберігаються.
Дозволи на обслуговування
Не потрібен конкретний дозвіл на обслуговування. Адміністратори можуть керувати функцією та налаштуваннями в Центрі керування з наведеними нижче відомостями розділу.
Управління функціями інтеграції Copilot та авторизація в Control Hub
Адміністратори можуть увімкнути або вимкнути цю функцію для своєї організації, або вони можуть визначати, яке одне або кілька джерел можна надати за допомогою прапорців.
Докладніші відомості див. у статті Налаштування інтеграції штучного інтелекту в Центрі керування та Уві мк Cisco AI Assistant нення або вимкнення джерел пошуку в програмі Webex
Налаштування та конфігурації програми Webex
Користувачі можуть увійти в додаток Webex і авторизувати підключення облікового запису Microsoft після того, як адміністратор увімкне функцію з авторизацією за допомогою Control Hub
Докладніші відомості див. розділ Доступ до даних Microsoft за допомогою Cisco AI Assistant