Desteklenen Entegrasyonlar

“Knowentra bu sistemle entegre olur mu?” sorusunun tek bir evet/hayır yanıtı yoktur. Bir sistem:

• Yerleşik bir bağlantıyla yapılandırılabilir.
• Standart bir protokol üzerinden bağlanabilir.
• MCP sunucusu aracılığıyla araç olarak sunulabilir.
• REST API, webhook veya özel adaptör gerektirebilir.
• Teknik olarak bağlanabilir olsa da kurumun güvenlik politikasına uygun olmayabilir.

Bu rehber, entegrasyon türlerini doğru sınıflandırmak ve üretime geçmeden önce hangi ayrıntıların doğrulanması gerektiğini açıklar.

---

Entegrasyon durumları

Bir bağlantıyı değerlendirirken aşağıdaki durum etiketlerini kullanın:

“Destekleniyor” ifadesini tek başına kullanmak yerine bu etiketlerden biriyle açıklayın.

---

Katalog özeti

Knowentra'da aynı görünen ama farklı amaçlara hizmet eden iki entegrasyon katmanı vardır:

Bu sayılar connector registry'si ve üretilmiş entegrasyon kataloğunun incelenen sürümüne aittir. Yeni entegrasyonlar eklendikçe değişebilir.

Bilgi kaynağı connector kataloğu

Connector'lerin 29'u OAuth, 22'si API anahtarı ile kimlik doğrular. Her connector aynı kapsamı sunmaz; kaynak seçicileri, filtreler ve gereken OAuth scope'ları bağlantı formunda connector bazında tanımlanır.

---

Entegrasyon kategorileri

1. Model sağlayıcıları

Knowentra'nın model katmanı iki temel yaklaşımı desteklemek üzere tasarlanmıştır:

Yerel model çalışma zamanı

Örnek:

• Ollama
• Kurum içinde çalışan OpenAI uyumlu inference servisleri

Yerel çalışmak, model isteğinin otomatik olarak güvenli olduğu anlamına gelmez. Modelin erişebildiği ağ, dosya sistemi, loglar ve bilgi tabanları ayrıca sınırlandırılmalıdır.

OpenAI uyumlu API

OpenAI API sözleşmesinin ilgili bölümünü uygulayan servisler aynı bağlantı yaklaşımıyla kullanılabilir.

Repo içindeki ürün anlatısında örnek olarak:

• OpenAI
• Groq
• OpenRouter
• LM Studio
• OpenAI uyumlu Mistral servisleri

geçmektedir.

Model uygunluk matrisi

Harici modele giden hassas içerik için: LLM Secure Gateway.

---

2. Vektör veritabanları

Knowledge Hub ve RAG hattı, yapılandırılan vektör depolama katmanında embedding ve metadata tutar.

Ürün içeriğinde örneklenen seçenekler:

• Chroma
• Qdrant
• Milvus
• PGVector

Kesin seçenek listesi kullanılan sürüm ve dağıtım yapılandırmasından doğrulanmalıdır.

Vektör veritabanı seçerken yalnızca benzerlik aramasını değil şunları da değerlendirin:

• Metadata ve erişim filtresi
• Yedekleme ve geri yükleme
• Şifreleme ve ağ erişimi
• Çok kiracılı izolasyon
• İndeks güncelleme ve silme davranışı
• Yatay ölçekleme ve gecikme
• Kurumun mevcut işletim uzmanlığı

RAG hattının tamamı: RAG Nasıl Çalışır?.

---

3. Belge ve bilgi kaynakları

Belge entegrasyonu iki farklı modelde çalışabilir:

Senkronizasyon

Kaynak sistemdeki belgeler belirli aralıklarla alınır, işlenir ve Knowledge Hub indeksine eklenir.

Doğrulanması gerekenler:

• Tam veya artımlı senkronizasyon
• Silinen belgenin indeksten kaldırılması
• Sürüm ve güncelleme zamanı
• Kaynak erişim izinlerinin taşınması
• Dosya boyutu ve format sınırları

Canlı erişim

Agent, gerekli belge veya kaydı görev anında izinli bir araçla sorgular.

Bu yaklaşım güncel veriyi kaynağında bırakabilir; fakat gecikme, kaynak sistem erişilebilirliği ve her çağrının yetkilendirilmesi önem kazanır.

Confluence, SharePoint, Notion ve Google Drive yalnızca örnek değildir; incelenen sürümde yerleşik bilgi kaynağı connector'leri olarak kayıtlıdır. Bunlara ek olarak S3, Dropbox, OneDrive, Google Docs, Google Sheets, Evernote ve Obsidian gibi kaynaklar da doğrudan Knowledge Hub senkronizasyonuna bağlanabilir.

Senkronizasyon motoru connector sözleşmesi üzerinden:

• Sayfalı belge listeleme
• Tekil belge içeriğini getirme
• Kaynak yapılandırmasını doğrulama
• İçerik hash'iyle değişiklik algılama
• Silinen belgeleri yansıtma
• Connector destekliyorsa artımlı senkronizasyon
• Kaynağa özgü metadata'yı bilgi tabanı etiketlerine eşleme

yeteneklerini yönetir.

Artımlı senkronizasyon desteği incelenen sürümde Azure DevOps, DocuSign, Fathom, GitLab, Gong, Granola, Greenhouse, incident.io, Rootly, Typeform ve Zoom connector'lerinde açıkça tanımlıdır. Diğer connector'ler zamanlanmış tam senkronizasyonla çalışabilir.

Belge yükleme akışı: Belge Yükleme ve Bilgi Tabanı.

---

4. Kurumsal iş sistemleri

CRM, ERP, CMMS/EAM, MES, destek ve proje yönetimi sistemleri genellikle agent aracı veya workflow adımı olarak bağlanır.

Örnek sistem aileleri:

Salesforce ve HubSpot hem bilgi kaynağı connector'ü hem de workflow entegrasyonu olarak katalogda yer alır. SAP S/4HANA ve SAP Concur ise workflow entegrasyonlarıdır; 51 bilgi kaynağı connector'ü arasında değildir. Bu ayrım önemlidir: workflow entegrasyonu canlı kayıt okuyabilir veya işlem yapabilir, ancak kendiliğinden Knowledge Hub senkronizasyonu anlamına gelmez.

Belirli bir ürünü bağlamadan önce:

• API sürümünü
• Lisans paketinde API erişimini
• OAuth veya servis hesabı modelini
• Rate limit'i
• Webhook/olay desteğini
• Alan ve nesne yetkilerini

doğrulayın.

MCP ile araç bağlama: Araç Bağlama (MCP).

---

5. İletişim ve bildirim kanalları

Workflow veya agent sonucu:

• E-posta
• Kurumsal mesajlaşma
• Webhook
• Uygulama içi AI Feed

üzerinden iletilebilir.

Slack, Discord ve Microsoft Teams incelenen sürümde yerleşik bilgi kaynağı connector'leridir. Gmail ve Outlook da e-posta içeriğini senkronize edebilir. Bu sistemlerin workflow kataloğundaki operasyonları ayrıca canlı aksiyonlar için kullanılabilir.

İletişim araçlarında iki ayrı yetkiyi ayırın:

1. Okuma: Mesaj veya kanal içeriğine erişme
2. Gönderme: Kullanıcı ya da bot kimliğiyle dış iletişim oluşturma

Gönderme işlemleri yanlış alıcı, hassas veri ve geri alınamaz iletişim riski nedeniyle insan onayı gerektirebilir.

---

6. Kimlik ve kullanıcı yaşam döngüsü

Kurumsal kimlik entegrasyonunda farklı protokoller farklı işleri çözer:

Bağlantı kurulmadan önce:

• Benzersiz kullanıcı kimliği
• Grup/rol eşlemesi
• Kullanıcı kapatmanın ne kadar sürede yansıdığı
• Ayrıcalıklı yönetici rolleri
• Acil erişim ve hesap kurtarma
• Audit kaydındaki kullanıcı bağı

test edilmelidir.

---

7. REST API ve webhook

Hazır bağlantı bulunmadığında iki genel yöntem kullanılabilir.

REST API çağrısı

Knowentra'daki workflow veya araç, hedef sistem API'sini çağırır.

Gerekli kontroller:

• Kimlik ve token yönetimi
• İzinli host ve endpoint listesi
• Giriş/çıkış şeması doğrulama
• Timeout ve rate limit
• Idempotency
• Hata ve tekrar deneme politikası

Webhook

Hedef sistemdeki olay Knowentra workflow'unu başlatır veya Knowentra başka sisteme olay gönderir.

Gerekli kontroller:

• İmza doğrulama
• Replay saldırısı önleme
• Olay kimliği ve idempotency
• Kaynak IP/ağ kontrolü
• Şema sürümü
• Başarısız teslim ve yeniden deneme kuyruğu

---

Bağlantı mı, senkronizasyon mu?

Bazı senaryolarda hibrit model kullanılır: genel belge içeriği indekslenir, işlem anındaki güncel kayıt canlı araçla sorgulanır.

---

Entegrasyon uygunluk matrisi

Keşif sırasında her bağlantı için bu tabloyu doldurun:

---

PoC kabul kriterleri

Bir entegrasyonu “çalışıyor” saymadan önce:

• Desteklenen hedef sistem ve API sürümü kaydedildi.
• Kimlik doğrulama ve token yenileme test edildi.
• En az yetkili rol ile gerekli işlemler tamamlandı.
• Yetkisiz nesne ve alanlara erişim engellendi.
• Salt-okunur ve yazma aksiyonları ayrıldı.
• Hassas veri log ve hata mesajlarında maskelendi.
• Timeout, rate limit ve ağ kesintisi test edildi.
• Tekrar deneme çift kayıt oluşturmuyor.
• Silme/güncelleme senkronizasyona doğru yansıyor.
• Onay kapısı atlanamıyor.
• Audit kaydı kullanıcı ve hedef kayıtla ilişkilendirilebiliyor.
• Credential iptal edildiğinde bağlantı duruyor.
• Teknik ve iş sahibi kabul verdi.

---

Sık yapılan hatalar

Örnek marka adını native connector sanmak

Bir sistemin ürün diyagramında görünmesi, o sistemin bütün sürümleri için kodsuz connector olduğu anlamına gelmez. Bağlantı türünü açıkça sorun.

API erişimini lisans paketinden bağımsız düşünmek

Hedef ürünün API veya webhook yeteneği ek lisans, yönetici izni ya da belirli bir sürüm gerektirebilir.

Servis hesabına yönetici yetkisi vermek

PoC'yi hızlandırsa da üretimde gereksiz risk ve zayıf audit oluşturur. Göreve özel rol kullanın.

Senkronizasyon silmelerini unutmak

Kaynakta silinen veya erişimi kaldırılan belge, RAG indeksinde aktif kalmamalıdır.

Entegrasyon sahibini belirlememek

API değiştiğinde, token süresi dolduğunda veya hata oranı yükseldiğinde kimin müdahale edeceği önceden belli olmalıdır.

---

Sonraki adımlar

1. Bağlantıyı doğru iş kapsamına yerleştirin: Organizasyon → Departman → Space
2. MCP araç güvenliğini yapılandırın: Araç Bağlama (MCP)
3. Senkronize belgeler için RAG hattını anlayın: RAG Nasıl Çalışır?
4. Harici modele giden veriyi koruyun: LLM Secure Gateway