- Domov
- /
- Článok
Integrácia s aplikáciou Microsoft Copilot umožňuje používateľom stretnutí Webex bezpečne sa pripojiť k ich účtom Microsoft Copilot ako k jednému zo zdrojov údajov.
Zhrnutie
Využitím aplikácie Cisco AI Assistant Webex môžu používatelia vyhľadávať, analyzovať a sumarizovať výsledky zo zdrojov údajov spoločnosti Microsoft vrátane konektorov SharePoint, OneDrive a Copilot Connectors.
Prehľad architektúry
Pripojenie k aplikácii Microsoft Copilot umožňuje interakciu so zdrojmi údajov spoločnosti Microsoft pomocou rozhraní API programu Microsoft Retrieval. Keď používateCisco AI Assistant, načíta údaje zo zdrojov spoločnosti Microsoft v reálnom čase.
Webex neukladá ani neuchováva údaje, ktoré vám boli vrátené prostredníctvom. Cisco AI Assistant Údaje sa používajú iba v danom okamihu na generovanie vašej odpovede, čím sa zabezpečí, že vaše súkromie zostane chránené.
Podrobné kroky toku údajov
Správa používateľov a priradenie
Správcovia môžu spravovať používateľov, ktorí majú licencie Microsoft Copilot, a zapnúť alebo vypnúť funkciu na úrovni organizácie, používateľa alebo šablóny pomocou Control Hub.
Autorizácia používateľa a pripojenie
-
Používateľ sa prihlási do aplikácie Webex
-
Používateľ prejde na stránku Nastavenia a pripojí svoje konto Microsoft.
Používateľ dokončí proces autorizácie a vyberie zdroje (SharePoint, OneDrive alebo Copilot Connector), ktoré majú pristupovať.
Pracovný postup otázok a odpovedí
Používateľ kladie otázku, napríklad: aký je stav projektu ABC?
Nasledujúce kroky budú vykonané pomocou viacerých podkrokov pomocou služby Webex Meeting Service:
-
Dešifrovať: systém dešifruje požiadavku.
-
Načítať kontext: načíta sa relevantný kontext.
-
Odôvodnenie LLM: LLM prepíše otázku kvôli optimálnemu získaniu.
-
Získajte informácie o integrácii: systém načí ta konfiguráciu a tokeny na vyhľadávanie viacerými cestami.
-
Vyhľad@@ ávanie viacerými cestami: systém spúšťa vyhľad ávanie naprieč podporovanými nástrojmi spoločnosti Microsoft.
-
Vyhľadávanie: nástroje na vyhľadávanie viacerých ciest vyhľadávajú podrobný obsah.
-
Vrátiť výsledok vyhľadávania: nástroje na vyhľadávanie viacerých ciest vracajú výsledok vyhľadávania.
-
-
Prehodnotenie a filtrovanie: Služba stretnutí Webex používa LLM na obnovenie a filtrovanie obsahu podľa relevantnosti.
-
Generácia: LLM generuje konečnú odpoveď s citáciami.
-
Odpoveď: zve rejnite konečnú odpoveď na aplikáciu Webex.
Zaobchádzanie s údajmi
Zaobchádzanie s údajmi
Táto funkcia používa nasledujúce údaje a informácie o konfigurácii služby na správu autorizácie, načítanie autorizovaného obsahu Microsoft 365 a poskytovanie odpovedí v aplikácii Webex:
-
Registrácia aplikácií spoločnosti Microsoft:
Registrácia aplikácií spoločnosti Microsoft predstavuje konfiguráciu klienta OAuth 2.0 zaregi strovanú na portáli Microsoft Azure (Entra ID) na integráciu Cisco AI Assistant .
Táto registrácia definuje konkrétne delegované povolenia požadované počas toku autorizácie konta Microsoft:
-
Read.All a Sites.Read.All: vyžaduje sa na prístup k obsahu SharePoint a OneDrive.
-
ExternalItem.read.all: vyžaduje sa na prístup k obsahu Copilot Connectors.
Cisco AI Assistantpoužíva túto registráciu na vyhľadanie správnych nastavení OAuth pre prihlásenie a získavanie token ov pred vyvolaním rozhrania Microsoft 365 Copilot Retrieval API. Ďalšie informácie nájdete v časti „Registrácia Cisco AI Assistant v službe Microsoft Azure“.
-
-
Tokeny Microsoft OAuth:
Tokeny Microsoft OAuth sú krátkodobé delegované prístupové tokeny vydané spoločnosťou Microsoft Entra ID, keď sa používateľ prihlási do svojho konta Microsoft prostredníctvom stránky nastavení aplikácie Webex a udelí potrebné povolenia.
Cisco AI Assistantpoužíva tieto tokeny na volanie rozhrania Microsoft 365 Copilot Retrieval API v mene používateľa . Microsoft Entra ID používa tieto tokeny na overenie každej žiadosti, identifikáciu používateľa a presadzovanie pravidiel kontroly prístupu a informačných bariér spoločnosti Microsoft 365, čím zabezpečuje, že sa vráti iba obsah, ku ktorému má prihlásený používateľ povolený prístup.
Obnova tokenu
V čase počiatočnej autorizácie vydáva Microsoft Entra ID krátkodobý prí stupový token (platný približne 60 - 90 minút) a obnovovací token s dlhou životnosťou. Webex bezpečne ukladá obnovovací token na strane servera viazaný na identitu Webex používateľa.
Prístupové tokeny sa nepretržite obnovujú. Namiesto toho, keď používateľ odošle žiadosť, Webexskontroluje, či je aktuálny prístupový token stále platný. Ak vypršala platnosť, Webexticho vymení obnovovací token za nový prístupový token. Plat nosť obnovovacieho tokenu sa predlžuje pri každom použití, čo umožňuje relácii zostať aktívna bez zásahu používateľa, pokiaľ sa funkcia pravidelne používa.
Ukončenie relácie
Relácia je ukončená a vyžaduje sa opätovná autentifikácia za nasledujúcich podmienok:
-
Nečinnosť: Používateľ túto funkciu nepoužíval dlhšie (zvyčajne 90 dní, v závislosti od predvolenej politiky Microsoft Entra ID a konfigurácie nájomcu zákazníka).
-
Manuálne odpojenie: Pou žívateľ výslovne odpojí svoje konto Microsoft od nastavení aplikácie Webex.
-
Správca: Správca služby Microsoft 365 zruší prístup aplikácie v Entra ID.
-
Zmeny konfigurácie: Udeľované rozsahy povolení sú upravené alebo sa zmen í registrácia aplikácie.
Ďalšie informácie nájdete v časti „Autorizácia konta Microsoft v aplikácii Webex“.
-
-
Text výzvy:
Text výzvy sa vzťahuje na vstup v prirodzenom jazyku zadaný používateľom v rámci programuCisco AI Assistant, napríklad žiadosť o nájdenie stavu projektu alebo vyhľadanie dokumentu v rámci svojho konta Microsoft. Tento text je generovaný používateľom v čase spustenia.
Pracovný postup spracovania
Pri odoslaní výzvy postupu Cisco AI Assistant jte podľa týchto krokov na získanie a prezentáciu informácií:
-
Interpretácia a optimalizácia: Asistent interpretuje výzvu, vykonáva zdôvodnenie a vykoná prepísanie dotazu, aby vytvoril optimalizovaný reťazec dotazu.
-
Invokácia rozhrania API: Asistent vyvolá rozhranie Microsoft 365 Copilot Retrieval API proti jednému alebo viacerým zdrojom údajov.
-
Filtrovanie: Ak je to vhodné, výrazy filtra Keyword Query Language (KQL) sa používajú na rozsah vyhľadávania na konkrétne lokality, knižnice dokumentov, typy súborov alebo rozsahy dátumov.
-
Prehodnotenie a syntéza: Asistent prehodnocuje a filtruje vrátené časti textu. Potom vygeneruje konečnú odpoveď, ktorá kombinuje pôvodnú výzvu s načítaným obsahom vrátane citácií späť do zdrojových dokumentov.
-
-
Obsah SharePoint a OneDrive: Obsah SharePoint a OneDrive je autorizovaný dáta Microsoft 365 získaný prostredníctvom rozhrania Microsoft 365 Copilot Retrieval API na odpoveď na žiadosť používateľa. Rozhranie API pre vyhľadávanie extrahuje relevantné časti textu priamo z indexu hybridného obsahu Microsoft 365 bez duplikovania, exportu alebo samostatnej indexácie akýchkoľvek údajov.
Podporované typy súborov: .docx, .pptx, .pdf, .aspx a.one; netexový obsah, ako sú obrázky a grafy, nie je podporovaný.
Všetok obsah sa načíta v rámci hranice dôveryhodnosti spoločnosti Microsoft 365 a je prísne obmedzený na súbory a dokumenty, ku ktorým má prihlásený používateľ oprávnený prístup v rámci modelu povolení Microsoft 365.
-
Žiadosť: Cisco AI Assistant odošle požiadavku HTTPS POST na adresu https://graph.microsoft.com/v1.0/copilot/retrieval, pričom v hlavičke autorizácie obsahuje token delegovaného prístupu Microsoft Entra ID. Orgán žiadosti obsahuje:
-
QueryString — prepísaný dotaz prirodzeného jazyka odvodený z výzvy používateľa (max. 1 500 znakov).
-
DataSource — nastavte na SharePoint alebo OneDrive (jeden na žiadosť; pre každý zdroj sa uskutočňujú samostatné hovory).
-
FilterExpression (voliteľné) — výraz KQL podľa adresy URL lokality, cesty, typu súboru alebo rozsahu dátumov.
-
MaximumNumberOfResults — obmedzené na 25 na hovor.
-
-
Odpoveď: Microsoft 365 spracuje požiadavku v rámci svojej hranice dôveryhodnosti a vráti pole RetrievalHits, pričom každá položka obsahuje:
-
ContentChunk — extrahovaný textový úryvok z indexu obsahu
-
RelevanceSkóre podobnosti jadra a kosínu medzi dotazom a časťou, normalizované na rozsah 0—1
-
zdroj — zdrojové metadáta vrátane názvu súboru, adresy URL, autora a dátumu poslednej úpravy
-
-
Spracovanie údajov: Neprenáša sa žiadny úplný obsah súboru — vrátia sa iba vopred extrahované časti tex tu z hybridného indexu Microsoft 365. Cisco AI Assistanttieto kúsky prechodne odovzdáva svojmu LLM na prehodnotenie, filtrovanie a generovanie odpovedí. Zdrojové metadáta sa používajú na vytvorenie citácií v konečnej odpovedi. Webex neukladá textové kúsky po dobu trvania žiadosti.
-
-
Obsah konektorov Copilot: Obsah Copilot Connectors sú údaje tretích strán alebo vlastné podnikové údaje prijaté do indexu obsahu Microsoft 365 prostredníctvom konektorov Microsoft Graph a získavateľné prostredníctvom rozhrania Microsoft 365 Copilot Retrieval API. Všetok vrátený obsah je obmedzený na položky, ku ktorým má prihlásený používateľ oprávnený prístup v rámci nakonfigurovaných povol ení konektora v systéme Microsoft 365.
-
Žiadosť: Cisco AI Assistant odošle požiadavku HTTPS POST na adresu https://graph.microsoft.com/v1.0/copilot/retrieval, pričom v hlavičke autorizácie obsahuje token delegovaného prístupu Microsoft Entra ID. Orgán žiadosti obsahuje:
-
QueryString — prepísaný dotaz prirodzeného jazyka odvodený z výzvy používateľa (max. 1 500 znakov).
-
DataSource - nastavený na CopilotConnectors.
-
FilterExpression (voliteľné) — výraz KQL na vyhľadávanie rozsahu do konkrétnych zdrojov konektorov alebo typov obsahu.
-
MaximumNumberOfResults — obmedzené na 25 na hovor.
-
-
Odpoveď: Microsoft 365 spracuje požiadavku v rámci svojej hranice dôveryhodnosti a vráti pole RetrievalHits, pričom každá položka obsahuje:
-
ContentChunk — extrahovaný textový úryvok z indexovaného obsahu tretej strany.
RelevanceCore — skóre podobnosti kosínu medzi dotazom a časťou, normalizované na rozsah 0—1. Upozorňujeme, že skóre relevantnosti nemusí byť prítomné pre všetky výsledky Copilot Connector.
zdrojové metadáta vrátane názvu položky, adresy URL a atribútov definovaných konektorom.
-
-
-
Spracovanie údajov: Neprenáša sa žiadny úplný zdrojový obsah — vrátia sa iba vopred extrahované časti textu z indexu obsahu Microsoft 365. Keďže rozhranie API vyhľadávania sa zameriava na jeden zdroj údajov na hovor, vy Cisco AI Assistant dáva samostatné volania na vyhľadávanie pre konektory SharePoint, OneDrive a Copilot a spája výsledky počas kroku prehodnotenia .
Textové kúsky sa prechodne odovzdávajú LLM na prehodnotenie, filtrovanie a generovanie odpovedí a Webex ich neukladá po dobu trvania žiadosti.
Autentifikácia a autorizácia
Webex interaguje s vašimi účtami a obsahom spoločnosti Microsoft pomocou rozhrania Microsoft Retrieval API, ktoré overuje a sprav uje poskytovateľ identity spoločnosti Microsoft (IdP). Všetka komunikácia s Microsoft iDP a rozhraním API pre vyhľadávanie je chránená pripojením zabezpečeným TLS.
Overovanie služby Webex
Cisco AI AssistantWebex App využíva štandardné toky OAuth 2.0 na interakciu so službami Webex:
-
Poskytovateľ identity: Webex Identity Service funguje ako cloudový iDP na autentifikáciu používateľov a autorizáciu prístupu k rozhraniu API.
-
Tokeny na nosiča: Žiadosti o rozhrania API Webex sú autorizované pomocou tokenov nosiča vydaných službou Webex Identity Service.
-
Bezpečná komunikácia: Všetka výmena dát medzi WebexAI Assistant, Webex Identity Service a Webex API sa uskutočňuje prostredníctvom pripojení zabezpečených TLS.
Administratívne požiadavky
Ak chcete povoliť túto integráciu, správcovia musia vykonať nasledujúce kroky:
-
Konfigurácia Microsoft 365: Správcovia musia príslušným používateľom priradiť príslušné licencie Microsoft Copilot.
-
Konfigurácia Webex: Správcovia môžu povoliť alebo zakázať funkciu na úrovni organizácie, používateľa alebo šablóny priamo v Control Hub.
Povolenia so súhlasom používateľa
Počas nastavenia sa požadujú nasledujúce povolenia:
| Vyžaduje sa povolenie | Účel |
|---|---|
| Webex App Prihláste sa a prečítajte si používateľský profil | Prihláste sa do aplikácie Webex pomocou svojho účtu. |
| Autorizácia a prihlásenie do svojho konta Microsoft | Overte a autorizujte aplikáciu Webex na pripojenie k vášmu kontu Microsoft. |
Tieto povolenia sa používajú iba počas procesu nastavenia a nie sú uložené.
Servisné povolenia
Nie je potrebné žiadne špecifické povolenie na službu. Správcovia môžu spravovať funkciu a nastavenia v Control Hub s podrobnosťami o sekcii nižšie.
Správa a autorizácia funkcií integrácie Copilot v Control Hub
Správcovia môžu zapnúť alebo vypnúť funkciu pre svoju organizáciu alebo sa môžu rozhodnúť, ktorý zdroj alebo viac zdrojov možno udeliť pomocou začiarkavacích políčok.
Ďalšie informácie nájdete v téme Nastav enie integrácií AI v Control Hub a Zapnutie alebo vypnutie zdrojov Cisco AI Assistant vyhľadávania v aplikácii Webex
Nastavenia a konfigurácie aplikácie Webex
Používatelia sa môžu prihlásiť do aplikácie Webex a oprávniť na pripojenie konta Microsoft po tom, ako správca zapne funkciu s autorizáciou pomocou Control Hub
Ďalšie informácie nájdete v téme Prí stup k údajom spoločnosti Microsoft pomocou Cisco AI Assistant