- Hjem
- /
- Artikkel
Integrering med Microsoft Copilot gjør det mulig for Webex-møtebrukere å koble seg sikkert til Microsoft Copilot-kontoene sine som en av datakildene sine.
Sammendrag
Ved å utnytte Cisco AI Assistant Webex-appen kan brukere søke, analysere og oppsummere resultater fra Microsoft-datakilder, inkludert SharePoint, OneDrive og Copilot-tilkoblinger.
Arkitektur oversikt
Ved å koble til Microsoft Copilot kan du samhandle med Microsoft-datakilder ved hjelp av Microsoft Retrieval API-er. Når du brukerCisco AI Assistant, henter den data fra Microsoft-kildene dine i sanntid.
Webex lagrer eller beholder ikke dataene som returneres til deg viaCisco AI Assistant. Data brukes bare i øyeblikket for å generere svaret ditt, slik at personvernet ditt forblir beskyttet.
Detaljerte trinn for dataflyt
Brukeradministrasjon og tildeling
Administratorer kan administrere brukere som har Microsoft Copilot-lisenser og slå på eller av funksjonen for organisasjon-, bruker- eller malnivå ved hjelp av Control Hub.
Brukerautorisasjon og tilkobling
-
Brukeren logger på Webex-appen
-
Brukeren navigerer til Inn still inger-siden for å koble til Microsoft-kontoen sin.
Brukeren fullfører autorisasjonsprosessen og velger hvilke kilder (SharePoint, OneDrive eller Copilot Connector) som skal få tilgang til.
Arbeidsflyt for spørsmål og svar
Brukeren stiller et spørsmål, for eksempel: hva er statusen til prosjektet ABC?
Følgende trinn vil bli utført ved hjelp av flere undertrinn av Webex Meeting Service:
-
Dekry@@ ptere: systemet dekrypterer forespørselen.
-
Last inn kontekst: relevant kontekst lastes inn.
-
LLM-resonnement: LLM omskriver spørsmålet for optimal gjenfinning.
-
Hent integrasjonsinformasjon: systemet henter konfigurasjon og tokens for fler banesøk.
-
Flerbanesøk: systemet utfører henting på tvers av støttede Microsoft-verktøy.
-
Søk: verktøy for gjenfinning med flere veier søker detaljert innhold.
-
Ret@@ urner søkeresultat: verktøy for gjenfinning med flere baner returnerer søkeresultat.
-
-
Omrangering og filtrering: Webex-møtetjenesten bruker LLM til å omrangere og filtrere innhold for relevans.
-
Generasjon: LLM genererer et endelig svar med sitater.
-
Svar: legg inn endelig svar til Webex App.
Datahåndtering
Datahåndtering
Denne funksjonen bruker følgende data- og tjenestekonfigurasjonsinformasjon for å administrere autorisasjon, hente autorisert Microsoft 365-innhold og gi svar i Webex App:
-
Microsoft-applikasjonsregistrering:
Microsoft Application Registration representerer OAuth 2.0-klientkonfigurasjonen som er registrert i Microsoft Azure-portalen (Entra ID) for integrasjonen. Cisco AI Assistant
Denne registreringen definerer de spesifikke delegerte tillatelsene som kreves under autorisasjonsflyten for Microsoft-konto:
-
Read.All og Sites.Read.All: kreves for å få tilgang til SharePoint- og OneDrive-innhold.
-
ExternalItem.READ.ALL: kreves for å få tilgang til innhold fra Copilot Connectors.
Cisco AI Assistantbruker denne registreringen til å finne de riktige OAuth-innstillingene for på logging og tokenanskaffelse før du påkaller Microsoft 365 Copilot Retrieval API. Hvis du vil ha mer informasjon, kan du se «Registrer deg Cisco AI Assistant i Microsoft Azure.»
-
-
Microsoft OAuth-tokens:
Microsoft OAuth-tokens er kortvarige, delegerte tilgangstokener utstedt av Microsoft Entra ID når en bruker logger på Microsoft-kontoen sin via innstillingssiden for Webex App og gir de nødvendige tillatelsene.
Cisco AI Assistantbruker disse tokenene til å kalle Microsoft 365 Copilot Retrieval API på brukerens vegne. Microsoft Entra ID bruker disse tokenene til å autentisere hver forespørsel, identifisere brukeren og håndheve Microsoft 365-retningslinjer for tilgangskontroll og informasjonsbarriere, slik at bare innhold den påloggede brukeren har tilgang til returneres.
Fornyelse av token
På tidspunktet for den første autorisasjonen utsteder Microsoft Entra ID både et kortvarig tilgangstoken (gyldig i omtrent 60—90 minutter) og et oppdateringstoken med lang levetid. Webex lagrer oppdateringstokenet sikkert på serversiden, bundet til brukerens Webex-identitet.
Tilgangstokener fornyes ikke kontinuerlig. I stedet, når en bruker sender inn en forespørsel, kontrollerer Webex om gjeldende tilgangstoken fortsatt er gyldig. Hvis den er utløpt, bytter Webex lydløst oppdateringstokenet mot et nytt tilgangstoken. Gyl digheten til oppdateringstokenet forlenges hver gang den brukes, slik at økten kan forbli aktiv uten brukerinngrep så lenge funksjonen er i regelmessig bruk.
Oppsigelse av sesjon
Sesjonen avsluttes og re-autentisering kreves under følgende forhold:
-
Inaktivitet: Brukeren har ikke brukt funksjonen i en lengre periode (vanligvis 90 dager, avhengig av Microsoft Entra ID-standardpolicyen og kundens leietakerkonfigurasjon).
-
Manuell frakobling: Bru keren kobler eksplisitt fra Microsoft- kontoen sin fra Webex App-innstillingene.
-
Administrativ: En Microsoft 365-administrator tilbakekaller programmets tilgang i Entra ID.
-
Konfigurasjonsendringer: De tildelte tillatelsesområdene endres, eller applikasjonsregistreringen endres.
Hvis du vil ha mer informasjon, kan du se «Microsoft-kontoautorisasjon i Webex-appen.»
-
-
Ledetekst:
Ledetekst refererer til inndata på naturlig språk som er angitt av en bruker iCisco AI Assistant, for eksempel en forespørsel om å finne statusen til et prosjekt eller finne et dokument i Microsoft- kontoen. Denne teksten genereres av brukeren ved kjøretid.
Arbeidsflyt for behandling
Når en melding sendes inn, Cisco AI Assistant følger du disse trinnene for å hente og presentere informasjon:
-
Tolkning og optimalisering: Assistenten tolker ledeteksten, utfører resonnement og utfører omskriving av spørringer for å produsere en optimalisert spørringsstreng.
-
API-påkalling: Assistenten påkaller Microsoft 365 Copilot Retrieval API mot en eller flere datakilder.
-
Filtrering: Når det er aktuelt, brukes filter uttrykk for søkeordspørringsspråk (KQL) for å utvide hentingen til bestemte områder, dokument biblioteker, filtyper eller datoperioder.
-
Omrangering og syntese: Assistenten analyserer på nytt og filtrerer de returnerte tekstbitene. Det genererer deretter et endelig svar som kombinerer den opprinnelige ledeteksten med det hentede innholdet, inkludert sitater tilbake til kildedokumentene.
-
-
SharePoint- og OneDrive-innhold: SharePoint- og OneDrive-innhold er autorisert Microsoft 365-data hentet via Microsoft 365 Copilot Retrieval API for å svare på en brukerforespørsel. Retrieval API trekker ut relevante tekstbiter direkte fra Microsoft 365-hybridinnholdsindeksen uten å duplisere, eksportere eller indeksere data separat.
Støttede filtyper: .docx, .pptx, .pdf, .aspx og .one; ikke-tekstlig innhold som bilder og diagrammer støttes ikke.
Alt innhold hentes innenfor Microsoft 365-tillitsgrensen og er strengt begrenset til filer og dokumenter som den påloggede brukeren er autorisert til å få tilgang til under Microsoft 365s tillatelsesmodell.
-
Forespørsel: Cisco AI Assistant sender en HTTPS POST-forespørsel til https://graph.microsoft.com/v1.0/copilot/retrieval, med Microsoft Entra ID- delegert tilgangstoken i autorisasjonsoverskriften. Forespørselsorganet inneholder:
-
QueryString — omskrevet naturlig språkspørring avledet fra brukerens ledetekst (maks 1500 tegn).
-
Datakilde — Sett til SharePoint eller OneDrive (én per forespørsel; separate anrop blir foretatt for hver kilde).
-
FilterExpression (valgfritt) —KQL-uttrykk for å omfanget etter nettstedsnettadresse, bane, fil type, eller datoperiode.
-
MaximumNumberOfResults — begrenset til 25 per samtale.
-
-
Svar: Microsoft 365 behandler forespørselen innenfor tillitsgrensen og returnerer en RetrievalHits-array, med hver oppføring som inneholder:
-
ContentChunk — et uttrukket tekstutdrag fra innholdsindeksen
-
Relevanskjerne—cosinus likhetspoeng mellom spørringen og delen, normalisert til et 0—1-område
-
ressurs — kildemetadata inkludert filnavn, URL, forfatter og siste endringsdato
-
-
Datahåndtering: Ingen fullstendig filinnhold overføres — bare forhåndsutpakkede tekst biter fra Microsoft 365-hybridindeksen returneres. Cisco AI Assistantsender disse bitene forbigående til sin LLM for omvurdering, filtrering og svargenerering. Kildemetadata brukes til å konstruere sitater i det endelige svaret. Tekstbiter lagres ikke av Webex utover forespørslens varighet.
-
-
Innhold for Copilot Connectors: Innhold fra Copilot Connectors er tredjeparts- eller egendefinerte bedriftsdata som tas inn i Microsoft 365-innholdsindeksen via Microsoft Grap h-kontakter og gjøres tilgjengelig via Microsoft 365 Copilot Retrieval API. Alt returnert innhold er begrenset til elementer som den påloggede brukeren er autorisert til å få tilgang til under koblingens konfigur erte tillatelser i Microsoft 365.
-
Forespørsel: Cisco AI Assistant sender en HTTPS POST-forespørsel til https://graph.microsoft.com/v1.0/copilot/retrieval, med Microsoft Entra ID- delegert tilgangstoken i autorisasjonsoverskriften. Forespørselsorganet inneholder:
-
QueryString — omskrevet naturlig språkspørring avledet fra brukerens ledetekst (maks 1500 tegn).
-
Datakilde — sett til CoPilotConnectors.
-
FilterExpression (valgfritt) —KQL-uttrykk for innhenting av omfang til bestemte koblingskilder eller innh oldstyper.
-
MaximumNumberOfResults — begrenset til 25 per samtale.
-
-
Svar: Microsoft 365 behandler forespørselen innenfor tillitsgrensen og returnerer en RetrievalHits-array, hver oppføring inneholder:
-
ContentChunk — et uttrukket tekstutdrag fra det indekserte tredjepartsinnholdet.
Relevanskjerne—cosinus likhetspoeng mellom spørringen og delen, normalisert til et 0—1-område. Merk at relevanspoengsummen kanskje ikke er tilstede for alle Copilot Connector-resultater.
ressurs — kildemetadata, inkludert elementnavn, nettadresse og tilkoblingsdefinerte attributter.
-
-
-
Datahåndtering: Ingen fullstendig kildeinnhold overføres — bare forhåndsutpakkede tekst biter fra Microsoft 365-innholdsindeksen returneres. Siden API for henting er målrettet mot én datakilde per anrop, utsteder separate Cisco AI Assistant henteanrop for SharePoint-, OneDrive- og Copilot-tilkoblinger og slår sammen resultater under om vurderingstrinnet.
Tekstbiter sendes forbigående til LLM for omvurdering, filtrering og svar generering, og lagres ikke av Webex utover forespørslens varighet.
Autentisering og autorisasjon
Webex samhandler med Microsoft-kontoer og -innhold ved hjelp av Microsoft Retrieval API, som er autentisert og administrert av Microsofts identitetsleverandør (IdP). All kommunikasjon med Microsoft IdP og Retrieval API er beskyttet av TLS-sikrede tilkoblinger.
Webex-tjenestegodkjenning
Cisco AI Assistanti Webex App bruker standard OAuth 2.0-flyter for å samhandle med Webex-tjenester:
-
Identitetsleverandør: Webex Identity Service fungerer som den skybaserte IdP for å autentisere brukere og autorisere API-tilgang.
-
Bærertokens: Foresp ørsler til Webex API-er godkjennes ved hjelp av bærertokens utstedt av Webex Identity Service.
-
Sikker kommunikasjon: All datautveksling mellom WebexAI Assistant, Webex Identity Service og Webex API-er utføres over TLS-sikrede tilkoblinger.
Administrative krav
Administratorer må utføre følgende trinn for å aktivere denne integrasjonen:
-
Microsoft 365-konfigurasjon: Administratorer må tilordne de aktuelle Microsoft Copilot-lisensene til de aktuelle brukerne.
-
Webex-konfigurasjon: Administratorer kan aktivere eller deaktivere funksjonen på organisasjons-, bruker- eller malnivå direkte i Control Hub.
Brukergodkjente tillatelser
Under installasjonen blir følgende tillatelser bedt om:
| Tillatelse kreves | Formål |
|---|---|
| Webex App Logg på og les brukerprofil | Logg på Webex-appen med kontoen din. |
| Autorisere og logg inn på Microsoft-kontoen din | Valider og autoriser Webex-appen til å koble til Microsoft-kontoen din. |
Disse tillatelsene brukes bare under installasjonsprosessen og lagres ikke.
Tjenestetillatelser
Det er INGEN spesifikk servicetillatelse nødvendig. Administratorer kan administrere funksjonen og innstillingene i Control Hub med seksjonsdetaljer nedenfor.
Administrasjon og autorisasjon av Copilot-integrering i Control Hub
Administratorer kan slå på eller av funksjonen for organisasjonen, eller de kan bestemme hvilken eller flere kilder som kan tildeles med avmerkingsbokser.
Hvis du vil ha mer informasjon, kan du se Konfigurere AI-integrasjoner i Control Hub og Slå Cisco AI Assistant søkekilder på eller av i Webex-appen
Webex Appinnstillinger og konfigurasjoner
Brukere kan logge på Webex-appen og autorisere til å koble til Microsoft-kontoen etter at administratoren har slått på funksjonen med autorisasjon ved hjelp av Control Hub
Hvis du vil ha mer informasjon, kan du se Få tilgang til Microsoft-dataene dine med Cisco AI Assistant