- Hjem
- /
- Artikel
Integration med Microsoft Copilot giver Webex-mødebrugere mulighed for sikkert at oprette forbindelse til deres Microsoft Copilot-konti som en af deres datakilder.
Resumé
Ved at udnytte Cisco AI Assistant Webex App kan brugerne søge, analysere og opsummere resultater fra Microsoft-datakilder, herunder SharePoint, OneDrive og Copilot Connectors.
Arkitektur oversigt
Ved at oprette forbindelse til Microsoft Copilot kan du interagere med Microsoft-datakilder ved hjælp af Microsoft Retrieval API'er. Når du brugerCisco AI Assistant, henter den data fra dine Microsoft-kilder i realtid.
Webex gemmer eller opbevarer ikke de data, der returneres til dig viaCisco AI Assistant. Data bruges kun i øjeblikket til at generere dit svar, hvilket sikrer, at dit privatliv forbliver beskyttet.
Detaljerede dataflowtrin
Brugeradministration og tildeling
Administratorer kan administrere brugere, der har Microsoft Copilot-licenser, og slå funktionen til eller fra på org-, bruger- eller skabelonniveau ved hjælp af Control Hub.
Brugertilladelse og forbindelse
-
Brugeren logger ind på Webex App
-
Brugeren navigerer til siden Inds tillinger for at forbinde sin Microsoft-konto.
Brugeren gennemfører godkendelsesprocessen og vælger, hvilke kilder (SharePoint, OneDrive eller Copilot Connector) der skal åbnes.
Arbejdsgang med spørgsmål og svar
Brugeren stiller et spørgsmål, for eksempel: Hvad er status for projekt ABC?
Følgende trin udføres ved hjælp af flere undertrin af Webex Meeting Service:
-
Dekry@@ ptere: systemet dekrypterer anmodningen.
-
Indlæs kontekst: relevant kontekst indlæses.
-
LLM-begrundelse: LLM omskriver spørgsmålet for optimal hentning.
-
Hent integrationsoplysninger: systemet henter konfiguration og tokens til søgning med flere stier.
-
Søgning med flere stier: systemet udfører hentning på tværs af understøttede Microsoft-værktøjer.
-
Søg: værktøjer til hentning af flere stier søger detaljeret indhold.
-
Returner søgeresultat: værktøjer til hentning af flere stier returnerer søgeresultat.
-
-
Omrangering og filtrering: Webex-mødetjenesten bruger LLM til at omrangere og filtrere indhold efter relevans.
-
Generation: LLM genererer et endeligt svar med citater.
-
Svar: send det endelige svar til Webex App.
Datahåndtering
Datahåndtering
Denne funktion bruger følgende data- og servicekonfigurationsoplysninger til at administrere godkendelse, hente autoriseret Microsoft 365-indhold og give svar i Webex App:
-
Registrering af Microsoft-applikationer:
Microsoft Application Registration repræsenterer den OAuth 2.0-klientkonfiguration, der er registreret i Microsoft Azure-portalen (Entra ID) til integrationen. Cisco AI Assistant
Denne registrering definerer de specifikke delegerede tilladelser, der kræves under godkendelses flowet til Microsoft-konto:
-
Read.All og Sites.Read.All: kræves for at få adgang til SharePoint- og OneDrive-indhold.
-
ExternalItem.READ.ALL: kræves for at få adgang til indholdet af Copilot Connectors.
Cisco AI Assistantbruger denne registrering til at finde de korrekte OAuth-indstillinger for login og tokenerhvervelse, før du påkalder Microsoft 365 Copilot Retrieval API. Du kan finde flere oplysninger i „Registrer Cisco AI Assistant i Microsoft Azure.“
-
-
Microsoft OAuth-tokens:
Microsoft OAuth-tokens er kortvarige, delegerede adgangstokener, der udstedes af Microsoft Entra ID, når en bruger logger på sin Microsoft-konto via indstillingssiden Webex App og giver de nødvendige tilladelser.
Cisco AI Assistantbruger disse tokens til at kalde Microsoft 365 Copilot Retrieval API på brugerens vegne. Microsoft Entra ID bruger disse tokens til at godkende hver anmodning, identificere brugeren og håndhæve Microsoft 365-adgangskontrol- og informationsbarrierepolitikker, hvilket sikrer, at kun indhold, som den loggede bruger har tilladelse til at få adgang til, returneres.
Fornyelse af token
På tidspunktet for den første godkendelse udsteder Microsoft Entra ID både et kort varigt adgangstoken (gyldigt i ca. 60-90 minutter) og et opdateringstoken med lang levetid. Webex gemmer opdateringstokenet sikkert på serversiden, bundet til brugerens Webex-identitet.
Adgangstokener fornyes ikke kontinuerligt. Når en bruger sender en anmodning, kontrollerer Webex i stedet, om det aktuelle adgangstoken stadig er gyldigt. Hvis det er udløbet, udveksler Webex lydløst opdateringstokenet med et nyt adgangstoken. Opdateringstokens gyldighed forlænges hver gang det bruges, så sessionen kan forblive aktiv uden brugerindgriben, så længe funktionen er i regelmæssig brug.
Sessionsafslutning
Sessionen afsluttes, og gengodkendelse kræves under følgende betingelser:
-
Inaktivitet: Brugeren har ikke brugt funktionen i en længere periode (typisk 90 dage, afhængigt af Microsoft Entra ID-standardpolitikken og kundens lejerkonfiguration).
-
Manuel frakobling: Brugeren afbryder eksplicit sin Microsoft- konto fra indstillingerne for Webex-appen.
-
Administrativ: En Microsoft 365-administrator tilbagekalder programmets adgang i Entra ID.
-
Konfigurationsændringer: De tildelte tilladelsesområder ændres, eller programregistreringen ændres.
Du kan finde flere oplysninger under „Godkendelse af Microsoft-konto i Webex-appen.“
-
-
Hurtig tekst:
Prompttekst henviser til det naturlige sprogindtastning, som en bruger har indtastet iCisco AI Assistant, f.eks. en anmodning om at finde status for et projekt eller finde et dokument på deres Microsoft-konto. Denne tekst genereres af brugeren ved kørsel.
Arbejdsgang til behandling
Når der sendes en prompt, skal du Cisco AI Assistant følge disse trin for at hente og præsentere oplysninger:
-
Fortolkning og optimering: Assistenten fortolker prompten, udfører ræsonnement og udfører omskrivning af forespørgsel for at producere en optimeret forespørgselsstreng.
-
API-indkaldelse: Assistenten påkalder Microsoft 365 Copilot Retrieval API mod en eller flere datakilder.
-
Filtrering: Hvor det er relevant, anvendes KQL-filter udtryk (Keyword Query Language) for at udvide hentningen til bestemte websteder, dokument biblioteker, filtyper eller datointervaller.
-
Reranking og syntese: Assistenten genanalyserer og filtrerer de returnerede tekststykker. Det genererer derefter et endeligt svar, der kombinerer den originale prompt med det hentede indhold, inklusive citater tilbage til kildedokumenterne.
-
-
SharePoint- og OneDrive-indhold: SharePoint- og OneDrive-indhold er autoriserede Microsoft 365-data hentet via Microsoft 365 Copilot Retrieval API til at besvare en brugeranmodning. Retrieval API udtrækker relevante tekststykker direkte fra Microsoft 365-hybridindholdsindekset uden at duplikere, eksportere eller indeksere data separat.
Understøttede filtyper: .docx, .pptx, .pdf, .aspx og.one; ikke-tekstligt indhold som billeder og diagrammer understøttes ikke.
Alt indhold hentes inden for Microsoft 365-tillidsgrænsen og er strengt begrænset til filer og dokumenter, som den loggede bruger er autoriseret til at få adgang til under Microsoft 365's tilladelsesmodel.
-
Anmod ning: Cisco AI Assistant sender en HTTPS POST-anmodning til https://graph.microsoft.com/v1.0/copilot/retrieval, der bærer det Microsoft Entra ID- delegerede adgangstoken i autorisationsoverskriften. Anmodningsorganet indeholder:
-
QueryString — den omskrevne forespørgsel på naturligt sprog, der stammer fra brugerens prompt (maks. 1.500 tegn).
-
Datakilde — Indstil til SharePoint eller OneDrive (en pr. Anmodning; der foretages separate opkald for hver kilde).
-
FilterExpression (valgfrit) —KQL-udtryk til omfang efter webstedets URL, sti, fil type eller datointerval.
-
MaximumNumberOfResults — begrænset til 25 pr. opkald.
-
-
Svar: Microsoft 365 behandler anmodningen inden for dens tillidsgræn se og returnerer et RetrievalHits-array, hvor hver post indeholder:
-
ContentChunk — et udtrukket tekststykke fra indholdsindekset
-
RelevansCore—cosinus-lighedsscore mellem forespørgslen og klumpen, normaliseret til et interval på 0—1
-
ressource — kildemetadata, herunder filnavn, URL, forfatter og dato for sidst ændret
-
-
Datahåndtering: Der overføres intet fuldstændigt filindhold — kun forudpakkede tekststykker fra Microsoft 36 5-hybridindekset returneres. Cisco AI Assistantsender disse bidder forbigående til sin LLM til omlægning, filtrering og svargenerering. Kildemetadata bruges til at konstruere citater i det endelige svar. Tekststykker gemmes ikke af Webex ud over anmodningens varighed.
-
-
Indhold af Copilot Connectors: Indholdet af Copilot Connectors er tredjepartsdata eller brugerdefinerede virksomhedsdata, der indtages i Microsoft 365-indholdsindekset via Microsoft Grap h-forbindelser og gøres tilgængelige via Microsoft 365 Copilot Retrieval API. Alt returneret indhold er begrænset til elementer, som den loggede bruger er autoriseret til at få adgang til under forbindelsens konfigur erede tilladelser i Microsoft 365.
-
Anmod ning: Cisco AI Assistant sender en HTTPS POST-anmodning til https://graph.microsoft.com/v1.0/copilot/retrieval, der bærer det Microsoft Entra ID- delegerede adgangstoken i autorisationsoverskriften. Anmodningsorganet indeholder:
-
QueryString — den omskrevne forespørgsel på naturligt sprog, der stammer fra brugerens prompt (maks. 1.500 tegn).
-
Datakilde — indstillet til CoPilotConnectors.
-
FilterExpression (valgfrit) —KQL-udtryk til hentning af omfang til bestemte forbindelseskilder eller ind holdstyper.
-
MaximumNumberOfResults — begrænset til 25 pr. opkald.
-
-
Svar: Microsoft 365 behandler anmodningen inden for dens tillidsgrænse og returnerer et RetrievalHits-array, hvor hver post indeholder:
-
ContentChunk — et udtrukket tekststykke fra det indekserede tredjepartsindhold.
RelevansCore—cosinus-lighedsscore mellem forespørgslen og klumpen, normaliseret til et interval på 0—1. Bemærk, at relevansscore muligvis ikke er til stede for alle Copilot Connector-resultater.
ressource — kildemetadata, herunder elementnavn, URL og forbindelsesdefinerede attributter.
-
-
-
Datahåndtering: Der overføres intet fuldt kildeindhold — kun forudpakkede tekststykker fra Microsoft 365- indholdsindekset returneres. Da API'en for hentning er målrettet mod én datakilde pr. opkald, ud Cisco AI Assistant steder separate hentningskald til SharePoint-, OneDrive- og Copilot-forbindelser og sammenføjer resultaterne under gen vurderingstrinnet.
Tekstklumper sendes forbigående til LLM til omlægning, filtrering og generering af svar og gemmes ikke af Webex ud over anmodningens varighed.
Autentificering og godkendelse
Webex interagerer med dine Microsoft-konti og indhold ved hjælp af Microsoft Retrieval API, som godkendes og administreres af Microsoft-identitetsudbyderen (IdP). Al kommunikation med Microsoft IdP og Retrieval API er beskyttet af TLS-sikrede forbindelser.
Webex-tjenestegodkendelse
Cisco AI Assistanti Webex App bruger standard OAuth 2.0-flows til at interagere med Webex-tjenester:
-
Identitetsudbyder: Webex Identity Service fungerer som den skybaserede IdP til at godkende brugere og godkende API-adgang.
-
Bærertokens: Anmod ninger til Webex API'er godkendes ved hjælp af bærertokens udstedt af Webex Identity Service.
-
Sikker kommunikation: Al dataudveksling mellem WebexAI Assistant, Webex Identity Service og Webex API'er udføres via TLS-sikrede forbindelser.
Administrative krav
Administratorer skal udføre følgende trin for at aktivere denne integration:
-
Microsoft 365-konfiguration: Administratorer skal tildele de relevante Microsoft Copilot-licenser til de relevante brugere.
-
Webex-konfiguration: Administratorer kan aktivere eller deaktivere funktionen på organisations-, bruger- eller skabelonniveau direkte i Control Hub.
Brugergodkendte tilladelser
Under opsætningen anmodes om følgende tilladelser:
| Tilladelse påkrævet | Formål |
|---|---|
| Webex App Log ind og læs brugerprofil | Log ind på Webex-appen med din konto. |
| Godkend og log ind på din Microsoft-konto | Valider og godkend Webex-appen til at oprette forbindelse til din Microsoft-konto. |
Disse tilladelser bruges kun under installationsprocessen og gemmes ikke.
Servicetilladelser
Der er ingen specifik servicetilladelse nødvendig. Administratorer kan administrere funktionen og indstillingerne i Control Hub med nedenstående sektionsdetaljer.
Administration og godkendelse af Copilot-integrationsfunktioner i Control Hub
Administratorer kan slå funktionen til eller fra for deres organisation, eller de kan beslutte, hvilken eller flere kilder der kan tildeles med afkrydsningsfelter.
Du kan finde flere oplysninger under Konfigurere AI-integrationer i Control Hub og Slå Cisco AI Assistant søgekilder til eller fra i We be x-appen
Webex App-indstillinger og -konfigurationer
Brugere kan logge ind på Webex-appen og autorisere til at forbinde Microsoft-kontoen, når administratoren har aktiveret funktionen med autor isation ved hjælp af Control Hub
Du kan finde flere oplysninger i Få adgang til dine Microsoft-data med Cisco AI Assistant