- Home
- /
- Articolo
L'integrazione con Microsoft Copilot consente agli utenti delle riunioni di Webex di connettersi in modo sicuro con i propri account Microsoft Copilot come una delle loro fonti di dati.
Riepilogo
Cisco AI AssistantSfruttando l'app Webex, gli utenti possono cercare, analizzare e riepilogare i risultati da fonti di dati Microsoft, tra cui SharePoint, OneDrive e Copilot Connectors.
Panoramica dell'architettura
La connessione a Microsoft Copilot Le consente di interagire con le origini dati Microsoft utilizzando le API Microsoft Retrieval. Quando usa ilCisco AI Assistant, recupera i dati dalle sue fonti Microsoft in tempo reale.
Webex non memorizza né conserva i dati che Le vengono restituiti tramite. Cisco AI Assistant I dati vengono utilizzati solo al momento per generare la sua risposta, garantendo che la sua privacy rimanga protetta.
Fasi dettagliate del flusso di dati
Gestione e assegnazione degli utenti
Gli amministratori possono gestire gli utenti con licenze Microsoft Copilot e attivare o disattivare la funzionalità a livello di organizzazione, utente o modello utilizzando Control Hub.
Autorizzazione e connessione dell'utente
-
L'utente accede all'app Webex
-
L'utente accede alla pagina Impostazioni per connettere il proprio account Microsoft.
L'utente completa il processo di autorizzazione e seleziona a quali fonti (SharePoint, OneDrive o Copilot Connector) accedere.
Flusso di lavoro di domande e risposte
L'utente fa una domanda, ad esempio: qual è lo stato del progetto ABC?
I seguenti passaggi verranno eseguiti utilizzando più passaggi secondari da Webex Meeting Service:
-
Decrittografa: il sistema decrittografa la richiesta.
-
Carica contesto: viene caricato il contesto pertinente.
-
Ragionamento LLM: LLM riscrive la domanda per un recupero ottimale.
-
Recupera informazioni sull'integrazione: il sistema recupera la configurazione e i token per la ricerca su più percorsi.
-
Ricerca multipercorso: il sistema esegue il recupero tra gli strumenti Microsoft supportati.
-
Ricerca: gli strumenti di recupero multipercorso cercano contenuti dettagliati.
-
Restituisce il risultato della ricerca: gli strumenti di recupero multipercorso restituiscono i risultati della ricerca.
-
-
Reranking e filtraggio: il servizio per riunioni Webex utilizza l'LLM per riclassificare e filtrare i contenuti in base alla pertinenza.
-
Generazione: LLM genera una risposta finale con citazioni.
-
Risposta: invia una risposta definitiva all'app Webex.
Trattamento dei dati
Trattamento dei dati
Questa funzionalità utilizza le seguenti informazioni di configurazione dei dati e del servizio per gestire l'autorizzazione, recuperare contenuti Microsoft 365 autorizzati e fornire risposte nell'app Webex:
-
Registrazione dell'applicazione Microsoft:
La Microsoft Application Registration rappresenta la configurazione del client OAuth 2.0 registrata nel portale Microsoft Azure (Entra ID) per l'integrazione. Cisco AI Assistant
Questa registrazione definisce le autorizzazioni delegate specifiche richieste durante il flusso di autorizzazione dell'account Microsoft:
-
Read.All e Sites.Read.All: necessari per accedere ai contenuti di SharePoint e OneDrive.
-
ExternalItem.read.all: necessario per accedere ai contenuti di Copilot Connectors.
Cisco AI Assistantutilizza questa registrazione per individuare le impostazioni OAuth corrette per l' accesso e l'acquisizione dei token prima di richiamare l'API Microsoft 365 Copilot Retrieval. Per ulteriori informazioni, vedere «Registrazione Cisco AI Assistant in Microsoft Azure».
-
-
Token Microsoft OAuth:
I token Microsoft OAuth sono token di accesso delegato di breve durata emessi da Microsoft Entra ID una volta che un utente accede al proprio account Microsoft tramite la pagina delle impostazioni dell'app Webex e concede le autorizzazioni necessarie.
Cisco AI Assistantutilizza questi token per chiamare l'API Microsoft 365 Copilot Retrieval per conto dell'utente. Microsoft Entra ID utilizza questi token per autenticare ogni richiesta, identificare l' utente e applicare le politiche di controllo degli accessi e barriera informativa di Microsoft 365, assicurando che vengano restituiti solo i contenuti a cui l'utente che ha effettuato l'accesso è autorizzato ad accedere.
Rinnovo del token
Al momento dell'autorizzazione iniziale, Microsoft Entra ID emette sia un token di accesso di breve durata (valido per circa 60-90 minuti) sia un token di aggiornamento a lunga durata. Webex archivia in modo sicuro il token di aggiornamento lato server, associato all'identità Webex dell'utente.
I token di accesso non vengono rinnovati continuamente. Invece, quando un utente invia una richiesta, Webex verifica se il token di accesso corrente è ancora valido. Se è scaduto, Webexsilently scambia il token di aggiornamento con un nuovo token di accesso. La validità del token di aggiornamento viene estesa ogni volta che viene utilizzato, consentendo alla sessione di rimanere attiva senza l'intervento dell'utente fintanto che la funzione viene utilizzata regolarmente.
Interruzione della sessione
La sessione è terminata ed è richiesta la riautenticazione nelle seguenti condizioni:
-
Inattività: l'utente non utilizza la funzione per un periodo prolungato (in genere 90 giorni, a seconda della politica predefinita dell'ID Microsoft Entra e della configurazione del tenant del cliente).
-
Disconnessione manuale: L'utente disconnette esplicitamente il proprio account Microsoft dalle impostazioni dell'app Webex.
-
Amministrativo: Un amministratore di Microsoft 365 revoca l' accesso all'applicazione in Entra ID.
-
Modifiche alla configurazione: gli ambiti di autorizzazione concessi vengono modificati o la registrazione dell'applicazione viene modificata.
Per ulteriori informazioni, vedere «Autorizzazione dell'account Microsoft nell'app Webex».
-
-
Testo richiesto:
Il testo del prompt si riferisce all'input in linguaggio naturale inserito da un utente all'interno diCisco AI Assistant, ad esempio una richiesta di trovare lo stato di un progetto o di individuare un documento nel proprio account Microsoft. Questo testo viene generato dall'utente in fase di esecuzione.
Flusso di lavoro di elaborazione
Quando viene inviata una richiesta, Cisco AI Assistant segua questi passaggi per recuperare e presentare le informazioni:
-
Interpretazione e ottimizzazione: L'assistente interpreta il prompt, esegue il ragionamento ed esegue la riscrittura delle query per produrre una stringa di query ottimizzata.
-
Richiamo API: L'assistente richiama l' API Microsoft 365 Copilot Retrieval su una o più origini dati.
-
Filtro: ove applicabile, le espressioni di filtro Keyword Query Language (KQL) vengono applicate per definire l'ambito del recupero a siti, librerie di documenti, tipi di file o intervalli di date specifici.
-
Riclassificazione e sintesi: L'assistente riclassifica e filtra i blocchi di testo restituiti. Quindi genera una risposta finale che combina la richiesta originale con il contenuto recuperato, comprese le citazioni ai documenti di origine.
-
-
Contenuti SharePoint e OneDrive: i contenuti di SharePoint e OneDrive sono dati Microsoft 365 autorizzati recuperati tramite l'API Microsoft 365 Copilot Retrieval per rispondere a una richiesta dell'utente. L'API Retrieval estrae parti di testo pertinenti direttamente dall'indice dei contenuti ibridi di Microsoft 365 senza duplicare, esportare o indicizzare separatamente alcun dato.
Tipi di file supportati: .docx, .pptx, .pdf, .aspx e .one; i contenuti non testuali come immagini e grafici non sono supportati.
Tutti i contenuti vengono recuperati entro i limiti di fiducia di Microsoft 365 e sono strettamente limitati ai file e ai documenti a cui l'utente che ha effettuato l'accesso è autorizzato ad accedere in base al modello di autorizzazioni di Microsoft 365.
-
Richiesta: Cisco AI Assistant invia una richiesta HTTPS POST a https://graph.microsoft.com/v1.0/copilot/retrieval, con il token di accesso delegato Microsoft Entra ID nell'intestazione di autorizzazione. Il corpo della richiesta contiene:
-
queryString: la query riscritta in linguaggio naturale derivata dal prompt dell'utente (massimo 1.500 caratteri).
-
Fonte dati: impostata su SharePoint o OneDrive (una per richiesta; vengono effettuate chiamate separate per ogni fonte).
-
FilterExpression (opzionale): espressione KQL per l'ambito per URL del sito, percorso, tipo di file o intervallo di date.
-
Numero massimo di risultati: massimo 25 per chiamata.
-
-
Risposta: Microsoft 365 elabora la richiesta entro i limiti di attendibilità e restituisce un array RetrievalHits, con ogni voce contenente:
-
contentChunk: un frammento di testo estratto dall'indice dei contenuti
-
RelevanceScore: punteggio di somiglianza del coseno tra la query e il blocco, normalizzato in un intervallo 0-1
-
risorsa: metadati di origine tra cui nome del file, URL, autore e data dell'ultima modifica
-
-
Gestione dei dati: non viene trasferito alcun contenuto completo del file: vengono restituiti solo blocchi di testo preestratti dall'indice ibrido di Microsoft 365. Cisco AI Assistantpassa queste parti temporaneamente al suo LLM per il riposizionamento, il filtraggio e la generazione di risposte. I metadati della fonte vengono utilizzati per creare citazioni nella risposta finale. I blocchi di testo non vengono archiviati da Webex oltre la durata della richiesta.
-
-
Contenuto di Copilot Connectors: i contenuti di Copilot Connectors sono dati aziendali personalizzati o di terze parti inseriti nell'indice dei contenuti di Microsoft 365 tramite connettori Microsoft Graph e resi recuperabili tramite l'API Microsoft 365 Copilot Retrieval. Tutti i contenuti restituiti sono limitati agli elementi a cui l'utente che ha effettuato l'accesso è autorizzato ad accedere in base alle autorizzazioni configurate del connettore in Microsoft 365.
-
Richiesta: Cisco AI Assistant invia una richiesta HTTPS POST a https://graph.microsoft.com/v1.0/copilot/retrieval, con il token di accesso delegato Microsoft Entra ID nell'intestazione di autorizzazione. Il corpo della richiesta contiene:
-
queryString: la query riscritta in linguaggio naturale derivata dal prompt dell'utente (massimo 1.500 caratteri).
-
Fonte dati: impostata su Copilot Connectors.
-
FilterExpression (opzionale): espressione KQL per il recupero dell'ambito su sorgenti di connettori o tipi di contenuto specifici.
-
Numero massimo di risultati: massimo 25 per chiamata.
-
-
Risposta: Microsoft 365 elabora la richiesta entro i limiti di attendibilità e restituisce un array RetrievalHits, ogni voce contenente:
-
ContentChunk: un frammento di testo estratto dai contenuti indicizzati di terze parti.
RelevanceScore: punteggio di somiglianza del coseno tra la query e il blocco, normalizzato su un intervallo 0-1. Si noti che il punteggio di pertinenza potrebbe non essere presente per tutti i risultati di Copilot Connector.
metadati della risorsa, inclusi il nome dell'articolo, l'URL e gli attributi definiti dal connettore.
-
-
-
Gestione dei dati: non viene trasferito alcun contenuto sorgente completo: vengono restituiti solo blocchi di testo preestratti dall'indice dei contenuti di Microsoft 365. Perché l'API Retrieval si rivolge a un'origine dati per chiamata, Cisco AI Assistant emette chiamate di recupero separate per SharePoint, OneDrive e Copilot Connectors e unisce i risultati durante la fase di riclassificazione.
I blocchi di testo vengono trasmessi temporaneamente al LLM per il riposizionamento, il filtraggio e la generazione di risposte e non vengono archiviati da Webex oltre la durata della richiesta.
Autenticazione e autorizzazione
Webex interagisce con i suoi account e contenuti Microsoft utilizzando l'API Microsoft Retrieval, che è autenticata e gestita dal Microsoft identity provider (IdP). Tutte le comunicazioni con Microsoft IdP e l'API Retrieval sono protette da connessioni protette da TLS.
Autenticazione del servizio Webex
Cisco AI Assistantnell'app Webex utilizza flussi OAuth 2.0 standard per interagire con i servizi Webex:
-
Identity Provider: Il Webex Identity Service funge da IdP basato sul cloud per autenticare gli utenti e autorizzare l'accesso alle API.
-
Token al portatore: le richieste alle API Webex sono autorizzate utilizzando token al portatore emessi dal Webex Identity Service.
-
Comunicazione sicura: tutto lo scambio di dati tra WebexAI Assistant, Webex Identity Service e le API Webex avviene tramite connessioni protette da TLS.
Requisiti amministrativi
Per abilitare questa integrazione, gli amministratori devono completare i seguenti passaggi:
-
Configurazione Microsoft 365: gli amministratori devono assegnare le licenze Microsoft Copilot appropriate agli utenti pertinenti.
-
Configurazione Webex: gli amministratori possono abilitare o disabilitare la funzionalità a livello di organizzazione, utente o modello direttamente in Control Hub.
Autorizzazioni autorizzate dall'utente
Durante la configurazione, sono richieste le seguenti autorizzazioni:
| Autorizzazione richiesta | Scopo |
|---|---|
| App Webex Accedi e leggi il profilo utente | Accedi all'app Webex con il suo account. |
| Autorizzi e acceda al suo account Microsoft | Convalida e autorizza l'app Webex a connettersi al suo account Microsoft. |
Queste autorizzazioni vengono utilizzate solo durante il processo di configurazione e non vengono memorizzate.
Autorizzazioni di servizio
NON è necessaria un'autorizzazione specifica per il servizio. Gli amministratori possono gestire la funzionalità e le impostazioni in Control Hub con i dettagli della sezione seguente.
Gestione e autorizzazione delle funzionalità di integrazione di Copilot in Control Hub
Gli amministratori possono attivare o disattivare la funzionalità per la loro organizzazione oppure possono decidere quale o più fonti possono essere concesse con le caselle di controllo.
Per ulteriori informazioni, vedere Configurare le integrazioni AI in Control Hub e Attivare o disattivare le fonti di Cisco AI Assistant ricerca nell'app Webex
Impostazioni e configurazioni dell'app Webex
Gli utenti possono accedere all'app Webex e autorizzare la connessione dell'account Microsoft dopo che l'amministratore ha attivato la funzionalità con autorizzazione utilizzando Control Hub
Per ulteriori informazioni, veda Accedere ai suoi dati Microsoft con Cisco AI Assistant