- Ana Sayfa
- /
- Makale
Microsoft Copilot ile entegrasyon, Webex toplantı kullanıcılarının veri kaynaklarından biri olarak Microsoft Copilot hesaplarına güvenli bir şekilde bağlanmasına olanak tanır.
Özet
Kullanıcılar, Webex App'ten yararlan Cisco AI Assistant arak SharePoint, OneDrive ve Copilot Bağlayıcıları dahil olmak üzere Microsoft veri kaynaklarından elde edilen sonuçları arayabilir, analiz edebilir ve özetleyebilir.
Mimariye genel bakış
Microsoft Copilot'a bağlanmak, Microsoft Erişim API'lerini kullanarak Microsoft veri kaynaklarıyla etkileşim kurmanıza olanak tanır. KullandığınızdaCisco AI Assistant, Microsoft kaynaklarınızdan verileri gerçek zamanlı olarak alır.
Webex, size gönderilen verileri saklamaz veya saklamaz. Cisco AI Assistant Veriler yalnızca şu anda yanıtınızı oluşturmak için kullanılır ve gizliliğinizin korun masını sağlar.
Ayrıntılı Veri Akışı Adımları
Kullanıcı yönetimi ve atama
Yöneticiler, Microsoft Copilot lisanslarına sahip kullanıcıları yönetebilir ve Denetim Merkezi'ni kullanarak kuruluş, kullanıcı veya şablon düzeyinde özelliği açıp kapatabilir.
Kullanıcı yetkilendirmesi ve bağlantısı
-
Kullanıcı Webex Uygulamasında oturum açar
-
Kullanıcı, Microsoft hesabını bağlamak için Ayar lar sayfasına gider.
Kullanıcı yetkilendirme işlemini tamamlar ve hangi kaynaklara (SharePoint, OneDrive veya Copilot Connector) erişileceğini seçer.
Soru-cevap iş akışı
Kullanıcı bir soru sorar, örneğin: ABC projesinin durumu nedir?
Aşağıdaki adımlar Webex Meeting Service tarafından birden çok alt adım kullanılarak yürütülecektir:
-
Şifre çözme: sistem isteğin şifresini çözer.
-
Bağlamı Yükle: ilgili bağlam yüklenir.
-
LLM Muhakeme: LLM, optimum geri alma için soruyu yeniden yazar.
-
Entegrasyon bilgilerini getir: sistem çok yollu arama için yapılandırma ve belirteçleri alır.
-
Çok yollu Arama: sistem, desteklenen Microsoft araçları arasında geri alma işlemini yürütür.
-
Arama: çok yollu geri alma araçları ayrıntılı içerik arar.
-
Arama sonucunu döndür: çok yollu geri alma araçları arama sonucunu döndürür.
-
-
Yeniden Sıralama ve Filtreleme: Webex toplantı hizmeti, içeriği alaka düzeyine göre yeniden sıralamak ve filtrelemek için LLM'yi kullanır.
-
Nesil: LLM, alıntılarla nihai bir cevap üretir.
-
Cevap: Webex Uygulamasına nihai cevabı gönderin.
Veri işleme
Veri işleme
Bu özellik, y etkilendirmeyi yönetmek, yetkili Microsoft 365 içeriğini almak ve Webex Uygulamasında yanıtlar sağlamak için aşağıdaki veri ve hizmet yapılandırma bilgilerini kullanır:
-
Microsoft Uygulama Kaydı:
Microsoft Uygulama Kaydı, entegrasyon için Microsoft Azure portalında (Entra Kimliği) kayıtlı OAuth 2.0 istemci yapılandırmasını temsil eder. Cisco AI Assistant
Bu kayıt, Microsoft hesabı yetkilendirme akışı sırasında gereken belirli devredilen izinleri tanımlar:
-
Read.All ve Sites.Read.All: SharePoint ve OneDrive içeriğine erişmek için gereklidir.
-
ExternalItem.READ.ALL: Copilot Connectors içeriğine erişmek için gereklidir.
Cisco AI AssistantMicrosoft 365 Copilot Retrieval API'sini çağırmadan önce oturum açma ve belir teç edinme için doğru OAuth ayarlarını bulmak için bu kaydı kullanır. Daha fazla bilgi için bkz. “Microsoft Azure Cisco AI Assistant 'da Kaydolma”.
-
-
Microsoft OAuth Belirteçleri:
Microsoft OAuth belirteçleri, kullanıcı Webex App ayarları sayfası aracılığıyla Microsoft hesabında oturum açtığında ve gerekli izinleri verdiğinde Microsoft Entra ID tarafından verilen kısa ömürlü, devredilmiş erişim belirteç leridir.
Cisco AI Assistantkullanıcı adına Microsoft 365 Copilot Retrieval API'sini çağırmak için bu belirteçleri kullanır. Microsoft Entra ID, her isteğin kimliğini doğrulamak, kullanıcıyı tanımlamak ve Microsoft 365 erişim denetimi ve bilgi bariyeri ilkelerini uygulamak için bu belirteçleri kullanır ve yalnızca oturum açmış kullanıcının erişmesine izin verilen içeriğin döndürülmesini sağlar.
Token Yenileme
İlk yetkilendirme sırasında, Microsoft Entra ID hem kısa ömürlü bir erişim belirteci (yaklaşık 60-90 dakika geçerlidir) hem de uzun ömürlü bir yenileme belirteci yayınlar. Webex, kullanıcının Webex kimliğine bağlı yenileme belirtecini sunucu tarafında güvenli bir şekilde depolar.
Erişim belirteçleri sürekli yenilenmez. Bunun yerine, bir kullanıcı bir istek gönderdiğinde, Webex geçerli erişim belirtecinin hala geçerli olup olmadığını kontrol eder. Süresi dolduysa, Webex yenileme belirtecini yeni bir erişim belirteci ile sessizce değiştirir. Yenileme belir tecinin geçerliliği her kullanıldığında uzatılır ve özellik düzenli kullanımda olduğu sürece oturumun kullanıcı müdahalesi olmadan aktif kalmasını sağlar.
Oturum Sonlandırma
Oturum sonlandırılır ve aşağıdaki koşullar altında yeniden kimlik doğrulama gereklidir:
-
Hareket@@ sizlik: Kullanıcı özelliği uzun bir süre kullanmamıştır (Microsoft Entra ID varsayılan ilkesine ve müşterinin kiracı yapılandırmasına bağlı olarak genellikle 90 gün).
-
Manuel Bağlantı Kesme: Kullanıcı Microsoft hesabının Webex App ayarlarıyla bağlantısını açıkça keser.
-
Yönetici: Bir Microsoft 365 yöneticisi, uygulamanın Entra ID'deki erişimini iptal eder.
-
Yapılandırma Değişiklikleri: Verilen izin kapsamları değiştirilir veya uygulama kaydı değiştirilir.
Daha fazla bilgi için bkz. “Webex Uygulamasında Microsoft hesabı yetkilendirmesi”.
-
-
İstek Metni:
İstek metni, bir kullanıcının içinde girdiği doğal dil girişini ifade ederCisco AI Assistant, örneğin bir projenin durumunu bulma veya Microsoft hesabındaki bir belgeyi bulma ist eği. Bu metin kullanıcı tarafından çalışma zamanında oluşturulur.
İşleme İş Akışı
Bir istem gönderildiğinde, Cisco AI Assistant bilgileri almak ve sunmak için şu adımları izleyin:
-
Yorumlama ve Optimizasyon: Asistan istemi yorumlar, akıl yürütme gerçekleştirir ve optimize edilmiş bir sorgu dizesi oluşturmak için sorgu yeniden yazmayı yürütür.
-
API Çağırma: Asistan, Microsoft 365 Copilot Retrieval API'sini bir veya daha fazla veri kaynağına karşı çağırır.
-
Filtreleme: Uygun olduğunda, Anahtar Kelime Sorgu Dili (KQL) filtre ifadeleri, belirli sitelere, belge kitaplıklarına, dosya türlerine veya tarih aralıklarına erişmeyi kapsamak için uygulanır.
-
Yeniden Sıralama ve Sentez: Asistan dön dürülen metin parçalarını yeniden değerlendirir ve filtreler. Daha sonra, kaynak belgelere geri alıntılar da dahil olmak üzere orijinal istemi alınan içerikle birleştiren nihai bir yanıt oluşturur.
-
-
SharePoint ve OneDrive İçeri ği: SharePoint ve OneDrive içeriği, bir kullanıcı isteğini yanıtlamak için Microsoft 365 Copilot Retrieval API aracılığıyla alınan Microsoft 365 verilerine yetkilidir. Erişim API'si, herhangi bir veriyi çoğaltmadan, dışa aktarmadan veya ayrı olarak dizine eklemeden doğrudan Microsoft 365 karma içerik dizininden ilgili metin parçalarını çıkarır.
Desteklenen dosya türleri: .docx, .pptx, .pdf, .aspx ve.one; görüntüler ve grafikler gibi metin dışı içerik desteklenmez.
Tüm içerik Microsoft 365 güven sınırı dahilinde alınır ve oturum açmış kullanıcının Microsoft 365'in izinler modeli kapsamında erişmeye yetkili olduğu dosya ve belgelerle kesinlikle sınırlıdır.
-
İstek: Cisco AI Assistant Yetkilendirme başlığında Microsoft Entra Kimliği devredilen erişim belirtecini taşıyan https://graph.microsoft.com/v1.0/copilot/retrieval adresine bir HTTPS POST isteği gönderir. Talep gövdesi şunları içerir:
-
QueryString—kullanıcının isteminden türetilen yeniden yazılmış doğal dil sorgusu (en fazla 1.500 karakter).
-
Veri Kaynağı—SharePoint veya OneDrive olarak ayarlayın (istek başına bir tane; her kaynak için ayrı çağrılar yapılır).
-
FilterExpression (isteğe bağlı) —site URL'sine, yoluna, dosya türüne veya tarih aralığına göre kapsam için KQL ifadesi.
-
MaximumNumberOfResults—arama başına 25 ile sınırlandırılmıştır.
-
-
Yanıt: Microsoft 365, isteği güven sınırı içinde işler ve her girişin aşağıdak ileri içeren bir RetrievalHits dizisi döndürür:
-
ContentChunk—içerik dizininden çıkarılan bir metin parçacığı
-
Alaka düzeyiÇekirde—sorgu ile yığın arasındaki kosinüs benzerlik puanı, 0—1 aralığına normalleştirilmiş
-
kaynak—dosya adı, URL, yazar ve son değiştirilme tarihi dahil kaynak meta verileri
-
-
Veri işleme: Tam dosya içeriği aktarılmaz; yalnızca Microsoft 365 karma dizininden önceden çıkar ılmış metin parçaları döndürülür. Cisco AI Assistantyeniden sıralama, filtreleme ve cevap oluşturma için bu parçaları geçici olarak LLM'ye iletir. Kaynak meta veriler, nihai yanıtta alıntılar oluşturmak için kullanılır. Metin parçaları Webex tarafından istek süresinin ötesinde depolanmaz.
-
-
Copilot Bağlayıcıları İç eriği: Copilot Connectors içeriği, Microsoft Graph bağlayıcıları aracılığıyla Microsoft 365 içerik dizinine alınan ve Microsoft 365 Copilot Retrieval API 'si aracılığıyla erişilebilir hale getirilen üçüncü taraf veya özel kurumsal verilerdir. Döndürü len tüm içerik, oturum açmış kullanıcının bağlayıcının Microsoft 365'te yapılandırılmış izinleri altında erişmeye yetkili olduğu öğelerle sınırlıdır.
-
İstek: Cisco AI Assistant Yetkilendirme başlığında Microsoft Entra Kimliği devredilen erişim belirtecini taşıyan https://graph.microsoft.com/v1.0/copilot/retrieval adresine bir HTTPS POST isteği gönderir. Talep gövdesi şunları içerir:
-
QueryString—kullanıcının isteminden türetilen yeniden yazılmış doğal dil sorgusu (en fazla 1.500 karakter).
-
Veri Kaynağı—CoPilotConnectors olarak ayarlayın.
-
FilterExpression (isteğe bağlı) —Belirli bağ layıcı kaynaklarına veya içerik türlerine erişim kapsamına yönelik KQL ifadesi.
-
MaximumNumberOfResults—arama başına 25 ile sınırlandırılmıştır.
-
-
Yanıt: Microsoft 365, isteği güven sınırı içinde işler ve her giriş aşağıdakileri içeren bir RetrievalHits dizisi döndürür:
-
ContentChunk—dizine eklenmiş üçüncü taraf içerikten çıkarılan bir metin parçacığı.
Alaka düzeyi—Sorgu ile yığın arasındaki kosinüs benzerlik puanı, 0—1 aralığına normalleştirilmiştir. Alaka düzeyi puanının tüm Copilot Connector sonuçları için mevcut olmayabileceğini unutmayın.
kaynak - öğe adı, URL ve bağlayıcı tanımlı öznitelikler dahil kaynak meta verileri.
-
-
-
Veri işleme: Tam kaynak içeriği aktarılmaz; yalnızca Microsoft 365 içerik dizininden önceden çıkar ılmış metin parçaları döndürülür. Erişim API'si çağrı başına bir veri kaynağını hedeflediğinden, SharePoint, Cisco AI Assistant OneDrive ve Copilot Bağlayıcıları için ayrı geri alma çağrıları düzenler ve yeniden sıralama ad ımı sırasında sonuçları birleştirir.
Metin parçaları, yeniden sıralama, filtreleme ve yanıt oluşturma için geçici olarak LLM'ye iletilir ve Webex tarafından istek süresinin ötesinde depolanmaz.
Kimlik doğrulama ve yetkilendirme
Webex, Microsoft kimlik sağlayıcısı (IdP) tarafından doğrulanan ve yönetilen Microsoft Erişim API' sini kullanarak Microsoft hesaplarınız ve içeriğinizle etkileşime girer. Microsoft IdP ve Erişim API'si ile tüm iletişim, TLS güvenli bağlantılarla korunur.
Webex Hizmet Kimlik Doğrulaması
Cisco AI AssistantWebex Uygulamasında, Webex hizmetleriyle etkileşim kurmak için standart OAuth 2.0 akışlarını kullanır:
-
Kimlik Sağlayıcısı: Webex Kimlik Hizmeti, kullanıcıların kimliğini doğrulamak ve API erişimini yetkilendirmek için bulut tabanlı IdP görevi görür.
-
Taşıyıcı Belirteçleri: Webex API'lerine yapılan istekler, Webex Kimlik Hizmeti tarafından verilen taşıyıcı belirteçleri kullanılarak yetkilendirilir.
-
Güvenli İletişim: WebexAI Assistant, Webex Kimlik Hizmeti ve Webex API'leri arasındaki tüm veri alışverişi TLS güvenli bağlantılar üzerinden gerçekleştirilir.
İdari Gereksinimler
Bu entegrasyonu etkinleştirmek için yöneticilerin aşağıdaki adımları tamamlaması gerekir:
-
Microsoft 365 Yapılandırması: Yöneticiler ilgili kullanıcılara uygun Microsoft Copilot lisanslarını atamalıdır.
-
Webex Yapılandırması: Yöneticiler özelliği doğrudan Control Hub içinde kuruluş , kullanıcı veya şablon düzeyinde etkinleştirebilir veya devre dışı bırakabilir.
Kullanıcı Onaylı İzinler
Kurulum sırasında aşağıdaki izinler istenir:
| İzin gerekli | Amacı |
|---|---|
| Webex Uygulaması Oturum açın ve kullanıcı profilini okuyun | Hesabınızla Webex Uygulamasında oturum açın. |
| Microsoft hesabınıza yetkilendirin ve oturum açın | Microsoft hesabınıza bağlanmak için Webex Uygulamasını doğrulayın ve yetkilendirin. |
Bu izinler yalnızca kurulum işlemi sırasında kullanılır ve saklanmaz.
Servis izinleri
Belirli bir servis iznine gerek yoktur. Yöneticiler, Control Hub'daki özelliği ve ayarları aşağıdaki bölüm ayrıntılarıyla yönetebilir.
Copilot entegrasyonu Control Hub'da özellik yönetimi ve yetkilendirme
Yöneticiler, kuruluşları için özelliği açıp kapatabilir veya onay kutularıyla hangi bir veya daha fazla kaynağın verilebileceğine karar verebilirler.
Daha fazla bilgi için bkz. Control Hub'da yapay zeka tümleştirmelerini ayarlama ve Webex Cisco AI Assistant Uygulamasında arama kaynaklarını açma veya kapatma
Webex App ayarları ve yapılandırmaları
Kullanıcılar Webex Uygulamasında oturum açabilir ve yönetici Control Hub'ı kullanarak özelliği yetkilendirerek açtıktan sonra Microsoft hesabına bağlama yetkisi verebilir.
Daha fazla bilgi için bkz. Microsoft verilerinize şu şekilde erişme Cisco AI Assistant