> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/tr/ai/ai-whitepaper/agentic-search.md).
# Etken Arama
## **Ajan Tabanlı Arama nedir?**
#### Agentic Search, Zoom içeriği ve bağlı Kurumsal veri kaynaklarını kapsayan, birleşik ve İzin farkındalıklı bir bağlam katmanıdır
Agentik Arama; Zoom’a yerel içerik ile bağlı üçüncü taraf veri kaynakları genelinde ilgili bilgileri toplayan, indeksleyen ve ilişkilendiren, tek bir kurumsal bilgi birikimi oluşturan ve bir sorgunun buna karşılık çözümlendiği kurumsal düzeyde bir bilgiye erişim (knowledge retrieval) yeteneğidir. Onu geleneksel aramadan ayıran şey, tek bir sorgunun yararlanabileceği kapsamdır: bir toplantı döküm, bir ekip sohbeti mesajı ve kurumsal bir bulut sürücüsünde bulunan bir belge hepsi aynı sonuca katkıda bulunabilir. Bu sonucun biçimi giriş noktasına bağlıdır — doğal dilde sentezlenmiş bir yanıt ya da başka bir modelin akıl yürütmesi için gerekçelendirilmiş kaynak materyalin sıralı bir kümesi — ancak bu kaynakların kapsadığı alan ve onlara karşı uygulanan izinler değişmez.
Zoom içinde, geri alma işlemi platformda zaten birikmiş olan işin kaydetmek kapsamını kapsar — toplantı kayıtları ve transkriptler, toplantı özetleri, Team Chat konuşmaları ve onlarla birlikte oluşturulan belgeler, notlar ve diğer arayüz öğeleri. Zoom’un ötesinde, geri alma; Salesforce, Google Drive, OneDrive, SharePoint, Confluence, Box, ServiceNow, Workday, Zendesk ve Seismic gibi hizmetleri de içerebilen bağlı kaydetmek sistemleri ve içerik depolarına kadar uzanır. İndeksleme destekleniyor ve etkinleştirildiğinde, bu sistemlerdeki içerikler, Zoom’un geri alma katmanına Zoom’a özgü bilgilerle birlikte alınır; böylece bir soru, her birinin kendi şartlarında aranması gereken yalıtılmış depolar kümesi yerine tek bir kurumsal bilgi bütünü karşısında yanıt bulur.
Alma işlemi baştan sona İzin duyarlıdır. Her kaynak sistemden gelen Access denetimleri devralınır ve uygulanır; bu nedenle görüntülenen bilgiler — Zoom-native ya da üçüncü taraf — talepte bulunan kullanıcıya veya temsilciye ait geçerli İzinlere göre sınırlandırılır. Aranabilir kaynak kümesinin genişletilmesi, herhangi bir bireyin bunlara Access'ini genişletmez.
#### "Agentic Search" bir yeteneği tanımlar, bir arayüzü değil
Agentic Search, belirli bir ekran veya düğmeden ziyade altta yatan bir yetenek olarak en iyi şekilde anlaşılır. Aynı yeteneğe birden fazla yoldan ulaşılır: günlük kullanıcılar için ZoomMate arayüzü üzerinden ve uygulamalar ile yapay zekâ aracılar için Search and Ask API'leri ile Model Context Protocol (MCP) üzerinden. Hangi giriş noktası kullanılırsa kullanılsın, bu terim aynı temel işlevi ifade eder: kaynaklar genelinde ilgili bilgileri alma ve sentezleme.
#### ZoomMate, bağlı kurumsal bilgiden dizine alınmış verileri almak için Agentic Search kullanır, ardından sonuçları doğal dilde bir yanıta dönüştürür
Günlük kullanıcılar için ZoomMate, Agentic Search'ün rutin hale geldiği yerdir. Yaklaşan toplantı için hazırlanmak, geçmiş birkaç toplantıda alınmış bir kararı hatırlamak veya açık bir eylem maddesiyle bağlantılı bir belgeyi bulmak, toplantılar, sohbetler, belgeler, bulut depolama ve CRM ya da biletleme sistemleri arasında ayrı aramalar yapmak yerine tek bir istekte çözülebilir.
#### MCP ve Arama ve Sorma API'leri, aynı alımı uygulamalara ve harici yapay zeka temsilcilerine genişletir
Uygulamalar ve üçüncü taraf LLM’ler üzerine kurulu olanlar da dahil olmak üzere harici yapay zekâ ajanları, Agentic Search’e MCP üzerinden bir araç olarak çağrı yapar. Access denetimleri çağrı ile birlikte taşınır; böylece ajan, doğrulanmış kullanıcı izinleriyle tutarlı bilgileri alır.
Bu **Arama API'si** ilgili sonuçlardan sıralanmış bir küme döndürür ve üretimi çağrı yapanın kendi modeline bırakır; bu da ham, temellendirilmiş kaynak materyalin istenen çıktı olduğu durumlara uygundur.
Bu **Soru API'si** Zoom içinde hem geri getirme hem de üretim gerçekleştirir, doğal dilde sentezlenmiş, kaynak gösterilmiş bir yanıt döndürür.
#### Sabit bir indeks ve istek anı geri getirme, sık değişen verileri güncel tutar
Agentic Search statik bir indeksle sınırlı değildir. İçerik vektörleştirilir, indekslenir ve anahtar kelimelendirilir; onaylı üçüncü taraf içerik, verimli sonraki geri getirme için yönetici kapsamlı artımlı senkronizasyon yoluyla dahil edilir. Sık değişen ya da istek anı tazeliğinden yararlanan veriler ise indeks üzerinden sunulmak yerine MCP ya da eşdeğer gerçek zamanlı bağlantılar üzerinden doğrudan sorgulanabilir.
Birlikte, sabit indeks ve istek anı geri getirme, bağlam katmanının son senkronizasyondaki durumunu değil, bağlı sistemlerin mevcut durumunu yansıtması anlamına gelir.
## **Veri Kaynakları ve İndeksleme**
#### Zoom'un dizinleme mimarisi, konuşmalı yapay zekâ geri getirme için özel üretimdir
Zoom'un dizinleme mimarisi, konuşmalı yapay zekâ için özel üretimdir; vektör arama, içerik parçalama ve konuşmalı sistemlerin bağlamı geri alma biçimine göre tasarlanmış bir şema kullanır. Çok sayıda Kurumsal arama ve grafik teknolojisi başlangıçta farklı bir hedef için tasarlanmıştı: belgeleri, insanları, meta verileri ve diğer varlıkları bir üretkenlik ortamı genelinde birbirine bağlamak (Bağlanıyor). Bu mimari fark önemlidir; çünkü konuşmalı yapay zekânın, öncelikle belgeler ya da varlıklar arasındaki ilişkilerde gezinmek yerine, bir kullanıcının sorusuyla anlamsal olarak ilgili belirli bilgi parçalarını tanımlaması ve geri getirmesi gerekir. Zoom'un yaklaşımı, içeriği bu geri getirme modeli etrafında yapılandırır ve dizinler; böylece konuşmalı kullanım senaryolarını, farklı bir amaç için tasarlanmış bir sisteme sonradan eklenen bir yetenek olmaktan ziyade temel bir mimari değerlendirme haline getirir.
Başka bir deyişle: bu, bir kütüphaneyi tek tek kitaplara göre dizinlemek ile onu birinin bir soruyu yanıtlamak için gerçekten ihtiyaç duyabileceği pasajlara göre dizinlemek arasındaki farktır.
#### Üçüncü taraf Bağlayıcılar, yönetici tarafından etkinleştirilmesine bağlı olarak Zoom'un bağlam katmanını yetkilendirilmiş üçüncü taraf sistemlere genişletir
Agentic Search, Google Drive, OneDrive, Box, Salesforce, ServiceNow, Zendesk, Seismic, Confluence ve SharePoint dahil olmak üzere yetkilendirilmiş üçüncü taraf Bağlayıcılardan dizinlemeyi destekler; mevcut sürüm durumuna bağlı olarak Uygun ek Bağlayıcılar da bulunur. Bir Bağlayıcının Uygun olması, içeriğinin otomatik olarak aranabilir olduğu anlamına gelmez — Agentic Search onun içeriğini almaya başlamadan önce her kaynak bir yönetici tarafından etkinleştirilmelidir. Bu yönetici-kapılı model kasıtlıdır: dizinleme kapsamını, bir Organizasyonun gerçekten yetkilendirdiği şeyle uyumlu tutmak için tasarlanmıştır; böylece varsayılan olarak her bağlanabilir sistemi açığa çıkarmak yerine bunu yapar.
#### Dizinleme nasıl çalışır: içe aktarımdan sorgulanabilir bir dizine
Bir Bağlayıcı etkinleştirildiğinde, Agentic Search her istek için kaynak sistemi yeniden sorgulamak yerine onaylı içeriğin aranabilir bir dizinini oluşturur. Süreç birkaç aşamadan geçer:
1. **İçe Aktarım** — Onaylı içerik, bağlı kaynaktan, bir yöneticinin yetkilendirdiği kapsam ve bağlantı kuran kullanıcıların izinleri (Bağlanıyor) dahilinde alınır. Bulut sürücüler gibi dosya tabanlı kaynaklarda, belge içeriği yalnızca bağlantı verilmek yerine işlenmek üzere alınır.
2. **Bölümlendirme** — Alınan içerik, bir sorguyla ilgili belgenin tamı yerine belgenin belirli bölümünü getirebilmek için daha küçük pasajlara bölünür.
3. **Vektörleştirme** — Her pasaj, bir gömme modeli kullanılarak sayısal bir gömme vektörüne dönüştürülür; bu da getirmenin yalnızca tam ifadeye değil anlama göre de eşleşmesini sağlar.
4. **Anahtar sözcük indeksleme** — İçerik ayrıca anahtar sözcük eşleştirmesi için de indekslenir. Hem Search hem de Ask yetenekleri, vektör benzerliğinin yanı sıra anahtar sözcük eşleşmelerine bağlıdır; bu nedenle iki yaklaşım alternatifler olarak değil, birlikte çalışır.
5. **İzin-meta veri indeksleme** — Kullanıcı Access bilgileri, kaynak sistemin kendi yerel İzinlerinden türetilerek içerikle birlikte indekslenir; böylece sorgu zamanında İzin-duyarlı filtreleme uygulanabilir.
Sonuç, müşteriye özel bir getirme dizinidir — bir kaynaktan gelen içerik, paylaşılan ya da kiracılar arası bir depoda değil, o müşteriye özel kapsamda ve o müşterinin İzinleri tarafından yönetilen bir biçimde saklanır.
#### Şemalar ve veri akışları referans için Uygun olarak sunulmaktadır
— Zoom'un Agentic Search'ünün üçüncü taraf uygulamalar, hizmetler ve veri kaynaklarıyla nasıl bağlantı kurduğunu gösteren — bağlantı ve indeksleme veri akışları dahil — şemalar, içinde Uygun [Zoom AI Beyaz Kitap](https://library.zoom.com/ai/ai-whitepaper/diagrams#zoommate-third-party-connections-and-indexing).
#### Dizine eklenenler, bir yöneticinin Bağlayıcı için yetkilendirdiği kapsam tarafından belirlenir
Dizine eklenen içerik, bir yöneticinin Bağlayıcı için yetkilendirdiği kapsam tarafından belirlenir. Bir kaynak bağlandıktan sonra, dizin tek seferlik içe aktarma yerine devam eden güncellemelerle korunur:
1. **İlk Eşitle**: İlk yapılandırmada, Bağlayıcı kapsam içindeki içeriğin, mevcut geçmiş içerik dahil, tam eşitlemesini gerçekleştirir.
2. **Günlük dizin güncellemesi**: Bazı kaynaklar için, Bağlayıcı kapsam içindeki içeriği günde bir kez yeniler.
3. **Artımlı Eşitle**: Diğerleri için, Bağlayıcı her gün boyunca periyodik Eşitle'ler çalıştırır ve her seferinde tüm depoyu yeniden işlemeye yerine yalnızca son Eşitle'den bu yana eklenen, değiştirilen veya değişmiş olan içeriği işler.
#### Dizine eklenen alma ve gerçek zamanlı alma birlikte çalışır
Agentic Search iki alma yolu kullanır ve hangisinin uygulanacağı, bir kaynağın nasıl bağlandığına ve ne tür veri tuttuğuna göre belirlenir — bir kullanıcının ya da yöneticinin açıp kapattığı, sorgu başına ya da klasör başına bir ayara göre değil.
Olarak bağlanan içerik bir **hesap düzeyi veri kaynağı** yönetici panelinde, müşteriye özel bir dizine alınır ve oradan aranır. Bu, yapılandırılmamış içerik — belgeler, bilgi makaleleri ve dosyalar — için varsayılan yoldur; çünkü önceden oluşturulmuş bir dizin, sorgu anında alımı hızlı ve verimli hale getirir ve Organizasyon genelinde paylaşılan aranabilir bir dizin üretir.
İçerik şuradan erişilir **doğrudan, gerçek zamanlı olarak, MCP veya bir API aracılığıyla** diğer durumlarda: bireysel bir kullanıcının yetkilendirdiği kişisel bağlayıcılar (kendi e-postası, takvimi veya kişisel bulut depolaması gibi), CRM nesne verileri gibi yapılandırılmış kayıtlar ve istek anındaki güncellikten yararlanacak kadar sık değişen diğer içerikler. Kişisel bir bağlayıcı yalnızca bağlanan kullanıcının erişebildiği belgeleri getirir ve yapılandırılmış veri bağlantıları, dizinden sunulmak yerine kendi kullanıcı kimlik doğrulama ve yetkilendirmelerini taşır.
Yol bağlantıyı izlediği için, aynı temel uygulamaya nasıl kurulduğuna bağlı olarak her iki yoldan da erişilebilir. Yönetici tarafından yönetilen bir veri kaynağı olarak bağlanan bir bulut depolama hizmeti, Organizasyon genelinde arama için dizine alınır; bir bireyin kişisel bağlayıcısı olarak bağlanan aynı hizmet ise doğrudan sorgulanır ve o kullanıcının kendi erişimiyle sınırlandırılır.
#### Harici Agentic Search bağlantıları Model Context Protocol (MCP) üzerine kuruludur
Zoom ile harici modeller, araçlar ve veri kaynakları arasındaki bağlantılar, modelleri araçlara ve verilere bağlamak için açık bir istemci-sunucu standardı olan Model Context Protocol (MCP) üzerine kuruludur. MCP sunucuları Zoom'un ucunda çalışır ve üzerinden alma isteklerinin yapıldığı tutarlı bir arayüz sağlar — hem bağlı sistemlerden gerçek zamanlı alma için hem de bir araç olarak Agentic Search'e ulaşan harici aracılar için. Bu standartlaştırılmış taşıma, tek seferlik, kaynak bazlı entegrasyonların yerini ortak bir bağlantı modeliyle alır.
#### Dizinleme süresi müşteri, veri hacmi ve veri türüne göre değişir
Belirli bir bağlayıcının tamamen dizine alınmasının ne kadar süreceğine dair sabit bir zaman çizelgesi yoktur. Gerekli süre, dizine alınan verinin miktarına ve ilgili veri türüne bağlı olarak her müşteri için değişir. Dizine alınan üçüncü taraf platformun uyguladığı hız sınırları katkıda bulunan bir etmendir — her kaynak sistem, belirli bir zaman penceresinde ne kadar verinin çekilebileceğini sınırlar ve bu sınırlama platforma, plan kademesine ve API tasarımına göre değişir. Büyük ya da yoğun kullanılan bir depo için ilk kez dizinleme planlayan müşteriler, aynı gün veya aynı hafta sonucu yerine birkaç haftalık bir zaman dilimi beklemelidir.
#### Dizinleme kapasitesi ZoomMate lisans kademesiyle ölçeklenir ve organizasyon düzeyinde havuzlanır
Dizinleme kapasitesi, sabit bir evrensel tahsis yerine lisans kademesinin bir işlevidir. Lisanslı her kullanıcı, kademesine bağlı bir koltuk başına kapasite miktarı sağlar ve bu miktarlar, her bir kullanıcıya ayrı ayrı tahsis edilmek yerine Organizasyon genelinde paylaşılan tek bir havuzda birleşir.
Tüm bağlı kaynaklar ve tüm kullanıcılar arasındaki toplam dizinlenmiş içerik, organizasyonun birleşik havuzu içinde kalmalıdır — yani büyük bir depo dizine alınırken bir kullanıcı, diğer herkes için kullanılabilir olan aynı paylaşılan kapasiteden çeker. Havuz her lisanslı koltukla büyüdüğü için, bir organizasyonun toplam kapasitesi tüm lisanslı kullanıcılarının katkılarının toplamıdır.
Örneğin, bir lisans 1 GB depolama sağlıyorsa, 25 lisansla hesap toplam 25 GB depolamaya sahip olur. 100 kullanıcıda 100 GB.
Büyük depoları (tam bir Confluence alanı, büyük bir SharePoint sitesi, olgun bir CRM örneği) dizine almayı planlayan organizasyonlar, lisans kademelerini ve koltuk sayılarını kullanıcı başına kullanım kalıplarına göre değil, beklenen toplam içerik hacmine göre belirlemelidir. Ek dizin kapasitesi mevcuttur—daha fazla bilgi için lütfen Zoom hesabı ekibinizle görüşün.
#### Dosya boyutu ve dosya türü, neyin dizine alınacağını etkiler
İki ayrı boyut sınırı uygulanır ve bunlar farklı davranır:
* **64 MB özgün dosya sınırı (indirme):** Bir kaynak dosyanın özgün boyutu 64 MB'ı aşarsa atlanır ve işlenmek üzere indirilmez.
* **16 MB işlenmiş içerik sınırı (dizinleme):** İndirilen dosyalar birleşik bir işleme biçimine dönüştürülür. Ortaya çıkan işlenmiş dosya 16 MB'ı aşarsa, içeriğinin yalnızca ilk 16 MB'ı dizine alınır; geri kalanı alınmaz.
Bu iki sınır farklı şekilde başarısız olur: çok büyük özgün dosya tamamen atlanırken, çok büyük işlenmiş dosya hariç tutulmak yerine kırpılır; böylece başlangıç içeriği alımda görünmeye devam ederken sonraki içerik görünmez.
Ayrıca, dizinleme boyuttan bağımsız olarak dosya türüne de bağlıdır. Çoklu ortam içerikleri — ses, video ve görüntüler — herhangi bir boyutta dizine alınmaz. Bu içerikler, iki boyut sınırından herhangi biri değerlendirilmeden önce, birleşik işleme biçimine dönüştürülürken kaldırılır. Meta veriler tüm belgeler için dizine alınır, ancak tam içerik yalnızca desteklenen, medya olmayan dosya türleri için dizine alınır. Desteklenmeyen türlerde belge meta verileri sayesinde yine bulunabilir, ancak içeriği aranabilir değildir.
#### Yöneticiler şu anda içeriğin hangi sırayla dizine alınacağını kontrol edemez
Bugün bir yöneticinin, bağlı bir kaynak içinde belirli klasörleri, alanları ya da içerik türlerini diğerlerinden önce dizine alınacak şekilde önceliklendireceği bir mekanizma yoktur. Dizinleme, etkinleştirilmiş bir Bağlayıcı içindeki uygun içerik boyunca sıraya koyma yolu olmaksızın ilerler; bu da organizasyonların en yüksek değerli içeriklerinin dizine alınmasını öne çekemeyeceği ve dizinleme kapsamının en iş kritik materyalle başlamak yerine tüm depo genelinde kademeli olarak oluşmasını beklemesi gerektiği anlamına gelir.
Dizinleme ayrıca seçilen bir zamanda ya da sıklıkta çalışacak şekilde planlanamaz. Bir kaynak etkinleştirildikten sonra, dizinleme bir yöneticinin belirlediği bir plan yerine kendi zamanlamasıyla çalışır; bu nedenle belirli bir pencereye göre zamanlanabilecek bir şeyden ziyade, tamamlandığında tamamlanan bir arka plan süreci olarak ele almak en iyisidir.
## **Yönetim, İzinler ve Yönetişim**
#### Yöneticiler hangi kaynakların bağlandığını kontrol edebilir ve kullanıcılar kendi erişimleri için kimlik doğrulama yapar
Bağlayıcılar bir yönetici tarafından etkinleştirilir; yönetici, Organizasyon içinde hangi üçüncü taraf sistemlerin dizinleme ve arama için uygun olduğunu belirler. Bir Bağlayıcıyı etkinleştirmek, bir kaynağı Organizasyon için uygun hale getirir, ancak bu, içeriğine doğrudan erişim sağlamaz. Her kullanıcı, kaynağa erişimini tek tek kimlik doğrulamalıdır — kimlik doğrulandıktan sonra, alma izinleri kaynak sistemdeki mevcut izinleriyle uyumlu hale gelir; böylece yalnızca orada zaten erişebildikleri şeyleri ortaya çıkarabilirler.
#### Alma, İzinleri dikkate alır ve salt okunurdur
Agentic Search, her kaynak sistemin erişim denetimlerini uygulayacak şekilde tasarlanmıştır; böylece yanıtlar yalnızca kullanıcının zaten görmesine izin verilen içeriği yansıtır; aynı soruyu soran iki kullanıcı, üçüncü taraf veri kaynağındaki kendi izinlerine bağlı olarak farklı sonuçlar alabilir. Alma salt okunurdur ve her kaynağın saklama politikalarını izler — örneğin, Zoom toplantı içeriği arama katmanı tarafından ayrı olarak saklanmak yerine geçerli saklama süresine uyar. Alma, sorgu anında yönetildiği ve İzinleri dikkate aldığı için, ham dökümlerin veya kayıtların toplu halde dışa aktarılmasına da bir alternatif sunar ve erişimi özgün üçüncü taraf kaynakla uyumlu tutar.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://library.zoom.com/technical-library/tr/ai/ai-whitepaper/agentic-search.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.