În acest articol
Rezumat
Prezentare generală a arhitecturii
Manipularea datelor
dropdown icon
Autentificare și autorizare
    Permisiuni consimțite de utilizator
    Permisiuni de serviciu
Gestionarea și autorizarea caracteristicilor de integrare Copilot în Control Hub
Setările și configurațiile aplicației Webex
Material de referință suplimentar
Permiteți AI Assistant să caute surse externe de date Microsoft
list-menuÎn acest articol
list-menuFeedback?

Integrarea cu Microsoft Copilot permite utilizatorilor de întâlniri Webex să se conecteze în siguranță la conturile lor Microsoft Copilot ca una dintre sursele lor de date.

Rezumat

Utilizând Cisco AI Assistant aplicația Webex, utilizatorii pot căuta, analiza și rezuma rezultatele din sursele de date Microsoft, inclusiv conectorii SharePoint, OneDrive și Copilot.

Prezentare generală a arhitecturii

Conectarea la Microsoft Copilot vă permite să interacționați cu sursele de date Microsoft utilizând API-urile Microsoft Retrieval. Când utilizațiCisco AI Assistant, acesta preia date din sursele dvs. Microsoft în timp real.

Webex nu stochează și nu păstrează datele returnate către dvs. prinCisco AI Assistant. Datele sunt utilizate numai în acest moment pentru a genera răspunsul dvs., asigurându-vă că confidențialitatea dvs. rămâne protejată.

Architecture overview for how Webex AI Assistant uses Microsoft data

Pași detaliați ai fluxului de date

Gestionarea și atribuirea utilizatorilor

Administratorii pot gestiona utilizatorii care au licențe Microsoft Copilot și pot activa sau dezactiva caracteristica pentru nivel de organizație, utilizator sau șablon utilizând Control Hub.

Autorizarea utilizatorului și conectarea

  1. Utilizatorul se conectează la aplicația Webex

  2. Utilizatorul navighează la pagina Setări pentru a-și conecta contul Microsoft.

Utilizatorul finalizează procesul de autorizare și selectează sursele (SharePoint, OneDrive sau Copilot Connector) pe care să le acceseze.

Fluxul de lucru pentru întrebări și răspunsuri

Utilizatorul pune o întrebare, de exemplu: care este starea proiectului ABC?

Următorii pași vor fi executați utilizând mai mulți sub-pași de către Webex Meeting Service:

  1. Dec@@ riptare: sistemul decriptează cererea.

  2. Context de încărcare: contextul relevant este încărcat.

  3. R@@ aționament LLM: LLM rescrie întrebarea pentru recuperarea optimă.

  4. Preluați informații de integrare: sistemul pre ia configurația și jetoanele pentru căutarea pe mai multe căi.

  5. Căutare pe mai multe căi: sistemul execută recuperarea prin instrumentele Microsoft acceptate.

    • Căutare: instrumente de recuperare pe mai multe căi caută conținut detaliat.

    • Returnează rezultatul căutării: instrumentele de recuperare cu mai multe căi returnează rezultatul căutării.

  6. Rearanking & Filtrare: Serviciul de întâlnire Webex utilizează LLM pentru a rearanja și filtra conținutul pentru relevanță.

  7. Generare: LLM generează un răspuns final cu citări.

  8. Răspuns: postează răspunsul final la aplicația Webex.

Manipularea datelor

Manipularea datelor

Această caracteristică utilizează următoarele date și informații de configurare a serviciilor pentru a gestiona autorizarea, a prelua conținutul Microsoft 365 autorizat și a furniza răspunsuri în aplicația Webex:

  • În@@ registrarea aplicației Microsoft:

    Înregistrarea aplicației Microsoft reprezintă configurația clientului OAuth 2.0 înregistrată în portalul Microsoft Azure (Entra ID) pentru integrare. Cisco AI Assistant

    Această înregistrare definește permisiunile delegate specifice necesare în timpul fluxului de autorizare a contului Microsoft:

    • Read.All și Sites.Read.All: necesar pentru a accesa conținutul SharePoint și OneDrive.

    • ExternalItem.READ.ALL: necesar pentru a accesa conținutul Copilot Connectors.

    Cisco AI Assistantutilizează această înregistrare pentru a localiza setările corecte OAuth pentru conectare și achiziție de jet oane înainte de a invoca API-ul Microsoft 365 Copilot Retrieval. Pentru mai multe informații, consultați „Înregistr Cisco AI Assistant are în Microsoft Azure”.

  • Tokenuri Microsoft OAuth:

    Jetoanele Microsoft OAuth sunt jetoane de acces delegate de scurtă durată emise de Microsoft Entra ID odată ce un utilizator se conectează la contul său Microsoft prin pagina de setări a aplicației Webex și acordă permisiunile necesare.

    Cisco AI Assistantutilizează aceste jetoane pentru a apela API-ul Microsoft 365 Copilot Retrieval în numele utilizatorului . Microsoft Entra ID utilizează aceste jetoane pentru a autentifica fiecare solicitare, pentru a identifica utilizatorul și pentru a impune politicile privind controlul accesului și barierele de informații Microsoft 365, asigurându-se că este returnat numai conținutul pe care utilizatorul autentificat are voie să îl acceseze.

    Reînnoirea jetonului

    În momentul autorizării inițiale, Microsoft Entra ID emite atât un token de acces de scurtă durată (valabil aproximativ 60-90 de minute), cât și un token de reîmprospătare de lungă durată. Webex stochează în siguranță tokenul de reîmprospătare pe partea serverului, legat de identitatea Webex a utilizatorului.

    Tokenele de acces nu sunt reînnoite continuu. În schimb, atunci când un utilizator trimite o solicitare, Webex verifică dacă tokenul de acces curent este încă valabil. Dacă a expirat, Webex schimbă în mod discret simbolul de reîmprospătare pentru un nou token de acces. Valabilitatea jetonului de actualizare este prelungită de fiecare dată când este utilizat, permițând sesiunii să rămână activă fără intervenția utilizatorului, atâta timp cât funcția este în uz regulat.

    Încheierea sesiunii

    Sesiunea este încheiată și re-autentificarea este necesară în următoarele condiții:

    • Inactivitate: utilizatorul nu a utilizat caracteristica pentru o perioadă lungă de timp (de obicei 90 de zile, în funcție de politica implicită Microsoft Entra ID și de configurația chiriașului clientului).

    • Deconectare manuală: Utilizatorul deconectează în mod explicit contul Microsoft de la setările aplicației Webex.

    • Administrativ: un administrator Microsoft 365 revocă accesul aplicației în Entra ID.

    • Modificări de configurare: Domeniile de permisiune acordate sunt modificate sau înregistrarea aplicației este modificată.

    Pentru mai multe informații, consultați „Autorizarea contului Microsoft în aplicația Webex”.

  • Text prompt:

    Textul prompt se referă la intrarea în limba naturală introdusă de un utilizator în cadrulCisco AI Assistant, cum ar fi o solicitare de a găsi starea unui proiect sau de a localiza un document în contul său Microsoft. Acest text este generat de utilizator în timpul rulării.

    Procesarea fluxului de lucru

    Când este trimisă o solicitare, Cisco AI Assistant urmați acești pași pentru a prelua și prezenta informații:

    • Interpretare și optimizare: Asistentul interpretează promptul, efectuează raționamentul și execută rescrierea interogării pentru a produce un șir de interogare optimizat.

    • Invocare API: Asistentul invocă API-ul Microsoft 365 Copilot Retrieval împotriva uneia sau mai multor surse de date.

    • Filtrare: Dacă este cazul, expresiile de filtrare a limbajului de interogare a cuvintelor cheie (KQL) sunt aplicate pentru a extinde recuperarea la anumite site-uri, biblioteci de documente, tipuri de fișiere sau intervale de date.

    • Rearanking și sinteză: Asistentul analiz ează din nou și filtrează bucățile de text returnate. Apoi generează un răspuns final care combină promptul original cu conținutul recuperat, inclusiv citări înapoi la documentele sursă.

  • Con@@ ținut SharePoint și OneDrive: Conținutul SharePoint și OneDrive este autorizat pentru datele Microsoft 365 preluate prin API-ul Microsoft 365 Copilot Retrieval pentru a răspunde unei solicitări de utilizator. API-ul de recuperare extrage bucăți de text relevante direct din indexul de conținut hibrid Microsoft 365 fără duplicarea, exportul sau indexarea separată a datelor.

    Tipuri de fișiere acceptate: .docx, .pptx, .pdf, .aspx și.one; conținutul non-textual, cum ar fi imaginile și diagramele, nu este acceptat.

    Tot conținutul este preluat în limita de încredere Microsoft 365 și este strict limitat la fișierele și documentele pe care utilizatorul autentificat este autorizat să le acceseze în conformitate cu modelul de permisi uni Microsoft 365.

    • Solicit are: Cisco AI Assistant trimite o solicitare HTTPS POST la https://graph.microsoft.com/v1.0/copilot/retrieval, purtând jetonul de acces delegat Microsoft Entra ID în antetul Autorizare. Corpul de solicitare conține:

      • QueryString — interogarea rescrisă în limbaj natural derivată din promptul utilizatorului (maxim 1.500 de caractere).

      • DataSource — setat la SharePoint sau OneDrive (câte unul pentru fiecare solicitare; se efectuează apeluri separate pentru fiecare sursă).

      • FilterExpression (opțional) —Expresie KQL pentru domeniu în funcție de adresa URL a site-ului, cale, tip fișier sau interval de date.

      • MaximumNumberOfResults—plafonat la 25 pe apel.

    • Răspun s: Microsoft 365 procesează cererea în limita sa de încredere și returnează o matrice RetrievalHits, fiecare intrare conținând:

      • ContentChunk — un fragment de text extras din indexul de conținut

      • RelevanțăScorul de similaritate Core-cosinus între interogare și bucată, normalizat la un interval de 0—1

      • resursă — metadate sursă, inclusiv numele fișierului, adresa URL, autorul și data ultimei modificări

    • Manipularea datelor: nu se transferă conținut complet de fișier - sunt returnate numai bucăți de text pre-extrase din indexul hibrid Microsoft 365. Cisco AI Assistanttrece aceste bucăți tranzitoriu la LLM-ul său pentru reanalizare, filtrare și generare de răspunsuri. Metadatele sursă sunt utilizate pentru a construi citări în răspunsul final. Bucățile de text nu sunt stocate de Webex dincolo de durata solicitării.

  • Con@@ ținutul conectorilor Copilot: Con ținutul Copilot Connectors este date de la terți sau de întreprindere personalizate ingerate în indexul de conținut Microsoft 365 prin conectorii Microsoft Graph și care pot fi recuperate prin API-ul Microsoft 365 Copilot Retrieval. Tot conținutul returnat este limitat la elementele pe care utilizatorul autentificat este autorizat să le acceseze sub permisiunile configurate ale conectorului în Microsoft 365.

    • Solicit are: Cisco AI Assistant trimite o solicitare HTTPS POST la https://graph.microsoft.com/v1.0/copilot/retrieval, purtând jetonul de acces delegat Microsoft Entra ID în antetul Autorizare. Corpul de solicitare conține:

      • QueryString — interogarea rescrisă în limbaj natural derivată din promptul utilizatorului (maxim 1.500 de caractere).

      • Sursă de date — setați la CoPilotConnectors.

      • FilterExpression (opțional) —Expresie KQL pentru recuperarea domeniului de aplicare la surse de con ector specifice sau tipuri de conținut.

      • MaximumNumberOfResults—plafonat la 25 pe apel.

    • Răspuns: Microsoft 365 procesează cererea în limita sa de încredere și returnează o matrice RetrievalHits, fiecare intrare conținând:

      • ContentChunk — un fragment de text extras din conținutul de la terți indexat.

        RelevanțăScorul de similaritate Core—cosinus între interogare și bucată, normalizat la un interval de 0—1. Rețineți că este posibil ca scorul de relevanță să nu fie prezent pentru toate rezultatele Copilot Connector.

        resursă — metadate sursă, inclusiv numele elementului, adresa URL și atributele definite de conector.

  • Manipularea datelor: nu se transferă conținut sursă completă - sunt returnate numai bucăți de text pre-extrase din indexul de conținut Microsoft 365. Deoarece API-ul de recuperare vizează o sursă de date pentru fiecare apel, Cisco AI Assistant emite apeluri separate de recuperare pentru conectorii SharePoint, OneDrive și Copilot și îmbină rezultatele în timpul et apei de reanalizare.

    Bucățile de text sunt transmise tranzitoriu către LLM pentru reanalizare, filtrare și generare de răspunsuri și nu sunt stocate de Webex dincolo de durata solicitării.

Autentificare și autorizare

Webex interacționează cu conturile și conținutul dvs. Microsoft utilizând API-ul Microsoft Retrieval, care este autentificat și gestionat de furnizorul de identitate Microsoft (IdP). Toată comunicarea cu Microsoft IdP și API-ul de recuperare este protejată de conexiuni securizate prin TLS.

Autentificarea serviciului Webex

Cisco AI Assistantîn aplicația Webex utilizează fluxuri standard OAuth 2.0 pentru a interacționa cu serviciile Webex:

  • Furniz@@ or de identitate: Serviciul de identitate Webex acționează ca IdP din cloud pentru autentificarea utilizatorilor și autorizarea accesului API.

  • Tokenuri la purtător: Solicitările către API-urile Webex sunt autorizate utilizând jetoane la purtător emise de Serviciul de identitate Webex.

  • Comunicare securizată: Toate schimburile de date între WebexAI Assistant, Serviciul de identitate Webex și API-urile Webex se efectuează prin conexiuni securizate prin TLS.

Cerințe administrative

Pentru a activa această integrare, administratorii trebuie să parcurgă următorii pași:

  1. Configurare Microsoft 365: Administratorii trebuie să atribuie licen țele Microsoft Copilot corespunzătoare utilizatorilor relevanți.

  2. Configurare Webex: Administratorii pot activa sau dezactiva caracteristica la nivel de organizație, utilizator sau șablon direct în Control Hub.

Permisiuni consimțite de utilizator

În timpul configurării, sunt solicitate următoarele permisiuni:

Este necesară permisiunea Scop
Aplicația Webex Conectați-vă și citiți profilul utilizatorului Conectați-vă la aplicația Webex cu contul dvs.
Autorizați și conectați-vă la contul dvs. Microsoft Validați și autorizați aplicația Webex să se conecteze la contul dvs. Microsoft.

Aceste permisiuni sunt utilizate numai în timpul procesului de configurare și nu sunt stocate.

Permisiuni de serviciu

Nu este necesară permisiunea specifică de serviciu. Administratorii pot gestiona caracteristica și setările din Control Hub cu detaliile secțiunii de mai jos.

Setările și configurațiile aplicației Webex

Utilizatorii se pot conecta la aplicația Webex și se pot autoriza să conecteze contul Microsoft după ce administratorul activează funcția cu autorizare utilizând Control Hub

Pentru mai multe informații, consultați Accesarea datelor Microsoft cu Cisco AI Assistant

A fost util acest articol?
A fost util acest articol?