Neste artigo
Resumo
Visão geral da arquitetura
Tratamento de dados
dropdown icon
Autenticação e autorização
    Permissões consentidas pelo usuário
    Permissões de serviço
Gerenciamento e autorização de recursos de integração do Copilot no Control Hub
Configurações e configurações do aplicativo Webex
Material de referência adicional
Permitir que AI Assistant pesquise fontes de dados externas da Microsoft
list-menuNeste artigo
list-menuComentários?

A integração com o Microsoft Copilot permite que os usuários do Webex Meeting se conectem com segurança às suas contas do Microsoft Copilot como uma de suas fontes de dados.

Resumo

Ao aproveitar o Cisco AI Assistant aplicativo Webex, os usuários podem pesquisar, analisar e resumir os resultados das fontes de dados da Microsoft, incluindo conectores SharePoint, OneDrive e Copilot.

Visão geral da arquitetura

A conexão com o Microsoft Copilot permite que você interaja com fontes de dados da Microsoft usando APIs de recuperação da Microsoft. Quando você usa oCisco AI Assistant, ele recupera dados de suas fontes da Microsoft em tempo real.

O Webex não armazena nem retém os dados retornados a você via. Cisco AI Assistant Os dados são usados somente no momento para gerar sua resposta, garantindo que sua privacidade permaneça protegida.

Architecture overview for how Webex AI Assistant uses Microsoft data

Etapas detalhadas do fluxo de dados

Gerenciamento e atribuição de usuários

Os administradores podem gerenciar usuários que têm licenças do Microsoft Copilot e ativar ou desativar o recurso em nível de organização, usuário ou modelo usando o Control Hub.

Autorização e conexão do usuário

  1. O usuário faz login no aplicativo Webex

  2. O usuário navega até a página Configurações para conectar sua conta da Microsoft.

O usuário conclui o processo de autorização e seleciona quais fontes (SharePoint, OneDrive ou Copilot Connector) acessar.

Fluxo de trabalho de perguntas e respostas

O usuário faz uma pergunta, por exemplo: qual é o status do projeto ABC?

As etapas a seguir serão executadas usando várias subetapas pelo Webex Meeting Service:

  1. Descriptografar: o sistema descriptografa a solicitação.

  2. Contexto de carregamento: o contexto relevante é carregado.

  3. Raciocínio LLM: O LLM reescreve a pergunta para uma recuperação ideal.

  4. Buscar informações de integração: o sistema recupera configurações e tokens para pesquisa em vários caminhos.

  5. Pesquisa em vários caminhos: o sistema executa a recuperação em todas as ferramentas compatíveis da Microsoft.

    • Pesquisa: ferramentas de recuperação de vários caminhos pesquisam conteúdo detalhado.

    • Retornar resultado da pesquisa: ferramentas de recuperação de vários caminhos retornam o resultado da pesquisa.

  6. Reclassificação e filtragem: o serviço de reunião Webex usa o LLM para reclassificar e filtrar o conteúdo por relevância.

  7. Geração: O LLM gera uma resposta final com citações.

  8. Resposta: publique a resposta final no aplicativo Webex.

Tratamento de dados

Tratamento de dados

Esse recurso usa as seguintes informações de configuração de dados e serviços para gerenciar a autorização, recuperar conteúdo autorizado do Microsoft 365 e fornecer respostas no aplicativo Webex:

  • Registro de aplicativos da Microsoft:

    O Microsoft Application Registration representa a configuração do cliente OAuth 2.0 registrada no portal do Microsoft Azure (Entra ID) para a Cisco AI Assistant integração.

    Esse registro define as permissões delegadas específicas necessárias durante o fluxo de autorização da conta Microsoft:

    • Read.All e Sites.Read.All: necessários para acessar o conteúdo do SharePoint e do OneDrive.

    • ExternalItem.READ.ALL: necessário para acessar o conteúdo dos conectores Copilot.

    Cisco AI Assistantusa esse registro para localizar as configurações corretas do OAuth para login e aquisição de token antes de invocar a API Microsoft 365 Copilot Retrieval. Para obter mais informações, consulte “Registrar-se Cisco AI Assistant no Microsoft Azure”.

  • Tokens OAuth da Microsoft:

    Os tokens Microsoft OAuth são tokens de acesso delegado de curta duração emitidos pelo Microsoft Entra ID quando um usuário entra em sua conta da Microsoft por meio da página de configurações do aplicativo Webex e concede as permissões necessárias.

    Cisco AI Assistantusa esses tokens para chamar a API Microsoft 365 Copilot Retrieval em nome do usuário. O Microsoft Entra ID usa esses tokens para autenticar cada solicitação, identificar o usuário e aplicar as políticas de controle de acesso e barreira de informações do Microsoft 365, garantindo que somente o conteúdo que o usuário conectado tenha permissão para acessar seja retornado.

    Renovação de token

    No momento da autorização inicial, o Microsoft Entra ID emite um token de acesso de curta duração (válido por aproximadamente 60 a 90 minutos) e um token de atualização de longa duração. O Webex armazena com segurança o token de atualização do lado do servidor, vinculado à identidade Webex do usuário.

    Os tokens de acesso não são renovados continuamente. Em vez disso, quando um usuário envia uma solicitação, o Webex verifica se o token de acesso atual ainda é válido. Se ele tiver expirado, o Webexsilenciosamente troca o token de atualização por um novo token de acesso. A validade do token de atualização é estendida toda vez que ele é usado, permitindo que a sessão permaneça ativa sem a intervenção do usuário, desde que o recurso esteja em uso regular.

    Término da sessão

    A sessão é encerrada e a reautenticação é necessária nas seguintes condições:

    • Inatividade: o usuário não usa o recurso há um longo período (normalmente 90 dias, dependendo da política padrão do Microsoft Entra ID e da configuração do locatário do cliente).

    • Desconexão manual: O usuário desconecta explicitamente sua conta da Microsoft das configurações do aplicativo Webex.

    • Administrativo: um administrador do Microsoft 365 revoga o acesso do aplicativo no Entra ID.

    • Alterações de configuração: os escopos de permissão concedidos são modificados ou o registro do aplicativo é alterado.

    Para obter mais informações, consulte “Autorização de conta da Microsoft no aplicativo Webex”.

  • Texto de aviso:

    O texto de solicitação se refere à entrada em idioma natural inserida por um usuário noCisco AI Assistant, como uma solicitação para encontrar o status de um projeto ou localizar um documento em sua conta da Microsoft. Esse texto é gerado pelo usuário em tempo de execução.

    fluxo de trabalho de processamento

    Quando uma solicitação é enviada, Cisco AI Assistant siga estas etapas para recuperar e apresentar informações:

    • Interpretação e otimização: o assistente interpreta o prompt, executa o raciocínio e executa a reescrita da consulta para produzir uma string de consulta otimizada.

    • Invocação de API: o assistente invoca a API Microsoft 365 Copilot Retrieval em uma ou mais fontes de dados.

    • Filtragem: quando aplicável, as expressões de filtro Keyword Query Language (KQL) são aplicadas para definir o escopo da recuperação em sites, bibliotecas de documentos, tipos de arquivo ou intervalos de datas específicos.

    • Reclassificação e síntese: o assistente classifica novamente e filtra os trechos de texto retornados. Em seguida, ele gera uma resposta final que combina a solicitação original com o conteúdo recuperado, incluindo citações dos documentos de origem.

  • Conteúdo do SharePoint e do OneDrive: o conteúdo do SharePoint e do OneDrive são dados autorizados do Microsoft 365 recuperados por meio da API de recuperação do Microsoft 365 Copilot para responder a uma solicitação do usuário. A API de recuperação extrai partes de texto relevantes diretamente do índice de conteúdo híbrido do Microsoft 365 sem duplicar, exportar ou indexar separadamente quaisquer dados.

    Tipos de arquivo compatíveis: .docx, .pptx, .pdf, .aspx e.one; conteúdo não textual, como imagens e gráficos, não é suportado.

    Todo o conteúdo é recuperado dentro do limite de confiança do Microsoft 365 e é estritamente limitado aos arquivos e documentos que o usuário conectado está autorizado a acessar de acordo com o modelo de permissões do Microsoft 365.

    • Solicitação: Cisco AI Assistant envia uma solicitação HTTPS POST para https://graph.microsoft.com/v1.0/copilot/retrieval, carregando o token de acesso delegado Microsoft Entra ID no cabeçalho de Autorização. O corpo da solicitação contém:

      • queryString — A consulta de linguagem natural reescrita derivada do prompt do usuário (máximo de 1.500 caracteres).

      • Fonte de dados — definida como SharePoint ou OneDrive (uma por solicitação; chamadas separadas são feitas para cada fonte).

      • FilterExpression (opcional) — expressão KQL para definir o escopo por URL do site, caminho, tipo de arquivo ou intervalo de datas.

      • Número máximo de resultados — limitado a 25 por chamada.

    • Resposta: O Microsoft 365 processa a solicitação dentro de seu limite de confiança e retorna uma matriz retrievalHits, com cada entrada contendo:

      • contentChunk—um trecho de texto extraído do índice de conteúdo

      • relevanceScore — pontuação de similaridade de cosseno entre a consulta e o fragmento, normalizada para um intervalo de 0 a 1

      • recurso—metadados de origem, incluindo nome do arquivo, URL, autor e data da última modificação

    • Tratamento de dados: nenhum conteúdo completo do arquivo é transferido — somente trechos de texto pré-extraídos do índice híbrido Microsoft 365 são retornados. Cisco AI Assistantpassa esses fragmentos transitoriamente para seu LLM para reclassificação, filtragem e geração de respostas. Os metadados de origem são usados para construir citações na resposta final. Os pedaços de texto não são armazenados pelo Webex além da duração da solicitação.

  • Conteúdo dos conectores Copilot: o conteúdo dos conectores Copilot são dados corporativos personalizados ou de terceiros ingeridos no índice de conteúdo do Microsoft 365 por meio dos conectores do Microsoft Graph e recuperáveis por meio da API de recuperação do Copilot do Microsoft 365. Todo o conteúdo devolvido é limitado aos itens que o usuário conectado está autorizado a acessar sob as permissões configuradas do conector no Microsoft 365.

    • Solicitação: Cisco AI Assistant envia uma solicitação HTTPS POST para https://graph.microsoft.com/v1.0/copilot/retrieval, carregando o token de acesso delegado Microsoft Entra ID no cabeçalho de Autorização. O corpo da solicitação contém:

      • queryString — A consulta de linguagem natural reescrita derivada do prompt do usuário (máximo de 1.500 caracteres).

      • Fonte de dados — Definido como CopilotConnectors.

      • FilterExpression (opcional) — expressão KQL para definir o escopo da recuperação para fontes de conectores ou tipos de conteúdo específicos.

      • Número máximo de resultados — limitado a 25 por chamada.

    • Resposta: O Microsoft 365 processa a solicitação dentro de seu limite de confiança e retorna uma matriz retrievalHits, cada entrada contendo:

      • contentChunk—um trecho de texto extraído do conteúdo indexado de terceiros.

        relevanceScore — Pontuação de similaridade de cosseno entre a consulta e o fragmento, normalizada para um intervalo de 0 a 1. Observe que a pontuação de relevância pode não estar presente em todos os resultados do Copilot Connector.

        recurso—metadados de origem, incluindo nome do item, URL e atributos definidos pelo conector.

  • Tratamento de dados: nenhum conteúdo de origem completo é transferido — somente trechos de texto pré-extraídos do índice de conteúdo do Microsoft 365 são retornados. Como a API de recuperação tem como alvo uma fonte de dados por chamada, Cisco AI Assistant emite chamadas de recuperação separadas para conectores do SharePoint, OneDrive e Copilot e mescla os resultados durante a etapa de reclassificação.

    Os pedaços de texto são passados transitoriamente para o LLM para reclassificação, filtragem e geração de respostas, e não são armazenados pelo Webex além da duração da solicitação.

Autenticação e autorização

O Webex interage com suas contas e conteúdo da Microsoft usando a API de recuperação da Microsoft, que é autenticada e gerenciada pelo provedor de identidade (IdP) da Microsoft. Toda comunicação com o Microsoft IdP e a API de recuperação é protegida por conexões protegidas por TLS.

Autenticação do serviço Webex

Cisco AI Assistantno aplicativo Webex utiliza fluxos padrão do OAuth 2.0 para interagir com os serviços Webex:

  • Provedor de identidade: O Webex Identity Service atua como o IdP baseado em nuvem para autenticar usuários e autorizar o acesso à API.

  • Tokens portadores: as solicitações às APIs Webex são autorizadas usando tokens portadores emitidos pelo Webex Identity Service.

  • Comunicação segura: toda a troca de dados entre o WebexAI Assistant, o Webex Identity Service e as APIs Webex é conduzida por meio de conexões protegidas por TLS.

Requisitos administrativos

Para habilitar essa integração, os administradores devem concluir as seguintes etapas:

  1. Configuração do Microsoft 365: os administradores devem atribuir as licenças apropriadas do Microsoft Copilot aos usuários relevantes.

  2. Configuração Webex: Os administradores podem ativar ou desativar o recurso no nível da organização, do usuário ou do modelo diretamente no Control Hub.

Permissões consentidas pelo usuário

Durante a configuração, as seguintes permissões são solicitadas:

Permissão necessária Propósito
Aplicativo Webex Faça login e leia o perfil do usuário Faça login no aplicativo Webex com sua conta.
Autorize e faça login na sua conta da Microsoft Valide e autorize o aplicativo Webex a se conectar à sua conta da Microsoft.

Essas permissões são usadas somente durante o processo de configuração e não são armazenadas.

Permissões de serviço

NÃO é necessária nenhuma permissão de serviço específica. Os administradores podem gerenciar o recurso e as configurações no Control Hub com os detalhes da seção abaixo.

Configurações e configurações do aplicativo Webex

Os usuários podem entrar no aplicativo Webex e autorizar a conexão com a conta da Microsoft após o administrador ativar o recurso com autorização usando o Control Hub

Para obter mais informações, consulte Acessar seus dados da Microsoft com Cisco AI Assistant

Este artigo foi útil?
Este artigo foi útil?