Bu rehberde: Panelde ve rehberlerde geçen her teknik kelimenin kısa, sade açıklaması. Bir kelimeyi anlamadığınızda buraya dönün.
⏱ Gerektiğinde bakın
Hesap ve yapı
Organizasyon – Şirketinizin OrqLabs hesabı. Tüm veriler bir organizasyona aittir. Üyeler, plan ve aylık bütçe burada tutulur. Başka organizasyonlar sizin verinizi göremez.
Proje – Bir marka. Marka sesi, hedefler, ürünler, rakipler ve strateji belgesi projeye yazılır. Sosyal hesaplar ve mesajlaşma numaraları projeye bağlanır. Ajanslar müşteri başına bir proje açar.
Rol – Bir üyenin yetkisi. Sahip (OWNER) her şeyi yapar. Yönetici (ADMIN) üye ve entegrasyon yönetir. Üye (MEMBER) iş akışı kurar, onay verir, mesaj yanıtlar. İzleyici (VIEWER) yalnızca bakar.
Plan – Hesabınızın paketi: FREE, STARTER, PRO, ENTERPRISE. Plan, kaç proje açabileceğinizi, kaç hesap bağlayabileceğinizi, aylık bütçenizi ve hangi modelleri kullanabileceğinizi belirler.
SUPER_ADMIN – Platformu işleten ekibin rolü. Yönetim Paneli'ne girer. Normal kullanıcılar bu rolü görmez.
İş akışı kavramları
İş akışı (workflow) – Adımlardan oluşan otomatik plan. "Şu olduğunda, şunu yap, sonra şunu yap" zinciri. Editörde kutuları birleştirerek kurarsınız.
Node (düğüm) – İş akışındaki tek bir kutu. Her node bir iş yapar: bir tetikleyici, bir ajan, bir mesaj gönderimi, bir karar.
Tetikleyici (trigger) – İş akışını başlatan olay. Örnekler: belirli bir saat (zamanlama), gelen bir mesaj, bir web formu, bir webhook isteği, bir platform olayı, elle basılan Çalıştır düğmesi.
Kenar (edge) – İki node arasındaki bağlantı çizgisi. Verinin hangi yöne aktığını gösterir.
Item (öğe) – Node'lar arasında akan veri parçası. Örneğin bir gönderi metni ya da bir müşteri adayı kaydı. Bir node 3 gönderi üretirse 3 item çıkar.
İfade – Bir alana yazdığınız {{ ... }} kalıbı. Çalışma anında gerçek değere dönüşür. Örneğin {{ $json.body }} "önceki adımdan gelen metin" demektir.
Çalıştırma (run) – İş akışının bir kez çalışması. Her çalıştırma kaydedilir: ne zaman başladı, hangi adımlar geçti, kaç para tuttu.
Durum – İş akışının hâli: Taslak (DRAFT, henüz çalışmaz), Etkin (ACTIVE, tetikleyici kayıtlı), Duraklatılmış (PAUSED), Arşiv (ARCHIVED). Çalıştırmanın hâli: Sırada (QUEUED), Çalışıyor (RUNNING), Bekliyor (WAITING), Başarılı (SUCCEEDED), Hatalı (FAILED), İptal (CANCELED).
Test modu – İş akışını gerçek etkileri olmadan çalıştırmak. Yayın ve mesaj adımları "kuru çalışır", yani gerçekten göndermez. Yapay zekâ çağrıları gerçektir.
Şablon – Hazır iş akışı. Şablonu kullan dediğinizde kopyası oluşur; kopyayı istediğiniz gibi değiştirirsiniz.
Sürüm (version) – İş akışını her kaydettiğinizde bir sürüm oluşur. Eski bir sürüme geri dönebilirsiniz.
Değişken – İş akışına ait, ifadelerde {{ $vars.ad }} ile kullanılan sabit metin. Örneğin ideal müşteri profili metniniz.
Ajan kavramları
Ajan (agent) – Belirli bir işte uzman yapay zekâ çalışanı. Araç kullanır (web araması, sosyal hesaplar, bilgi bankası), adım adım ilerler ve sonunda rapor yazar. 14 tür vardır.
Görev (task) – Ajana doğal dille verdiğiniz talimat. Türkçe yazabilirsiniz.
Girdi (input) – Ajana özel yapısal ayarlar. Örneğin Content Creator için platform listesi ve gönderi sayısı.
Araç (tool) – Ajanın kullanabildiği yetenek: web_search (web araması), fetch_url (sayfa okuma), knowledge_search (bilgi bankasında arama) gibi.
Adım (step) – Ajanın tek hamlesi: düşünme, araç çağrısı, araç sonucu, mesaj. Maks. araç adımı (maxSteps) bu hamlelerin üst sınırıdır.
Kayıtlı ajan – Ayarlarını kaydettiğiniz ajan. Tek tıkla çalışır ve bellek tutar: önceki çalıştırmada ne yaptığını hatırlar.
Bellek (memory) – Kayıtlı ajanın çalıştırmalar arasında sakladığı notlar. Örneğin daha önce bulduğu şirketler.
Düşünme derinliği (effort) – Modelin ne kadar uzun düşüneceği: düşük, orta, yüksek, çok yüksek. Yüksek daha kaliteli ama daha pahalı ve yavaştır.
Sistem prompt'u – Ajanın görünmez ana talimatı. Katalogdan gelir; Ek talimatlar alanıyla üstüne kural eklersiniz.
Strateji belgesi – Projenin ortak planı: konu ağırlıkları, kanallar, en iyi saatler, hedef sayılar. Analytics Strategist yazar, diğer ajanlar okur.
Bilgi bankası (knowledge base) – Chatbot'un ve ajanların okuyacağı belgeler: SSS, iade politikası, ürün bilgileri. Belge yüklersiniz, sistem indeksler.
Sonuçlar ve denetim
Rapor – Ajanın okunabilir çıktısı: başlık, özet, ayrıntı, sayılar ve öneriler.
Öneri (recommendation) – Raporun sonundaki eylem maddesi. autoApplicable işaretli olanları Uygula düğmesiyle tek tıkla hayata geçirirsiniz.
Onay (approval) – İnsan denetim noktası. İş akışı Bekliyor durumuna geçer. Onaylar sayfasında Onayla veya Reddet dersiniz. Karar verilmezse 72 saat sonra otomatik reddedilir.
Devralma (takeover / handoff) – Chatbot konuşmasını insanın ele alması. Bot susar; siz Gelen Kutusu'ndan yazarsınız; işiniz bitince botu geri açarsınız.
Bildirim – Panelin sağ üstündeki zil. Onay istekleri, devirler, hatalar ve bütçe uyarıları burada görünür.
Bağlantı ve güvenlik
Entegrasyon – OrqLabs'ın sizin adınıza kullandığı dış hesap. Proje kapsamlı (bir markaya ait) ya da organizasyon kapsamlı (tüm markalar paylaşır) olabilir.
Token – İki anlamı vardır. 1) Bir hesaba erişim izni veren uzun şifre dizisi; örneğin Telegram bot token'ı. 2) Yapay zekâ modelinin metni ölçme birimi; yaklaşık 4 harf 1 token'dır. Fiyatlar 1 milyon token başına verilir.
API anahtarı (API key) – Bir servise programla erişmek için kullanılan gizli anahtar. OrqLabs API anahtarları af_live_ ile başlar. Yalnızca bir kez gösterilir.
OAuth – "Şifrenizi vermeden izin verin" yöntemi. Bağla düğmesine basarsınız; sağlayıcının (örneğin Google) kendi sayfası açılır; orada izin verirsiniz; geri dönersiniz. OrqLabs şifrenizi hiç görmez.
Kapsam (scope) – OAuth'ta istenen izinlerin listesi. Örneğin "gönderi yayınla" veya "istatistik oku".
Yönlendirme adresi (redirect URI) – OAuth'tan sonra geri dönülen adres. Sağlayıcı konsoluna birebir girilmesi gerekir: https://api.orqlabs.com/api/v1/integrations/oauth/<sağlayıcı>/callback.
Webhook – Bir sistemin başka sisteme "bir şey oldu" diye anında haber vermesi. Gelen webhook: WhatsApp size mesaj geldiğini OrqLabs'a bildirir. Giden webhook: OrqLabs "yeni müşteri adayı" olayını sizin sisteminize gönderir.
Doğrulama token'ı (verify token) – Webhook kurarken sağlayıcıya girdiğiniz parola. Sağlayıcı bu parolayla OrqLabs'ın gerçek olduğunu doğrular.
İmza (signature) – Webhook isteğinin gerçekten OrqLabs'tan geldiğini kanıtlayan matematiksel mühür. Başlık adı X-AgentFlow-Signature.
Şifreleme – Kimlik bilgileri veritabanında AES-256-GCM ile şifrelenir. Panelde yalnızca son 4 karakteri görürsünüz.
Denetim günlüğü (audit log) – Kim, ne zaman, ne yaptı kaydı. Ayarlar → Denetim günlüğü.
Yapay zekâ ve maliyet
Model – İşi yapan yapay zekâ motoru. Anthropic'in Claude ailesi ve OpenAI'nin GPT ailesi kullanılır.
Katman (tier) – Modelin sınıfı: ekonomi (ucuz, hızlı), dengeli (kalite/fiyat ortası), amiral gemisi (flagship; en güçlü, en pahalı). Planınız hangi katmanları kullanabileceğinizi belirler.
Bütçe – Harcama tavanı. Üç seviyede vardır: ajan çalıştırması başına, iş akışı çalıştırması başına, organizasyonun aylık toplamı.
BYOK – "Bring Your Own Key", yani kendi anahtarınızı getirin. Kendi Anthropic veya OpenAI hesabınızı bağlarsınız; faturayı doğrudan onlara ödersiniz. STARTER ve üstü planlarda açıktır.
Önbellek (prompt caching) – Modelin tekrar eden metni (örneğin marka sesi) hatırlayıp ikinci kez ucuza okuması. Maliyeti düşürür.
Embedding (gömme) – Metni sayılara çevirme. Bilgi bankası araması bununla çalışır. OpenAI anahtarı gerektirir.
Ölçüm
Metrik – Ölçülen bir sayı: yayınlanan gönderi, gelen mesaj, oturum, dönüşüm. İstatistik gezgininde 43 metrik vardır.
KPI – Hedef olarak takip ettiğiniz metrik. Örneğin "aylık 520 sipariş".
GA4 – Google Analytics 4. Web sitenizin ziyaretçi ve dönüşüm verisi.
Search Console – Google'ın arama performansı aracı. Hangi aramalarda göründüğünüzü gösterir.
UTM – Linke eklenen etiket (?utm_source=instagram). Hangi ziyaretin hangi kanaldan geldiğini ölçer.
Hukuk ve uyum
KVKK – Türkiye'nin Kişisel Verilerin Korunması Kanunu. Kişisel veri işlerken aydınlatma, rıza ve silme hakkı gibi kurallar getirir.
GDPR – Avrupa Birliği'nin veri koruma düzenlemesi. KVKK'ya benzer, AB vatandaşları için geçerlidir.
ETK / İYS – Türkiye'de ticari elektronik ileti kanunu ve İleti Yönetim Sistemi. Tüketiciye pazarlama mesajı için önceden onay ve İYS kaydı gerekir.
Opt-in / Opt-out – Opt-in: kişinin mesaj almayı kabul etmesi. Opt-out: kişinin çıkmak istemesi ("DUR" yazması). OrqLabs opt-out isteklerini otomatik işler.
24 saat penceresi – WhatsApp kuralı. Müşteri size yazdıktan sonra 24 saat serbest mesaj atabilirsiniz. Sonrasında yalnızca onaylı şablon gönderilebilir.
Şablon (WhatsApp) – Meta'nın önceden onayladığı mesaj kalıbı. Pencere dışında ve ilk temasta zorunludur.
Sık sorulan sorular
Aradığım terim burada yok. Ne yapmalıyım? Sık sorulan sorular sayfasına ve ilgili rehberin başındaki "Bu rehberde" özetine bakın. Çoğu terim ilk geçtiği yerde açıklanır.
Token ile API anahtarı aynı şey mi? Benzer ama aynı değil. İkisi de gizli erişim şifresidir. "Token" ayrıca yapay zekâ metninin ölçü birimi anlamına da gelir; maliyetler 1 milyon token başına hesaplanır.
İş akışı ile ajan arasındaki fark nedir? İş akışı adımların planıdır. Ajan, o plandaki adımlardan biri olabilen yapay zekâ çalışanıdır.