- Kezdőlap
- /
- Cikk
A Microsoft Copilottal való integráció lehetővé teszi a Webex találkozó felhasználók számára, hogy biztonságosan kapcsolatba lépjenek Microsoft Copilot-fiókjaikhoz, mint adatforrásukhoz.
Összefoglaló
A Webex App kihasználásával Cisco AI Assistant a felhasználók kereshetnek, elemezhetik és összefoglalhatják a Microsoft-adatforrásokból származó eredményeket, beleértve a SharePoint, a OneDrive és a Copilot Connectors alkalmazást.
Építészeti áttekintés
A Microsoft Copilot-hoz való csatlakozás lehetővé teszi a Microsoft adatforrásaival való interakciót a Microsoft Retrieval API-k segítségével. A használatakor val Cisco AI Assistant ós időben lekérheti az adatokat a Microsoft-forrásokból.
A Webex nem tárolja és nem őrzi meg az Ön által visszaküldött adatokat. Cisco AI Assistant Az adatokat csak abban a pillanatban használjuk fel a válasz generálására, biztosítva, hogy az Ön adatainak védelme maradjon.
Részletes adatáramlási lépések
Felhasználói kezelés és hozzárendelés
A rendszergazdák kezelhetik a Microsoft Copilot licencekkel rendelkező felhasználókat, és bekapcsolhatják vagy kikapcsolhatják a szolgáltatási, felhasználói vagy sablonszintű funkciót a Vezérlőközpont használatával.
Felhasználói engedélyezés és kapcsolat
-
A felhasználó bejelentkezik a Webex App-ba
-
A felhasználó a Beállí tások oldalra navigál, hogy csatlakoztassa Microsoft-fiókját.
A felhasználó befejezi az engedélyezési folyamatot, és kiválasztja, hogy mely forrásokat (SharePoint, OneDrive vagy Copilot Connector) hozzáférjen.
Kérdés és válasz munkafolyamat
A felhasználó kérdést tesz fel például: mi az ABC projekt állapota?
A következő lépéseket a Webex Meeting Service több allépéssel hajtja végre:
-
Visszafejtés: a rendszer visszaf ejti a kérést.
-
Kontextus betöltése: releváns kontextus betöltődik.
-
LLM érvelés: Az LLM átírja a kérdést az optimális visszakeresés érdekében.
-
Integrációs információk letöltése: a rendszer lek éri a konfigurációt és a tokeneket a több útvonalú kereséshez.
-
Többútvonalú keresés: a rendszer a támogatott Microsoft eszközökön keresztül hajtja végre a visszakeresést.
-
Keresés: többú tvonalú visszakeresési eszközök részletes tartalmat keresnek.
-
Keresési eredmény visszaküldése: a többútvonalú keresési eszközök a keresési eredményt adják vissza.
-
-
Átrangosítás és szűrés: A Webex értekezletszolgáltatás az LLM-et használja a tartalom relevancia szempontjából történő újrarangolására és szűrésére.
-
Generáció: Az LLM idézetekkel generál végső választ.
-
Válasz: adja meg a végső választ a Webex App-ra.
Adatkezelés
Adatkezelés
Ez a szolgáltatás a következő adatokat és szolgáltatáskonfigurációs információkat használja az engedélyezés kezeléséhez, az engedélyezett Microsoft 365-tartalom lekéréséhez és a Webex alkalmazásban válaszok megadásához:
-
Microsoft-alkalmazás regisztrációja:
A Microsoft Application Regisztráció az integrációhoz a Microsoft Azure portálon (Entra ID) regisztrált OAuth 2.0 ügyfélkonfigurációt jelö Cisco AI Assistant li.
Ez a regisztráció meghatározza a Microsoft-fiók engedélyezési folyamatában szükséges konkrét átruházott engedélyeket:
-
Olvas.All és Sites.Read.All: szükséges a SharePoint- és OneDrive-tartal mak eléréséhez.
-
ExternalItem.read.all: szükséges a Copilot Connectors tartalmának eléréséhez.
Cisco AI Assistantezzel a regisztrációval megtalálhatja a megfelelő OAuth beállításokat a bejelentkezéshez és a tokengyűjtéshez, mielőtt meghívná a Microsoft 365 Copilot Retrieval API-t. További információt a „Regisztráció Cisco AI Assistant a Microsoft Azure-ban” című témakörben talál.
-
-
Microsoft OAuth tokenek:
A Microsoft OAuth tokenek rövid élettartamú, delegált hozzáférési tokenek, amelyeket a Microsoft Entra ID ad ki, miután a felhasználó bejelentkezik Microsoft-fiókjába a Webex App beállítási oldalán keresztül, és megadja a szükséges engedélyeket.
Cisco AI Assistantezeket a tokeneket használja a Microsoft 365 Copilot Retrieval API-t a felhasználó nevében történő hívására. A Microsoft Entra ID ezeket a tokeneket használja az egyes kérések hitelesítésére, a felhasználó azonosítására, valamint a Microsoft 365 hozzáférés-ellenőrzési és információgátló házirendek érvényesítésére, biztosítva, hogy csak a bejelentkezett felhasználó által hozzáférhető tartalmak kerüljenek vissza.
Token megújítása
A kezdeti engedélyezés idején a Microsoft Entra ID egyaránt kiadja a rövid élettartamú hozzáférési tokenet (kb. 60—90 percig érvényes), valamint egy hosszú élettartamú frissítési tokent. A Webex biztonságosan tárolja a frissítési token kiszolgálóoldalán, a felhasználó Webex-identitásához kötve.
A hozzáférési tokeneket nem újítják meg folyamatosan. Ehelyett, amikor egy felhasználó kérelmet küld, a Webexellenőrzi, hogy az aktuális hozzáférési token továbbra is érvényes-e. Ha lejárt, a Webexcsendesen kicseréli a frissítési tokenet egy új hozzáférési tokenre. A frissítési token érvényessége minden használat alkalmával meghosszabbodik, így a munkamenet felhasználói beavatkozás nélkül aktív maradhat mindaddig, amíg a funkció rendszeresen használatban van.
Munkamenet lezárása
A munkamenet befejeződik, és a következő feltételek mellett újbóli hitelesítésre van szükség:
-
Inaktivitás: A felhasználó hosszabb ideig nem használta a funkciót (általában 90 napig, a Microsoft Entra ID alapértelmezett házirendjétől és az ügyfél bérlőkonfigurációjától függően).
-
Kézi leválasztás: A felhasználó kifejezetten leválasztja Microsoft- fiókját a Webex App beállításaival.
-
Adminisztráció: A Microsoft 365 rendszergazda visszavonja az alkalmazás hozzáférését az Entra ID-ben.
-
Konfigurációs módosítások: A megadott engedélykörök módosításra kerülnek, vagy az alkalmazás regisztrációja megváltozik.
További információt a „Microsoft-fiók engedélyezése a Webex alkalmazásban” című témakörben talál.
-
-
Prompt szö veg:
A promptszöveg a felhasználó által megadott természetes nyelvű bemenetre utalCisco AI Assistant, például egy projekt állapotá nak megkeresésére vagy egy dokumentum Microsoft-fiókjában történő keresésére irányuló kérésre. Ezt a szöveget a felhasználó generálja futásidőben.
Feldolgozási munkafolyamat
Amikor egy üzenetet küldünk, kövesse az Cisco AI Assistant alábbi lépéseket az információk lekéréséhez és bemutatásához:
-
Értelmezés és optimalizálás: Az asszisztens értel mezi a promptot, érvelést végez, és végrehajtja a lekérdezés átírását, hogy optimalizált lekérdezési karakterláncot hozzon létre.
-
API meghívása: Az asszisztens egy vagy több adatforrással hívja meg a Microsoft 365 Copilot Retrieval API-t.
-
Szűrés: Adott esetben a Kulcsszólekérdezési nyelv (KQL) szűrő kifejezések alkalmazásra kerülnek a visszakeresés bizonyos webhelyekre, dokumentumköny vtárakra, fájltípusokra vagy dátumtartományokra.
-
Átrangosítás és szintézis: Az asszisztens újra rang sorolja és kiszűri a visszaküldött szövegdarabokat. Ezután létrehoz egy végső választ, amely ötvözi az eredeti üzenetet a letöl tött tartalommal, beleértve a forrásdokumentumokhoz való hivatkozásokat is.
-
-
SharePoint- és OneDrive-tartalom: A SharePoint- és OneDrive-tartal mak engedélyezett Microsoft 365-adatok, amelyeket a Microsoft 365 Copilot Retrieval API-n keresztül lekérnek a felhasználói kérések megválaszolásához. A Visszakeresési API kivonja a releváns szövegdarabokat közvetlenül a Microsoft 365 hibrid tartalomindexéből anélkül, hogy másolná, exportálná vagy külön indexelné az adatokat.
Támogatott fájltípusok: .docx, .pptx, .pdf, .aspx és .one; nem szöveges tartalmak, például képek és diagramok nem támogatottak.
Az összes tartalom a Microsoft 365 megbízhatósági határán belül kerül letöltésre, és szigorúan csak azokra a fájlokra és dokumentumokra korlátozódik, amelyekhez a bejelentkezett felhasználó jogosult hozzáférni a Microsoft 365 engedélyezési modellje alapján.
-
Kér és: HTTPS POST kérelmet Cisco AI Assistant küld a https://graph.microsoft.com/v1.0/copilot/retrieval címre, amely a Microsoft Entra ID delegált hozzáférési tokenjét az Enjogosultság fejlécében hordozza. A kérelmező szerv a következőket tartalmazza:
-
QueryString (legfeljebb 1500 karakter) a felhasználó kéréséből származik, újraírt természetes nyelvi lekérdezés.
-
DataSource — SharePoint vagy OneDrive értékre állítható be (kérésenként egy-egy; minden forráshoz külön hívásokat kezdeményeznek).
-
FilterExpression (opcionális) — KQL kifejezés a webhely URL-címe, elérési útja, fájl típus vagy dátumtartomány szerint.
-
MaximumNumberofResults — hívásonként 25-re korlátozható.
-
-
Válas z: A Microsoft 365 a megbízhatósági határán belül dolgozza fel a kérést, és visszaadja a RetrieValHits tömböt, minden bejegyzés a következőket tartalmazza:
-
ContentChunk — kinyerett szövegrészlet a tartalomindexből
-
relevancescore — koszinusz hasonlósági pontszám a lekérdezés és a darab között, 0—1 tartományra normalizálva
-
erőforrás-forrás-metaadatok, beleértve a fájlnevet, az URL-t, a szerzőt és az utolsó módosítás dátumát
-
-
Adatkezelés: A teljes fájltartalom nem kerül átvitelre — csak a Microsoft 365 hibrid indexből előre kibon tott szövegdarabok kerülnek vissza. Cisco AI Assistantezeket a darabokat átmenetileg továbbítja az LLM-nek az újrangosítás, szűrés és válasz generálása céljából. A forrás metaadatait idézetek létrehozására használják a végső válaszban. A Webex nem tárolja a szövegdarabokat a kérés időtartamán túl.
-
-
A Copilot Connectors tartal ma: A Copilot Connectors tartalma harmadik féltől származó vagy egyéni vállalati adatok, amelyeket a Microsoft Gra ph csatlakozókon keresztül a Microsoft 365 tartalomindexbe kerülnek, és a Microsoft 365 Copilot Retrieval API-n keresztül visszakerezhetővé teszik. Az összes visszaküldött tartalom olyan elemekre korlátozódik, amelyekhez a bejelentkezett felhasználó jogosult hozzáférni a csatlakozó konfigurált engedél yei alapján a Microsoft 365-ben.
-
Kér és: HTTPS POST kérelmet Cisco AI Assistant küld a https://graph.microsoft.com/v1.0/copilot/retrieval címre, amely a Microsoft Entra ID delegált hozzáférési tokenjét az Enjogosultság fejlécében hordozza. A kérelmező szerv a következőket tartalmazza:
-
QueryString (legfeljebb 1500 karakter) a felhasználó kéréséből származik, újraírt természetes nyelvi lekérdezés.
-
Adatforrás — állítsa be a CopilotConnectors értékre.
-
FilterExpression (opcionális) — KQL kifejezés a hatókör lekéréséhez meghatározott csatlakozóforrásokhoz vagy tartalomtípusokhoz.
-
MaximumNumberofResults — hívásonként 25-re korlátozható.
-
-
Válasz: A Microsoft 365 a megbízhatósági határán belül feldolgozza a kérést, és egy RetrievalHits tömböt ad vissza, minden bejegyzés tartalmazza:
-
ContentChunk — kibontott szövegrészlet az indexelt harmadik féltől származó tartalomból.
relevancescore — koszinusz hasonlósági pontszám a lekérdezés és a darab között, 0—1 tartományra normalizálva. Ne feledje, hogy előfordulhat, hogy a relevancia-pontszám nem minden Copilot Connector eredménynél van jelen.
erőforrás-forrás-metaadatok, beleértve az elemnevet, az URL-t és a csatlakozó által definiált attribútumokat.
-
-
-
Adatkezelés: A teljes forráskódú tartalom nem kerül átvitelre — csak a Microsoft 365 tartalomindexből előre ki bontott szövegdarabok kerülnek vissza. Mivel a Visszakeresési API hívásonként egy adatforrást céloz meg, külön visszakeres Cisco AI Assistant ési hívásokat ad ki a SharePoint, a OneDrive és a Copilot Connectors számára, és egyesíti az eredményeket az újrarangsorolás során .
A szövegdarabokat átmenetileg továbbítja az LLM-nek az újrarangsorolás, szűrés és válasz generálása céljából, és a Webex nem tárolja őket a kérés időtartamán túl.
Hitelesítés és engedélyezés
A Webex kölcsönhatásba lép Microsoft-fiókjaival és tartalmaival a Microsoft Retrieval API segítségével, amelyet a Microsoft identitásszolgáltató (IDP) hitelesít és kezel. A Microsoft iDP-vel és a Retrieval API-val folytatott minden kommunikációt TLS-biztonságos kapcsolatok védik.
Webex szolgáltatás hitelesítése
Cisco AI AssistantA Webex App szabványos OAuth 2.0 folyamatokat használ a Webex szolgáltatásokkal való interakcióhoz:
-
Identitásszolgáltató: A Webex Identity Service felhőalapú IDP-ként működik a felhasználók hitelesítésére és az API-hozzáférés engedélyezésére.
-
Hordozói tokenek: A Webe x API-k iránti kérelmek a Webex Identity Service által kibocsátott hordozói tokenek felhasznál ásával engedélyezhetők.
-
Biztonságos kommunikáció: A WebexAI Assistant, a Webex Identity Service és a Webex API-k közötti összes adatcsere TLS-biztonságos kapcsolatokon keresztül történik.
Adminisztratív követelmények
Az integráció engedélyezéséhez a rendszergazdáknak a következő lépéseket kell végrehajtaniuk:
-
Microsoft 365 konfiguráció: A rendszer gazdáknak hozzá kell rendelniük a megfelelő Microsoft Copilot licenceket az érintett felhasználókhoz.
-
Webex konfiguráció: A rendszer gazdák közvetlenül a Vezérlőközpontban engedélyezhetik vagy letilthatják a szolgáltatást szervezet, felhasználó vagy sablon szintjén.
Felhasználó által jóváhagyott engedélyek
A telepítés során a következő engedélyeket kérjük:
| Engedély szükséges | Cél |
|---|---|
| Webex App Bejelentkezés és olvassa el a felhasználói profilt | Jelentkezzen be a Webex alkalmazásba fiókjával. |
| Engedélyezze és jelentkezzen be Microsoft-fiókjába | Ellenőrizze és engedélyezze a Webex App alkalmazást a Microsoft-fiókhoz való csatlakozáshoz. |
Ezeket az engedélyeket csak a telepítési folyamat során használják, és nem tárolják őket.
Szolgáltatási engedélyek
Nincs szükség külön szolgáltatási engedélyre. A rendszergazdák kezelhetik a funkciót és a beállításokat a Vezérlőközpontban az alábbi szakaszrészletekkel.
Copilot integrációs funkciókezelés és engedélyezés a Control Hubban
A rendszergazdák bekapcsolhatják vagy kikapcsolhatják a szervezetük funkcióját, vagy jelölőnégyzetekkel dönthetik el, hogy melyik vagy több forrást lehet biztosítani.
További információt az A I-integrációk beállítása a Vezérlőközpontban és a Keresési források be- és kik apcsolása a We Cisco AI Assistant bex alkalmazásban című témakörben talál.
Webex App beállításai és konfigurációi
A felhasználók bejelentkezhetnek a Webex alkalmazásba, és engedélyezhetik a Microsoft-fiók csatlakoztatását, miután a rendszergazda engedélyezéssel engedélyezte a funkciót a Control Hub használatá val
További információt a Microsoft-adatok elérése című témakörben talál: Cisco AI Assistant