- Početak
- /
- Članak
Integracija s programom Microsoft Copilot omogućuje korisnicima sastanka Webexa da se sigurno povežu sa svojim Microsoft Copilot računima kao jednim od njihovih izvora podataka.
Sažetak
Korištenjem aplikacije Cisco AI Assistant Webex korisnici mogu pretraživati, analizirati i sažeti rezultate iz Microsoftovih izvora podataka, uključujući SharePoint, OneDrive i Copilot Connectors.
Pregled arhitekture
Povezivanje s Microsoft Copilotom omogućuje vam interakciju s Microsoftovim izvorima podataka pomoću Microsoftovih API-ja za pronalaženje. Kada koristiteCisco AI Assistant, on preuzima podatke iz vaših Microsoftovih izvora u stvarnom vremenu.
Webex ne pohranjuje niti zadržava podatke koji su vam vraćeni putem. Cisco AI Assistant Podaci se koriste samo u ovom trenutku za generiranje vašeg odgovora, osiguravajući da vaša privatnost ostane zaštićena.
Detaljni koraci protoka podataka
Upravljanje korisnicima i dodjeljivanje
Administratori mogu upravljati korisnicima koji imaju licence Microsoft Copilot te uključivati ili isključiti značajku za organizaciju, korisnik ili razinu predloška pomoću Control Hub.
Autorizacija korisnika i povezivanje
-
Korisnik se prijavljuje u Webex App
-
Korisnik se kreće na stranicu Postavke kako bi povezao svoj Microsoftov račun.
Korisnik dovršava postupak autorizacije i odabire izvorima (SharePoint, OneDrive ili Copilot Connector) kojima će pristupiti.
Tijek pitanja i odgovora
Korisnik postavlja pitanje, na primjer: kakav je status projekta ABC?
Sljedeći koraci izvršit će se pomoću više podkoraka od strane Webex Meeting Service:
-
Dešifriranje: sustav dešifrira zahtjev.
-
Učitaj kontekst: učitava se relevantni kontekst.
-
LLM Obrazloženje: LLM prepisuje pitanje radi optimalnog pronalaženja.
-
Dobijte informacije o integraciji: sustav preuzima konfiguraciju i tokene za pretraživanje na više puta.
-
Pretraživanje na više puta: sustav izvršava pronalaženje putem podržanih Microsoftovih alata.
-
Pretraživanje: alati za pronalaženje više putanja pretražuju detaljan sadržaj.
-
Vrati rezultat pretraživanja: alati za pronalaženje više puta vraćaju rezultat pretraživanja.
-
-
Ponovno rangiranje i filtriranje: Webex usluga sastanaka koristi LLM za ponovno rangiranje i filtriranje sadržaja radi relevantnosti.
-
Generacija: LLM generira konačni odgovor s citatima.
-
Odgovor: objavite konačni odgovor na Webex App.
Rukovanje podacima
Rukovanje podacima
Ova značajka koristi sljedeće podatke i informacije o konfiguraciji usluge za upravljanje autorizacijom, dohvaćanje ovlaštenog sadržaja za Microsoft 365 i davanje odgovora u aplikaciji Webex:
-
Registracija Microsoftove aplikacije:
Registracija Microsoftovih aplikacija predstavlja konfiguraciju klijenta OAuth 2.0 registriranu na portalu Microsoft Azure (Entra ID) za integraciju Cisco AI Assistant .
Ova registracija definira specifična delegirana dopuštenja potrebna tijekom protoka autorizacije Microsoftovog računa:
-
Read.All i Sites.Read.All: potrebno za pristup sadržaju SharePoint i OneDrive.
-
ExternalItem.read.all: potrebno za pristup sadržaju Copilot Connectors.
Cisco AI Assistantkoristi ovu registraciju za pronalaženje ispravnih OAuth postavki za prijavu i prikupljanje tokena prije poziva na Microsoft 365 Copilot Retrieval API. Dodatne informacije potražite u odjeljku "Registr Cisco AI Assistant acija u programu Microsoft Azure".
-
-
Microsoftovi OAuth tokeni:
Microsoft OAuth tokeni su kratkotrajni, delegirani pristupni tokeni koje izdaje Microsoft Entra ID nakon što se korisnik prijavi na svoj Microsoftov račun putem stranice postavki aplikacije Webex i odobri potrebna dopušten ja.
Cisco AI Assistantkoristi ove tokene za pozivanje Microsoft 365 Copilot Retrieval API-ja u ime korisnika . Microsoft Entra ID koristi ove tokene za provjeru autentičnosti svakog zahtjeva, identificiranje korisnika i provođenje pravila kontrole pristupa i informacionih barijera sustava Microsoft 365, osiguravajući da se vraća samo sadržaj kojem je prijavljenom korisniku dopušteno pristupiti.
Obnova tokena
U vrijeme početne autorizacije, Microsoft Entra ID izdaje i kratkotrajni pristupni token (vrijedi otprilike 60—90 minuta) i dugotrajni token za osvježavanje. Webex sigurno pohranjuje token osvježavanja na strani poslužitelja, vezan za korisnikov Webex identitet.
Pristupni tokeni se ne obnavljaju kontinuirano. Umjesto toga, kada korisnik pošalje zahtjev, Webexprovjerava je li trenutni pristupni token još uvijek valjan. Ako je istekao, Webextiho zamjenjuje token za osvježavanje za novi pristupni token. Val janost tokena za osvježavanje produžava se svaki put kada se koristi, omogućavajući sesiji da ostane aktivna bez intervencije korisnika sve dok se značajka redovito koristi.
Prekid sjednice
Sesija se prekida i potrebna je ponovna provjera autentičnosti pod sljedećim uvjetima:
-
Neaktivnost: Korisnik nije koristio značajku dulje razdoblje (obično 90 dana, ovisno o zadanim pravilima Microsoft Entra ID-a i konfiguraciji kupca stanara).
-
Ručno isključivanje: Koris nik izričito isključuje svoj Microsoftov račun iz postavki aplikacije Webex.
-
Administrativni: Microsoft 365 administrator opoziva pristup aplikaciji u Entra ID-u.
-
Promjene konfiguracije: Odobreni opsezi dopuštenja se mijenjaju ili se mijenja registracija aplikacije.
Dodatne informacije potražite u odjeljku "Autorizacija Microsoftovog računa u aplikaciji Webex".
-
-
Brzi tekst:
Brzi tekst odnosi se na unos prirodnog jezika koji je korisnik unio unutar njegaCisco AI Assistant, kao što je zahtjev za pronalaženjem statusa projekta ili pronalaženjem dokumenta unutar svog Microsoftovog računa. Ovaj tekst generira korisnik tijekom izvođenja.
Obrada tijeka rada
Kada se pošalje upit, Cisco AI Assistant slijedite ove korake kako biste preuzeli i predstavili informacije:
-
Tumačenje i optimizacija: Pomoćnik tumači upit, vrši zaključivanje i izvršava prepisivanje upita kako bi proizveo optimizirani niz upita.
-
Poziv API-ja: Pomoćnik poziva Microsoft 365 Copilot Retrieval API protiv jednog ili više izvora podataka.
-
Filtriranje: Gdje je primjenjivo, izrazi filtra za jezik upita ključnih riječi (KQL) primjenjuju se za opseg preuzimanja na određene web-lokacije, biblioteke dokumenata, tipove datoteka ili datumske raspone.
-
Ponovno rangiranje i sinteza: Pomo ćnik ponovno rangira i filtrira vraćene dijelove teksta. Zatim generira konačni odgovor koji kombinira izvorni upit s preuzetim sadržajem, uključujući citate natrag u izvorne dokumente.
-
-
Sadržaj SharePoint i OneDrive: Sadrž aj SharePoint i OneDrive ovlašteni su podaci Microsoft 365 koji se preuzimaju putem API-ja za preuzimanje programa Microsoft 365 Copilot za odgovore na zahtjev korisnika. API za pronalaženje izvlači relevantne dijelove teksta izravno iz indeksa hibridnog sadržaja Microsoft 365 bez dupliciranja, izvoza ili zasebnog indeksiranja podataka.
Podržane vrste datoteka: .docx, .pptx, .pdf, .aspx i.one; netekstualni sadržaj poput slika i grafikona nije podržan.
Sav sadržaj preuzima se unutar granice povjerenja za Microsoft 365 i strogo je ograničen na datoteke i dokumente kojima je prijavljeni korisnik ovlašteno pristupiti prema modelu dozvola Microsoft 365.
-
Zahtjev: Cisco AI Assistant šalje HTTPS POST zahtjev na adresu https://graph.microsoft.com/v1.0/copilot/retrieval, noseći token delegiranog pristupa Microsoft Entra ID u zaglavlju Autorizacija. Tijelo zahtjeva sadrži:
-
QueryString — prepisani upit prirodnog jezika izveden iz upita korisnika (maksimalno 1.500 znakova).
-
DataSource — postavite na SharePoint ili OneDrive (jedan po zahtjevu; za svaki izvor upućuju se zasebni pozivi).
-
FilterExpression (opcionalno) —KQL izraz za opseg prema URL-u web mjesta, putanji, vrsti datoteke ili rasponu datuma.
-
MaximumNumberOfResults-ograničeno na 25 po pozivu.
-
-
Odgovor: Microsoft 365 obrađuje zahtjev unutar svoje granice povjerenja i vraća niz RetrievalHits, pri čemu svaki unos sadrži:
-
ContentChunk — izdvojeni isječak teksta iz indeksa sadržaja
-
RelevancijaOcjena sličnosti jezgra i kosinusa između upita i komada, normalizirana na raspon 0—1
-
resurs—izvorni metapodaci uključujući naziv datoteke, URL, autora i datum posljednje izmjene
-
-
Rukovanje podacima: ne prenosi se cijeli sadržaj datoteke — vraćaju se samo unaprijed izvučeni dijelovi teksta iz hibridnog indeksa Microsoft 365. Cisco AI Assistantprolazno prenosi ove dijelove svom LLM-u radi ponovnog rangiranja, filtriranja i generiranja odgovora. Izvorni metapodaci koriste se za konstruiranje citata u konačnom odgovoru. Webex ne pohranjuje dijelove teksta nakon trajanja zahtjeva.
-
-
Sadržaj Copilot Connectors: Sadrž aj Copilot Connectors su podaci treće strane ili prilagođeni podaci o poduzeću uneseni u Microsoft 365 indeks sadržaja putem konektora Microsoft Graph i koji se mogu preuzeti putem API-ja za pronalaženje Microsoft 365 Copilot. Sav vraćeni sadržaj ograničen je na stavke kojima je prijavljeni korisnik ovlašteno pristupiti pod konfiguriranim dopušten jima konektora u sustavu Microsoft 365.
-
Zahtjev: Cisco AI Assistant šalje HTTPS POST zahtjev na adresu https://graph.microsoft.com/v1.0/copilot/retrieval, noseći token delegiranog pristupa Microsoft Entra ID u zaglavlju Autorizacija. Tijelo zahtjeva sadrži:
-
QueryString — prepisani upit prirodnog jezika izveden iz upita korisnika (maksimalno 1.500 znakova).
-
Izvor podataka - postavljen na CopilotConnectors.
-
FilterExpression (opcionalno) —KQL izraz za dohvaćanje opsega u određene izvore konektora ili vrste sadržaja.
-
MaximumNumberOfResults-ograničeno na 25 po pozivu.
-
-
Odgovor: Microsoft 365 obrađuje zahtjev unutar svoje granice povjerenja i vraća niz RetrievalHits, svaki unos sadrži:
-
ContentChunk — izdvojeni isječak teksta iz indeksiranog sadržaja treće strane.
Ocjena sličnosti relevantnosti jezgra i kosinusa između upita i komada, normaliziran na raspon 0—1. Imajte na umu da ocjena relevantnosti možda neće biti prisutna za sve rezultate Copilot Connector.
resurs—izvorni metapodaci uključujući naziv stavke, URL i atribute definirane konektorom.
-
-
-
Rukovanje podacima: ne prenosi se cijeli izvorni sadržaj — vraćaju se samo unaprijed izvučeni dijelovi teksta iz indeksa sadržaja Microsoft 365. Budući da API za pronalaženje cilja jedan izvor podataka po pozivu, Cisco AI Assistant izdaje zasebne pozive za preuzimanje za SharePoint, OneDrive i Copilot Connectors i spaja rezultate tijekom koraka ponovnog rangiranja .
Komadići teksta prolazno se prosljeđuju LLM-u radi ponovnog rangiranja, filtriranja i generiranja odgovora, a Webex ih ne pohranjuje nakon trajanja zahtjeva.
Autentifikacija i autorizacija
Webex komunicira s vašim Microsoftovim računima i sadržajem pomoću Microsoftovog API-ja za pronalaženje autentičnosti i kojim upravlja pružatelj Microsoftovih identiteta (iDP). Sva komunikacija s Microsoft IDP-om i API-jem za pronalaženje zaštićena je TLS-zaštićenim vezama.
Provjera autentičnosti usluge Webex
Cisco AI Assistantu Webex App koristi standardne protoke OAuth 2.0 za interakciju s Webex uslugama:
-
P@@ ružatelj identiteta: Webex usluga identiteta djeluje kao IDP temeljen na oblaku za provjeru autentičnosti korisnika i autorizaciju pristupa API-ju.
-
Tokeni nositelja: Zaht jevi za Webex API-je odobravaju se pomoću tokena donositelja koje izdaje Webex Identi ty Service.
-
Sigurna komunikacija: Sva razmjena podataka između WebexaAI Assistant, Webex Identity Service i Webex API-ja provodi se preko TLS-zaštićenih veza.
Administrativni zahtjevi
Da bi omogućili ovu integraciju, administratori moraju izvršiti sljedeće korake:
-
Konfiguracija Microsoft 365: Administratori moraju dodijeliti odgovarajuće licence za Microsoft Copilot relevantnim korisnicima.
-
Webex konfiguracija: Administratori mogu omogućiti ili onemogućiti značajku na razini organizacije, korisnika ili predloška izravno unutar Control Hub.
Dozvole s pristankom korisnika
Tijekom postavljanja traže se sljedeća dopuštenja:
| Potrebna dozvola | Svrha |
|---|---|
| Webex App Prijavite se i pročitajte korisnički profil | Prijavite se na Webex App sa svojim računom. |
| Autorizacija i prijavljivanje na svoj Microsoftov račun | Potvrdite i ovlastite aplikaciju Webex za povezivanje s vašim Microsoftovim računom. |
Ta se dopuštenja koriste samo tijekom postupka postavljanja i ne pohranjuju se.
Dozvole za usluge
Nije potrebna posebna dozvola za uslugu. Administratori mogu upravljati značajkom i postavkama u Control Hubu s detaljima odjeljka ispod.
Upravljanje značajkama integracije Copilot i autorizacija u Control Hubu
Administratori mogu uključiti ili isključiti značajku za svoju organizaciju ili mogu odlučiti koji se jedan ili više izvora može odobriti pomoću potvrdnih okvira.
Dodatne informacije potražite u odjelj ku Postavljanje integracija umjetne inteligencije u Control Hub i Uključi vanje ili isključivanje izvora Cisco AI Assistant pretraživanja u aplikaciji Webex
Postavke i konfiguracije aplikacije Webex
Korisnici se mogu prijaviti u Webex App i ovlastiti povezivanje Microsoftovog računa nakon što administrator uključi značajku s autorizacijom pomoću Control Hub
Dodatne informacije potražite u odjelj ku Pristup Microsoftovim podacima pomoću Cisco AI Assistant