I den här artikeln
Sammanfattning
Arkitekturöversikt
Datahantering
dropdown icon
Autentisering och auktorisering
    Användarsamtyckta behörigheter
    Tjänstbehörigheter
Funktionshantering och auktorisering av Copilot-integrering i Control Hub
Inställningar och konfigurationer för Webex App
Ytterligare referensmaterial
Tillåt AI Assistant att söka i externa Microsoft-datakällor
list-menuI den här artikeln
list-menuHar du feedback?

Integrering med Microsoft Copilot gör det möjligt för Webex-mötesanvändare att säkert ansluta till sina Microsoft Copilot-konton som en av deras datakällor.

Sammanfattning

Genom att utnyttja Cisco AI Assistant Webex App kan användare söka, analysera och sammanfatta resultat från Microsoft-datakällor, inklusive SharePoint, OneDrive och Copilot Connectors.

Arkitekturöversikt

Genom att ansluta till Microsoft Copilot kan du interagera med Microsoft-datakällor med hjälp av Microsoft Retrieval API: er. När du använderCisco AI Assistant, hämtar den data från dina Microsoft-källor i realtid.

Webex lagrar eller behåller inte de data som returneras till dig viaCisco AI Assistant. Data används endast för tillfället för att generera ditt svar, vilket säkerställer att din integritet förblir skyddad.

Architecture overview for how Webex AI Assistant uses Microsoft data

Detaljerade steg för dataflöde

Användarhantering och tilldelning

Administratörer kan hantera användare som har Microsoft Copilot-licenser och aktivera eller inaktivera funktionen för org-, användare- eller mallnivå med Control Hub.

Användarbehörighet och anslutning

  1. Användaren loggar in på Webex App

  2. Användaren navigerar till sidan In ställningar för att ansluta sitt Microsoft-konto.

Användaren slutför auktoriseringsprocessen och väljer vilka källor (SharePoint, OneDrive eller Copilot Connector) som ska komma åt.

Arbetsflöde för frågor och svar

Användaren ställer en fråga, till exempel: vad är status för projektet ABC?

Följande steg kommer att utföras med hjälp av flera understeg av Webex Meeting Service:

  1. Dekry@@ ptera: systemet dekrypterar begäran.

  2. Ladda kontext: relevant kontext laddas.

  3. LLM-resonemang: LLM skriver om frågan för optimal hämtning.

  4. Hämta integrationsinformation: systemet hämtar konfiguration och tokens för sökning med flera sökvägar.

  5. Sök med flera sökvägar: systemet kör hämtning över Microsoft-verktyg som stöds.

    • Sök: verktyg för hämtning med flera vägar söker detaljerat innehåll.

    • Ret@@ urnera sökresultat: verktyg för hämtning med flera sökvägar returnerar sökresultat.

  6. Omrankning och filtrering: Webex-mötestjänsten använder LLM för att omrangera och filtrera innehåll för relevans.

  7. Generering: LLM genererar ett slutligt svar med citat.

  8. Svar: skicka slutligt svar till Webex App.

Datahantering

Datahantering

Den här funktionen använder följande data- och tjänstkonfigurationsinformation för att hantera auktorisering, hämta auktoriserat Microsoft 365-innehåll och ge svar i Webex-appen:

  • Registrering av Microsoft-program:

    Microsoft Application Registration representerar OAuth 2.0-klientkonfigurationen som registrerats i Microsoft Azure-portalen (Entra ID) för integrationen. Cisco AI Assistant

    Den här registreringen definierar de specifika delegerade behörigheter som krävs under auktoriseringsflödet för Microsoft-konto:

    • Read.All och Sites.Read.All: krävs för att komma åt SharePoint- och OneDrive-innehåll.

    • ExternalItem.READ.ALL: krävs för att komma åt innehållet i Copilot Connectors.

    Cisco AI Assistantanvänder den här registreringen för att hitta rätt OAuth-inställningar för inloggning och tokenförvärv innan du anropar Microsoft 365 Copilot Retrieval API. Mer information finns i ”Registrera Cisco AI Assistant i Microsoft Azure”.

  • Microsoft OAuth-tokens:

    Microsoft OAuth-tokens är kortlivade, delegerade åtkomsttoken som utfärdas av Microsoft Entra ID när en användare loggar in på sitt Microsoft-konto via inställningssidan för Webex App och beviljar nödvändiga behörigheter.

    Cisco AI Assistantanvänder dessa tokens för att anropa Microsoft 365 Copilot Retrieval API å användarens vägnar. Microsoft Entra ID använder dessa tokens för att autentisera varje begäran, identifiera användaren och genomdriva Microsoft 365-åtkomstkontroll och informationsbarriärpolicyer, vilket säkerställer att endast innehåll som den inloggade användaren får åtkomst till returneras.

    Token förnyelse

    Vid tidpunkten för den första auktoriseringen utfärdar Microsoft Entra ID både en kortlivad åt komsttoken (giltig i cirka 60—90 minuter) och en långlivad uppdateringstoken. Webex lagrar säkert uppdateringstoken på serversidan, bunden till användarens Webex-identitet.

    Åtkomsttoken förnyas inte kontinuerligt. Istället, när en användare skickar en begäran, Webex kontrollerar om den aktuella åtkomsttoken fortfarande är giltig. Om det har löpt ut byter Webex tyst uppdateringstoken mot en ny åtkomsttoken. Uppdateringstokens giltighet förlängs varje gång den används, vilket gör att sessionen kan förbli aktiv utan användarens ingripande så länge funktionen används regelbundet.

    Sessionsuppsägning

    Sessionen avslutas och återautentisering krävs under följande villkor:

    • Inaktivitet: Användaren har inte använt funktionen under en längre period (vanligtvis 90 dagar, beroende på standardprincipen för Microsoft Entra ID och kundens klientkonfiguration).

    • Manuell frånkoppling: Använ daren kopplar uttryckligen bort sitt Microsoft- konto från inställningarna för Webex-appen.

    • Administrativ: En Microsoft 365-administratör återkallar programmets åtkomst i Entra ID.

    • Konfigurationsändringar: De beviljade behörighetsomfången ändras eller programregistreringen ändras.

    Mer information finns i ”Auktorisering av Microsoft-konto i Webex-appen.”

  • Snabbtext:

    Snabbtext hänvisar till den inmatning på naturligt språk som anges av en användare inomCisco AI Assistant, till exempel en begäran om att hitta status för ett projekt eller hitta ett dokument i sitt Microsoft-konto. Denna text genereras av användaren vid körning.

    Bearbetningsarbetsflöde

    När en uppmaning skickas Cisco AI Assistant följer du dessa steg för att hämta och presentera information:

    • Tolkning och optimering: Assistenten tolkar prompten, utför resonemang och kör omskrivning av frågor för att producera en optimerad frågesträng.

    • API-anrop: Assistenten anropar Microsoft 365 Copilot Retrieval API mot en eller flera datakällor.

    • Filtrering: I tillämpliga fall används KQL-filter uttryck (Keyword Query Language) för att utvidga hämtningen till specifika platser, dokument bibliotek, filtyper eller datumintervall.

    • Omrankning och syntes: Assistenten omprövar och filtrerar de returnerade textbitarna. Det genererar sedan ett slutligt svar som kombinerar den ursprungliga prompten med det hämtade innehållet, inklusive citat tillbaka till källdokumenten.

  • SharePoint- och OneDrive-innehåll: SharePoint- och OneDrive-innehåll är auktoriserade Microsoft 365-data som hämtas via Microsoft 365 Copilot Retrieval API för att svara på en användarförfrågan. API för hämtning extraherar relevanta textbitar direkt från Microsoft 365 hybridinnehållsindex utan att duplicera, exportera eller indexera data separat.

    Filtyper som stöds: .docx, .pptx, .pdf, .aspx och .one; icke-textinnehåll som bilder och diagram stöds inte.

    Allt innehåll hämtas inom Microsoft 365-förtroendegränsen och är strikt begränsat till filer och dokument som den inloggade användaren har behörighet att komma åt enligt Microsoft 365s behörighetsmodell.

    • Begär an: Cisco AI Assistant skickar en HTTPS POST-förfrågan till https://graph.microsoft.com/v1.0/copilot/retrieval, med den delegerade åtkomsttoken för Microsoft Entra ID i auktoriseringsrubriken. Ansökningsorgan innehåller:

      • QueryString — omskriven naturlig språkfråga som härrör från användarens prompt (max 1 500 tecken).

      • Datakälla — Ställ in på SharePoint eller OneDrive (en per begäran; separata anrop görs för varje källa).

      • FilterExpression (valfritt) —KQL-uttryck som ska omfångas efter webbplats-URL, sökväg, fil typ eller datumintervall.

      • MaximumNumberOfResults — begränsat till 25 per samtal.

    • Svar: Microsoft 365 bearbetar begäran inom dess förtroendegräns och returnerar en RetrievalHits-array, där varje post innehåller:

      • ContentChunk — ett extraherat textutdrag från innehållsindexet

      • Relevanskärna — cosinus likhetspoäng mellan frågan och biten, normaliserad till ett intervall på 0—1

      • resurs — källmetadata inklusive filnamn, webbadress, författare och senast ändrat datum

    • Datahantering: Inget fullständigt filinnehåll överförs — endast förextraherade text bitar från Microsoft 365-hybridindexet returneras. Cisco AI Assistantskickar dessa bitar övergående till sin LLM för omrankning, filtrering och svarsgenerering. Källmetadata används för att konstruera citat i det slutliga svaret. Textbitar lagras inte av Webex efter förfrågningens varaktighet.

  • Innehåll för Copilot Connectors: Inne hållet i Copilot Connectors är tredjepartsdata eller anpassade företagsdata som tas in i Microsoft 365-innehållsindexet via Microsoft Graph- anslutningar och görs tillgängliga via Microsoft 365 Copilot Retrieval API. Allt returnerat innehåll är begränsat till objekt som den inloggade användaren har behörighet att komma åt under anslut ningens konfigurerade behörigheter i Microsoft 365.

    • Begär an: Cisco AI Assistant skickar en HTTPS POST-förfrågan till https://graph.microsoft.com/v1.0/copilot/retrieval, med den delegerade åtkomsttoken för Microsoft Entra ID i auktoriseringsrubriken. Ansökningsorgan innehåller:

      • QueryString — omskriven naturlig språkfråga som härrör från användarens prompt (max 1 500 tecken).

      • Datakälla — Ställ in på CoPilotConnectors.

      • FilterExpression (valfritt) —KQL-uttryck för hämtning av omfattning till specifika kopplingskällor eller inne hållstyper.

      • MaximumNumberOfResults — begränsat till 25 per samtal.

    • Svar: Microsoft 365 bearbetar begäran inom dess förtroendegräns och returnerar en RetrievalHits-array, varje post innehåller:

      • ContentChunk — ett extraherat textutdrag från det indexerade tredjepartsinnehållet.

        Relevanskärna — cosinuslikhetspoäng mellan frågan och biten, normaliserad till ett intervall på 0—1. Observera att relevanspoäng kanske inte finns för alla Copilot Connector-resultat.

        resurs — källmetadata inklusive objektnamn, URL och anslutningsdefinierade attribut.

  • Datahantering: Inget fullständigt källinnehåll överförs — endast förextraherade text bitar från Microsoft 365-innehållsindexet returneras. Eftersom API:et för hämtning är inriktat på en datakälla per anrop Cisco AI Assistant utfärdas separata hämtningsanrop för SharePoint-, OneDrive- och Copilot-anslutningar och sammanfog ar resultaten under omrankningssteget.

    Textbitar skickas övergående till LLM för omrankning, filtrering och svars generering, och lagras inte av Webex efter förfrågningens varaktighet.

Autentisering och auktorisering

Webex interagerar med dina Microsoft-konton och innehåll med hjälp av Microsoft Retrieval API, som autenti seras och hanteras av Microsofts identitetsleverantör (IdP). All kommunikation med Microsoft IdP och API för hämtning skyddas av TLS-säkrade anslutningar.

Webex-tjänstautentisering

Cisco AI Assistanti Webex App använder standard OAuth 2.0-flöden för att interagera med Webex-tjänster:

  • Identitetsleverantör: Webex Identity Service fungerar som molnbaserad IdP för att autentisera användare och auktorisera API-åtkomst.

  • Bärartokens: För frågningar till Webex API:er godkänns med hjälp av bärartokens som utfärdats av Webex Identity Service.

  • Säker kommunikation: Allt datautbyte mellan WebexAI Assistant, Webex Identity Service och Webex API:er utförs via TLS-säkrade anslutningar.

Administrativa krav

För att aktivera denna integrering måste administratörer utföra följande steg:

  1. Microsoft 365-konfiguration: Administratörer måste tilldela lämpliga Microsoft Copilot-licenser till relevanta användare.

  2. Webex-konfiguration: Administratörer kan aktivera eller inaktivera funktionen på organisations-, användar- eller mallnivå direkt i Control Hub.

Användarsamtyckta behörigheter

Under installationen begärs följande behörigheter:

Tillstånd krävs Syfte
Webex App Logga in och läs användarprofil Logga in på Webex-appen med ditt konto.
Auktorisera och logga in på ditt Microsoft-konto Validera och auktorisera Webex App för att ansluta till ditt Microsoft-konto.

Dessa behörigheter används endast under installationsprocessen och lagras inte.

Tjänstbehörigheter

Det behövs inget specifikt servicetillstånd. Administratörer kan hantera funktionen och inställningarna i Control Hub med nedanstående avsnittsdetaljer.

Inställningar och konfigurationer för Webex App

Användare kan logga in på Webex-appen och auktorisera att ansluta Microsoft-kontot efter att administratören har aktiverat funktionen med auktorisering med Control Hub

Mer information finns i Åtkomst till dina Microsoft-data med Cisco AI Assistant

Var den här artikeln användbar?
Var den här artikeln användbar?