V tomto článku
Souhrn
Přehled architektury
Zacházení s daty
dropdown icon
Autentizace a autorizace
    Oprávnění udělená uživatelem
    Oprávnění k obsluze
Správa a autorizace funkcí integrace Copilot v Control Hub
Nastavení a konfigurace aplikace Webex
Další referenční materiál
Povolit AI Assistant prohledávat externí zdroje dat společnosti Microsoft
list-menuV tomto článku
list-menuZpětná vazba?

Integrace s Microsoft Copilot umožňuje uživatelům schůzek Webex bezpečně se připojit ke svým účtům Microsoft Copilot jako k jednomu ze zdrojů dat.

Souhrn

Pomocí aplikace We Cisco AI Assistant bex mohou uživatelé vyhledávat, analyzovat a shrnout výsledky ze zdrojů dat společnosti Microsoft, včetně SharePoint, OneDrive a Copilot Connectors.

Přehled architektury

Připojení k aplikaci Microsoft Copilot umožňuje interakci se zdroji dat společnosti Microsoft pomocí rozhraní API pro vyhledávání aplikací Microsoft. Když použijeteCisco AI Assistant, načte data ze zdrojů společnosti Microsoft v reálném čase.

Webex neukládá ani neuchovává data, která vám byla vrácena prostřednictvímCisco AI Assistant. Data se používají pouze v daném okamžiku k vygenerování vaší odpovědi, čímž je zajištěno, že vaše soukromí zůstane chráněno.

Architecture overview for how Webex AI Assistant uses Microsoft data

Podrobné kroky toku dat

Správa a přiřazení uživatelů

Správci mohou spravovat uživatele, kteří mají licence Microsoft Copilot, a zapínat nebo vypnout funkci na úrovni organizace, uživatele nebo šablony pomocí ovládacího centra.

Autorizace uživatele a připojení

  1. Uživatel se přihlásí do aplikace Webex

  2. Uživatel přejde na stránku Nastavení a připojí svůj účet Microsoft.

Uživatel dokončí proces autorizace a vybere, ke kterým zdrojům (SharePoint, OneDrive nebo Copilot Connector) má přístup.

Pracovní postup otázek a odpovědí

Uživatel položí otázku, například: jaký je stav projektu ABC?

Následující kroky budou provedeny pomocí několika dílčích kroků službou Webex Meeting Service:

  1. Dešifrovat: systém dešifruje požadavek.

  2. Načíst kontext: je načten relevantní kontext.

  3. LLM odůvodnění: LLM přepisuje otázku pro optimální vyhledávání.

  4. Načíst informace o integraci: systém načte konfiguraci a tokeny pro vyhledávání více cest.

  5. Vyhledávání více cest: systém provádí načítání napříč podporovanými nástroji společnosti Microsoft.

    • Vyhledávání: nástroje pro vyhledávání více cest prohledávají podrobný obsah.

    • Vrátit výsledek hledání: nástroje pro vyhledávání více cest vracejí výsledek hledání.

  6. Znovu řazení a filtrování: Služba schůz ek Webex používá LLM k přesměrování a filtrování obsahu z hlediska relevance.

  7. Generace: LLM vygeneruje konečnou odpověď s citacemi.

  8. Odpověď: odes lat konečnou odpověď do aplikace Webex.

Zacházení s daty

Zacházení s daty

Tato funkce používá následující informace o konfiguraci dat a služeb ke správě autorizace, načítání autorizovaného obsahu Microsoft 365 a poskytování odpovědí v aplikaci Webex:

  • Registrace aplikace Microsoft:

    Registrace aplikace Microsoft představuje konfiguraci klienta OAuth 2.0 registrovanou na portálu Microsoft Azure (Entra ID) pro integraci. Cisco AI Assistant

    Tato registrace definuje konkrétní delegovaná oprávnění požadovaná během toku autorizace účtu Microsoft:

    • Read.All a Sites.Read.All: vyžadováno pro přístup k obsahu SharePointu a OneDrivu.

    • ExternalItem.READ.ALL: vyžadováno pro přístup k obsahu Copilot Connectors.

    Cisco AI Assistantpoužívá tuto registraci k vyhledání správného nastavení OAuth pro přih lášení a získání tokenu před vyvoláním rozhraní Microsoft 365 Copilot Retrieval API. Další informace naleznete v části „Registrace Cisco AI Assistant v Microsoft Azure“.

  • Tokeny Microsoft OAuth:

    Tokeny Microsoft OAuth jsou krátkodobé delegované přístupové tokeny vydané Microsoft Entra ID, jakmile se uživatel přihlásí ke svému účtu Microsoft prostřednictvím stránky nastavení aplikace Webex a udělí potřebná oprávnění.

    Cisco AI Assistantpoužívá tyto tokeny k volání rozhraní Microsoft 365 Copilot Retrieval API jménem uživatele . Microsoft Entra ID používá tyto tokeny k ověření každého požadavku, identifikaci uživatele a vynucení zásad řízení přístupu a bariéry informací Microsoft 365, čímž zajišťuje, že bude vrácen pouze obsah, ke kterému má přihlášený uživatel přístup.

    Obnovení tokenu

    V době počáteční autorizace vydává Microsoft Entra ID jak krátkodob ý přístupový token (platný přibližně 60—90 minut), tak obnovovací token s dlouhou životností. Webex bezpečně ukládá obnovovací token na straně serveru, vázaný na identitu Webex uživatele.

    Přístupové tokeny se neobnovují nepřetržitě. Místo toho, když uživatel odešle požadavek, Webex zkontroluje, zda je aktuální přístupový token stále platný. Pokud vypršela platnost, Webexnevědomky vymění obnovovací token za nový přístupový token. Platnost obnovovacího tokenu se při každém použití prodlužuje, což umožňuje relaci zůstat aktivní bez zásahu uživatele, pokud je funkce pravidelně používána.

    Ukončení relace

    Relace je ukončena a opětovné ověření je vyžadováno za následujících podmínek:

    • Nečinnost: Uživatel tuto funkci nepoužívá delší dobu (obvykle 90 dní, v závislosti na výchozích zásadách Microsoft Entra ID a konfiguraci kli enta zákazníka).

    • Ruční odpojení: Uživatel výslovně odpojí svůj účet Microsoft od nastavení aplikace Webex.

    • Správa: Správce Microsoft 365 zruší přístup aplikace v Entra ID.

    • Změny konfigurace: Rozsahy udělených oprávnění jsou upraveny nebo se změní registrace aplikace.

    Další informace naleznete v části „Autorizace účtu Microsoft v aplikaci Webex“.

  • Text výzvy:

    Text výzvy odkazuje na vstup v přirozeném jazyce zadaný uživatelem v rámci aplikaceCisco AI Assistant, například požadavek na nalezení stavu projektu nebo vyhledání dokumentu v jeho účtu Microsoft. Tento text je generován uživatelem za běhu.

    Pracovní postup zpracování

    Po odeslání výzvy proveďte Cisco AI Assistant následující kroky k načtení a prezentaci informací:

    • Interpretace a optimalizace: Asistent interpretuje výzvu, provede uvaž ování a provede přepisování dotazu, aby vytvořil optimalizovaný řetězec dotazu.

    • Vy@@ volání rozhraní API: Asistent vyvolá rozhraní Microsoft 365 Copilot Retrieval API proti jednomu nebo více zdrojům dat.

    • Filtrování: Tam, kde je to možné, se filtrační výrazy jazyka dotazu klíčových slov (KQL) použijí k rozsahu vyhledávání na konkrétní lokality, knihovny dokumentů, typy souborů nebo období.

    • Opětovné řazení a syntéza: Asistent znovu provede a filtruje vrácené textové bloky. Poté vygeneruje konečnou odpověď, která kombinuje původní výz vu s načteným obsahem, včetně citací zpět do zdrojových dokumentů.

  • Obsah SharePointu a OneDrivu: Obsah SharePointu a OneDrive je autorizován pro data Microsoft 365 načtená prostřednictvím rozhraní Microsoft 365 Copilot Retrieval API pro zodpovězení požadavku uživatele. Rozhraní API pro vyhledávání extrahuje relevantní textové bloky přímo z indexu hybridního obsahu Microsoft 365, aniž by duplikovalo, exportovalo nebo samostatně indexovalo jakákoli data.

    Podporované typy souborů: .docx, .pptx, .pdf, .aspx a .one; netextový obsah, jako jsou obrázky a grafy, není podporován.

    Veškerý obsah je načten v rámci hranice důvěryhodnosti Microsoft 365 a je přísně omezen na soubory a dokumenty, ke kterým je přihlášený uživatel oprávněn přistupovat podle modelu opráv nění Microsoft 365.

    • Žádost: Cisco AI Assistant odešle požadavek HTTPS POST na adresu https://graph.microsoft.com/v1.0/copilot/retrieval s tokenem delegovaného přístupu Microsoft Entra ID v záhlaví Autorizace. Tělo žádosti obsahuje:

      • QueryString — přepsaný dotaz v přirozeném jazyce odvozený z výzvy uživatele (max. 1 500 znaků).

      • DataSource — nastaveno na SharePoint nebo OneDrive (jeden na požadavek; pro každý zdroj jsou prováděna samostatná volání).

      • FilterExpression (volitelné) —Výraz KQL pro rozsah podle adresy URL webu, cesty, typu souboru nebo časového období.

      • MaximumNumberOfResults—omezeno na 25 na hovor.

    • Odpověď: Microsoft 365 zpracovává požadavek v rámci své hranice důvěryhodnosti a vrací pole RetrievalHits, přičemž každá položka obsahuje:

      • ContentChunk — extrahovaný úryvek textu z indexu obsahu

      • RelevanceCore—skóre podobnosti kosinu mezi dotazem a blokem, normalizované na rozsah 0—1

      • zdroj — zdrojová metadata včetně názvu souboru, adresy URL, autora a data poslední úpravy

    • Zpracování dat: Nepřenáší se žádný úplný obsah souboru — vrátí se pouze předem extrahované textové blo ky z hybridního indexu Microsoft 365. Cisco AI Assistanttyto bloky přechodně předává svému LLM pro opětovné vyhledávání, filtrování a generování odpovědí. Zdrojová metadata se používají ke konstrukci citací v konečné odpovědi. Bloky textu nejsou Webex ukládat po dobu trvání požadavku.

  • Obsah konektorů Copilot: Obsah Copilot Connectors jsou data třetích stran nebo vlastní podniková data přijatá do indexu obsahu Microsoft 365 prostřednictvím konektorů Microsoft Graph a získatelná prostřednictvím rozhraní Microsoft 365 Copilot Retrieval API. Vešker ý vrácený obsah je omezen na položky, ke kterým je přihlášený uživatel oprávněn přistupovat pod nakonfigurovanými oprávněními konektoru v Microsoft 365.

    • Žádost: Cisco AI Assistant odešle požadavek HTTPS POST na adresu https://graph.microsoft.com/v1.0/copilot/retrieval s tokenem delegovaného přístupu Microsoft Entra ID v záhlaví Autorizace. Tělo žádosti obsahuje:

      • QueryString — přepsaný dotaz v přirozeném jazyce odvozený z výzvy uživatele (max. 1 500 znaků).

      • DataSource — nastavte na CopilotConnectors.

      • FilterExpression (volitelné) —Výraz KQL pro vyhledání rozsahu ke konkrétním zdrojům konektoru nebo typům obsahu.

      • MaximumNumberOfResults—omezeno na 25 na hovor.

    • Odpověď: Microsoft 365 zpracovává požadavek v rámci své hranice důvěryhodnosti a vrací pole RetrievalHits, přičemž každá položka obsahuje:

      • ContentChunk — extrahovaný fragment textu z indexovaného obsahu třetí strany.

        RelevancesCore — skóre podobnosti kosinu mezi dotazem a blokem, normalizované na rozsah 0—1. Všimněte si, že skóre relevance nemusí být přítomno pro všechny výsledky Copilot Connector.

        zdroj — zdrojová metadata včetně názvu položky, adresy URL a atributů definovaných konektorem.

  • Zpracování dat: Nepřenáší se žádný úplný zdrojový obsah — vrátí se pouze předem extrahované textové bloky z indexu obsahu Microsoft 365. Protože rozhraní API pro vyhledávání cílí na jeden zdroj dat na každé volání, vy Cisco AI Assistant dává samostatná volání pro SharePoint, OneDrive a Copilot Connectors a sloučí výsledky během kroku opě tovného přiřazování.

    Bloky textu jsou přechodně předávány LLM pro opětovné vyhledávání, filtrování a generování odpovědí a Webex je neukládá po dobu trvání požadavku.

Autentizace a autorizace

Webex spolupracuje s vašimi účty a obsahem Microsoft pomocí rozhraní Microsoft Retrieval API, které je ověřeno a spravováno poskytovatelem identity společnosti Microsoft (IdP). Veškerá komunikace s Microsoft IdP a Retrieval API je chráněna připojeními zabezpečenými TLS.

Ověření služby Webex

Cisco AI Assistantv aplikaci Webex využívá standardní toky OAuth 2.0 pro interakci se službami Webex:

  • Poskytovatel identity: Služba Webex Identity Service funguje jako cloudový IdP pro ověřování uživatelů a autorizaci přístupu k rozhraní API.

  • Žetony nositele: Ž ádosti na rozhraní API Webex jsou autorizovány pomocí tokenů na doručitele vydaných služ bou Webex Identity Service.

  • Zabezpečená komunikace: Veškerá výměna dat mezi rozhraními API WebexAI Assistant, Webex Identity Service a Webex probíhá přes připojení zabezpečená TLS.

Administrativní požadavky

Chcete-li tuto integraci povolit, musí správci provést následující kroky:

  1. Konfigurace Microsoft 365: Správci musí příslušným uživatelům přiřadit příslušné licence Microsoft Copilot.

  2. Konfigurace Webex: Správci mohou povolit nebo zakázat funkci na úrovni organizace, uživatele nebo šablony přímo v Řídicím centru.

Oprávnění udělená uživatelem

Během instalace jsou požadována následující oprávnění:

Povolení vyžadováno Účel
Webex App Přihlaste se a přečtěte si profil uživatele Přihlaste se k aplikaci Webex pomocí svého účtu.
Autorizace a přihlášení k účtu Microsoft Ověřte a autorizujte aplikaci Webex pro připojení k vašemu účtu Microsoft.

Tato oprávnění se používají pouze během procesu instalace a nejsou uložena.

Oprávnění k obsluze

Není potřeba žádné specifické servisní oprávnění. Správci mohou spravovat funkci a nastavení v Control Hub s níže uvedenými podrobnostmi v části.

Nastavení a konfigurace aplikace Webex

Uživatelé se mohou přihlásit k aplikaci Webex a autorizovat připojení účtu Microsoft poté, co správce zapne funkci s autorizací pomocí ovládacího centra

Další informace naleznete v tématu Pří stup k datům společnosti Microsoft pomocí Cisco AI Assistant

Byl tento článek užitečný?
Byl tento článek užitečný?