- Start
- /
- Artikel
Dankzij de integratie met Microsoft Copilot kunnen gebruikers van Webex Meeting veilig verbinding maken met hun Microsoft Copilot-accounts als een van hun gegevensbronnen.
Samenvatting
Door gebruik te maken Cisco AI Assistant van de Webex-app kunnen gebruikers de resultaten van Microsoft-gegevensbronnen, waaronder SharePoint, OneDrive en Copilot Connectors, zoeken, analyseren en samenvatten.
Overzicht van de architectuur
Door verbinding te maken met Microsoft Copilot kunt u communiceren met Microsoft-gegevensbronnen met behulp van Microsoft Retrieval API's. Wanneer u de gebruiktCisco AI Assistant, worden gegevens in realtime opgehaald uit uw Microsoft-bronnen.
Webex slaat de gegevens die naar u worden teruggestuurd niet op of bewaart ze niet. Cisco AI Assistant Gegevens worden enkel op dat moment gebruikt om uw antwoord te genereren, zodat uw privacy beschermd blijft.
Gedetailleerde stappen voor de gegevensstroom
Gebruikersbeheer en -toewijzing
Beheerders kunnen gebruikers met een Microsoft Copilot-licentie beheren en de functie voor organisatie-, gebruikers- of sjabloonniveau in- of uitschakelen met behulp van Control Hub.
Autorisatie en verbinding van de gebruiker
-
De gebruiker meldt zich aan bij de Webex-app
-
De gebruiker navigeert naar de pagina Instellingen om zijn Microsoft-account te koppelen.
De gebruiker voltooit het autorisatieproces en selecteert tot welke bronnen (SharePoint, OneDrive of Copilot Connector) toegang moet worden verkregen.
Workflow voor vraag en antwoord
De gebruiker stelt bijvoorbeeld een vraag: wat is de status van project ABC?
De volgende stappen worden uitgevoerd met behulp van meerdere substappen door Webex Meeting Service:
-
Decoderen: het systeem decodeert de aanvraag.
-
Context laden: de relevante context is geladen.
-
LLM-redenering: LLM herschrijft de vraag zodat deze optimaal wordt opgehaald.
-
Integratiegegevens ophalen: het systeem haalt de configuratie en tokens op om op meerdere paden te zoeken.
-
Zoeken op meerdere paden: het systeem voert een opvraging uit van alle ondersteunde Microsoft-tools.
-
Zoeken: met tools voor het ophalen van meerdere paden wordt gedetailleerde inhoud doorzocht.
-
Zoekresultaat retourneren: tools voor het ophalen van meerdere paden geven het zoekresultaat terug.
-
-
Herrangschikken en filteren: De Webex-vergaderservice gebruikt de LLM om inhoud opnieuw te rangschikken en te filteren op relevantie.
-
Generatie: LLM genereert een definitief antwoord met citaten.
-
Antwoord: post het definitieve antwoord op de Webex-app.
Gegevensverwerking
Gegevensverwerking
Deze functie gebruikt de volgende gegevens en serviceconfiguratiegegevens om autorisatie te beheren, geautoriseerde Microsoft 365-inhoud op te halen en antwoorden te geven in de Webex-app:
-
Registratie van Microsoft-toepassingen:
De Microsoft Application Registration vertegenwoordigt de OAuth 2.0-clientconfiguratie die is geregistreerd in de Microsoft Azure-portal (Entra ID) voor de Cisco AI Assistant integratie.
Deze registratie definieert de specifieke gedelegeerde machtigingen die vereist zijn tijdens de autorisatiestroom van een Microsoft-account:
-
Read.All en Sites.Read.All: vereist voor toegang tot SharePoint- en OneDrive-inhoud.
-
ExternalItem.read.all: vereist voor toegang tot de inhoud van Copilot Connectors.
Cisco AI Assistantgebruikt deze registratie om de juiste OAuth-instellingen te vinden voor aanmelding en tokenverwerving voordat de Microsoft 365 Copilot Retrieval API wordt aangeroepen. Zie „Registreren Cisco AI Assistant in Microsoft Azure” voor meer informatie.
-
-
Microsoft OAuth-tokens:
Microsoft OAuth-tokens zijn gedelegeerde toegangstokens van korte duur die worden uitgegeven door Microsoft Entra ID zodra een gebruiker zich via de instellingenpagina van de Webex App aanmeldt bij zijn Microsoft-account en de nodige machtigingen verleent.
Cisco AI Assistantgebruikt deze tokens om namens de gebruiker de Microsoft 365 Copilot Retrieval API aan te roepen. Microsoft Entra ID gebruikt deze tokens om elk verzoek te verifiëren, de gebruiker te identificeren en het Microsoft 365-beleid inzake toegangscontrole en informatiebarrières af te dwingen, waarbij ervoor wordt gezorgd dat alleen inhoud wordt geretourneerd die de ingelogde gebruiker mag gebruiken.
Verlenging van tokens
Op het moment van de eerste autorisatie geeft Microsoft Entra ID zowel een toegangstoken met een korte levensduur (geldig voor ongeveer 60-90 minuten) als een vernieuwingstoken met een lange levensduur uit. Webex slaat de refresh token veilig op aan de serverzijde, gekoppeld aan de Webex-identiteit van de gebruiker.
Toegangstokens worden niet continu verlengd. Als een gebruiker daarentegen een verzoek indient, controleert Webex of het huidige toegangstoken nog geldig is. Als de vervaldatum is verstreken, ruilt Webex het vernieuwingstoken in voor een nieuw toegangstoken. De geldigheid van het vernieuwingstoken wordt bij elk gebruik verlengd, zodat de sessie actief kan blijven zonder tussenkomst van de gebruiker, zolang de functie regelmatig wordt gebruikt.
Beëindiging van de sessie
De sessie is beëindigd en herauthenticatie is vereist onder de volgende voorwaarden:
-
Inactiviteit: De gebruiker heeft de functie gedurende een langere periode niet gebruikt (meestal 90 dagen, afhankelijk van het standaardbeleid van Microsoft Entra ID en de tenantconfiguratie van de klant).
-
Handmatige verbreking van de verbinding: De gebruiker verbreekt expliciet de verbinding tussen zijn Microsoft-account en de instellingen van de Webex-app.
-
Administratief: Een Microsoft 365-beheerder trekt de toegang tot de toepassing in Entra ID in.
-
Wijzigingen in de configuratie: De toegestane toestemmingsbereiken worden gewijzigd of de registratie van de toepassing wordt gewijzigd.
Zie „Autorisatie van Microsoft-accounts in de Webex-app” voor meer informatie.
-
-
Tekst van de prompt:
De prompttekst verwijst naar de invoer in natuurlijke taal die een gebruiker heeft ingevoerd in deCisco AI Assistant, zoals een verzoek om de status van een project te achterhalen of een document te vinden in zijn Microsoft-account. Deze tekst wordt tijdens runtime door de gebruiker gegenereerd.
Workflow voor verwerking
Wanneer een prompt wordt verzonden, Cisco AI Assistant volgt u deze stappen om informatie op te halen en te presenteren:
-
Interpretatie en optimalisatie: De assistent interpreteert de prompt, voert een redenering uit en voert een herschrijving uit om een geoptimaliseerde queryreeks te produceren.
-
API-aanroep: De assistent roept de Microsoft 365 Copilot Retrieval API aan tegen een of meer gegevensbronnen.
-
Filteren: Waar van toepassing worden filterexpressies van Keyword Query Language (KQL) toegepast om het ophalen te beperken tot specifieke sites, documentbibliotheken, bestandstypen of datumbereiken.
-
Herrangschikking en synthese: De assistent rangschikt en filtert de geretourneerde tekstblokken. Vervolgens wordt een definitief antwoord gegenereerd dat de oorspronkelijke prompt combineert met de opgehaalde inhoud, inclusief verwijzingen naar de brondocumenten.
-
-
SharePoint- en OneDrive-inhoud: SharePoint- en OneDrive-inhoud is geautoriseerd voor Microsoft 365-gegevens die via de Microsoft 365 Copilot Retrieval API worden opgehaald om een gebruikersverzoek te beantwoorden. De Retrieval API extraheert relevante tekstblokken rechtstreeks uit de hybride inhoudsindex van Microsoft 365 zonder gegevens te dupliceren, te exporteren of afzonderlijk te indexeren.
Ondersteunde bestandstypen: .docx, .pptx, .pdf, .aspx en .one; niet-tekstuele inhoud zoals afbeeldingen en grafieken wordt niet ondersteund.
Alle inhoud wordt opgehaald binnen de vertrouwensgrens van Microsoft 365 en is strikt beperkt tot bestanden en documenten waartoe de ingelogde gebruiker toegang heeft volgens het machtigingsmodel van Microsoft 365.
-
Verzoek: Cisco AI Assistant stuurt een HTTPS POST-verzoek naar https://graph.microsoft.com/v1.0/copilot/retrieval, met het gedelegeerde toegangstoken van de Microsoft Entra ID in de autorisatiekop. De hoofdtekst van het verzoek bevat:
-
QueryString — de herschreven zoekopdracht in natuurlijke taal die is afgeleid van de prompt van de gebruiker (maximaal 1.500 tekens).
-
Gegevensbron: ingesteld op SharePoint of OneDrive (één per aanvraag; voor elke bron worden aparte gesprekken gevoerd).
-
FilterExpression (optioneel) —KQL-expressie voor het bereik op basis van de URL van de site, het pad, het bestandstype of het datumbereik.
-
Maximaal aantal resultaten, met een maximum van 25 per gesprek.
-
-
Antwoord: Microsoft 365 verwerkt het verzoek binnen de vertrouwensgrens en retourneert een RetrievalHits-array, waarbij elk item het volgende bevat:
-
ContentChunk — een geëxtraheerd tekstfragment uit de inhoudsindex
-
RelevanceScore—Cosinus-overeenkomstscore tussen de zoekopdracht en het deel, genormaliseerd naar een bereik van 0-1
-
metagegevens van de bron, waaronder de bestandsnaam, URL, auteur en datum van de laatste wijziging
-
-
Gegevensverwerking: Er wordt geen volledige bestandsinhoud overgezet — alleen vooraf geëxtraheerde tekstblokken uit de hybride index van Microsoft 365 worden geretourneerd. Cisco AI Assistantstuurt deze brokken tijdelijk door naar zijn LLM voor herrangschikking, filtering en het genereren van antwoorden. Metagegevens van de bron worden gebruikt om citaten te construeren in het uiteindelijke antwoord. Tekstblokken worden niet opgeslagen door Webex na de duur van de aanvraag.
-
-
Inhoud van Copilot Connectors: De inhoud van Copilot Connectors bestaat uit bedrijfsgegevens van derden of aangepaste bedrijfsgegevens die via Microsoft Graph-connectoren in de Microsoft 365-inhoudsindex worden opgenomen en via de Microsoft 365 Copilot Retrieval API kunnen worden opgehaald. Alle geretourneerde inhoud is beperkt tot items waartoe de aangemelde gebruiker toegang heeft op grond van de door de connector geconfigureerde machtigingen in Microsoft 365.
-
Verzoek: Cisco AI Assistant stuurt een HTTPS POST-verzoek naar https://graph.microsoft.com/v1.0/copilot/retrieval, met het gedelegeerde toegangstoken van de Microsoft Entra ID in de autorisatiekop. De hoofdtekst van het verzoek bevat:
-
QueryString — de herschreven zoekopdracht in natuurlijke taal die is afgeleid van de prompt van de gebruiker (maximaal 1.500 tekens).
-
Gegevensbron — ingesteld op CoPilot-aansluitingen.
-
FilterExpression (optioneel) —KQL-expressie om het bereik op te halen naar specifieke connectorbronnen of inhoudstypen.
-
Maximaal aantal resultaten, met een maximum van 25 per gesprek.
-
-
Antwoord: Microsoft 365 verwerkt het verzoek binnen de vertrouwensgrens en retourneert een RetrievalHits-array, waarbij elk item het volgende bevat:
-
ContentChunk — een tekstfragment dat is geëxtraheerd uit de geïndexeerde inhoud van derden.
RelevanceScore—Cosinus-overeenkomstscore tussen de zoekopdracht en het deel, genormaliseerd naar een bereik van 0-1. Houd er rekening mee dat de relevantiescore mogelijk niet voor alle resultaten van Copilot Connector aanwezig is.
metagegevens van bronnen en bronnen, waaronder de naam van het item, de URL en door de connector gedefinieerde kenmerken.
-
-
-
Gegevensverwerking: Er wordt geen volledige broninhoud overgedragen, alleen vooraf geëxtraheerde tekstblokken uit de Microsoft 365-inhoudsindex worden geretourneerd. Omdat de Retrieval API zich richt op één gegevensbron per aanroep, afzonderlijke Cisco AI Assistant ophaalaanroepen uitvoert voor SharePoint-, OneDrive- en Copilot Connectors en de resultaten samenvoegt tijdens de herrangschikkingsstap.
Tekstblokken worden tijdelijk doorgegeven aan de LLM voor herrangschikking, filtering en het genereren van antwoorden, en worden niet opgeslagen door Webex na de duur van de aanvraag.
Authenticatie en autorisatie
Webex communiceert met uw Microsoft-accounts en -inhoud via de Microsoft Retrieval API, die wordt geverifieerd en beheerd door de Microsoft Identity Provider (IdP). Alle communicatie met de Microsoft IdP en de Retrieval API wordt beschermd door TLS-beveiligde verbindingen.
Authenticatie van de Webex-service
Cisco AI Assistantin de Webex-app maakt gebruik van standaard OAuth 2.0-stromen voor interactie met Webex-services:
-
Identiteitsprovider: De Webex Identity Service fungeert als IdP in de cloud om gebruikers te authenticeren en API-toegang te autoriseren.
-
Tokens aan dragers: Aanvragen voor Webex API's worden geautoriseerd met tokens aan toonder die zijn uitgegeven door de Webex Identity Service.
-
Veilige communicatie: Alle gegevensuitwisseling tussen de WebexAI Assistant, de Webex Identity Service en de Webex API's vindt plaats via TLS-beveiligde verbindingen.
Administratieve vereisten
Om deze integratie mogelijk te maken, moeten beheerders de volgende stappen uitvoeren:
-
Microsoft 365-configuratie: Beheerders moeten de juiste Microsoft Copilot-licenties toewijzen aan de relevante gebruikers.
-
Webex-configuratie: beheerders kunnen de functie op organisatie-, gebruikers- of sjabloonniveau rechtstreeks in Control Hub in- of uitschakelen.
Machtigingen met toestemming van de gebruiker
Tijdens de installatie worden de volgende machtigingen gevraagd:
| Toestemming vereist | Doel |
|---|---|
| Aanmelden en gebruikersprofiel lezen in de Webex-app | Meld u aan bij de Webex-app met uw account. |
| Autoriseer en meld u aan bij uw Microsoft-account | Valideer en autoriseer de Webex App om verbinding te maken met uw Microsoft-account. |
Deze machtigingen worden alleen tijdens het installatieproces gebruikt en worden niet opgeslagen.
Machtigingen voor diensten
Er is GEEN specifieke servicetoestemming nodig. Beheerders kunnen de functie en instellingen beheren in de Control Hub met de onderstaande sectiegegevens.
Copilot-integratie, functiebeheer en autorisatie in Control Hub.
Beheerders kunnen de functie voor hun organisatie in- of uitschakelen, of ze kunnen met behulp van selectievakjes beslissen welke bronnen kunnen worden toegewezen.
Voor meer informatie, zie AI-integraties instellen in Control Hub en Cisco AI AssistantZoekbronnen in- of uitschakelen in de Webex-app
Instellingen en configuraties van de Webex-app
Gebruikers kunnen zich aanmelden bij de Webex-app en toestemming geven om verbinding te maken met het Microsoft-account nadat de beheerder de functie met autorisatie heeft ingeschakeld via Control Hub.
Voor meer informatie, zie Toegang tot uw Microsoft-gegevens met Cisco AI Assistant