Bu rehberde: Ajanın ne olduğunu, nasıl adım adım çalıştığını, hangi araçları kullandığını ve nasıl sınırlandığını öğrenirsiniz. 14 ajan türünün haritasını görürsünüz.
⏱ 15 dakika
Ajan nedir?
Ajan, belirli bir pazarlama işini üstlenen bir yapay zekâ çalışanıdır. Bir talimat alır, araçları kullanarak adım adım çalışır ve sonunda rapor yazar. İnsan bir çalışandan farkı: yorulmaz, saniyeler içinde başlar ve maliyeti sent cinsindendir.
OrqLabs 14 ajan türü sunar: 13 hazır uzman ve bir Custom Agent (kendi tanımladığınız). Her ajan hem Ajanlar sayfasından tek başına hem de iş akışında bir kutu olarak çalışır.
| Kategori | Ajanlar |
|---|---|
| İçerik | Content Creator, Social Publisher |
| Mesajlaşma | Community Manager, AI Chatbot |
| Müşteri adayları | Lead Researcher, Lead Qualifier, Outreach Agent |
| Araştırma | Market Analyst, Competitor Analyst |
| Büyüme | SEO & Traffic Growth, Campaign Planner |
| Analitik | Analytics Strategist, Report Writer |
| Özel | Custom Agent |
Bir çalıştırma nasıl ilerler?
- İstek oluşur: ajan türü, proje bilgileri, görev metni, ajana özel girdiler, model, düşünme derinliği, maks. adım, bütçe, kullanabileceği hesaplar ve varsa önceki çalıştırmadan bellek.
- Ana talimat kurulur: ajanın kendi talimatı + projenin marka sesi, hedefleri, ürünleri, rakipleri + strateji belgesi + son performans özeti + varsa sizin ek talimatlarınız.
- Araç döngüsü başlar. Model bir araç çağırır (örneğin web araması). Sonuç geri verilir. Model devam eder. Her tur bir adımdır.
- Durma: model son yanıtını verir (başarılı), adım sınırı dolar, bütçe aşılır veya hata olur.
- Sonuç: yapısal çıktı, tek paragraf özet, tüm adımlar, kullanım (token ve dolar) ve çoğu ajanda bir rapor.
Çalıştırma sırasında adımlar canlı akar. İstediğiniz anda İptal edebilirsiniz.
Araçlar
Ajanın "elleri" araçlardır. Her ajanın varsayılan bir araç listesi vardır; kayıtlı ajanda daraltabilir veya genişletebilirsiniz.
| Araç | Ne yapar | Gereken hesap |
|---|---|---|
web_search | Web araması | Serper veya Tavily (yoksa araç kapalı) |
fetch_url, crawl_site | Sayfa indirir, metne çevirir | – |
get_recent_posts, get_post_performance, publish_post, schedule_post, save_content_drafts, list_content_drafts | İçerik ve sosyal metrikler | Sosyal hesaplar |
get_comments, reply_comment, classify_sentiment | Yorum yönetimi | X, Facebook, Instagram, YouTube |
knowledge_search | Bilgi bankasında arama | Bilgi bankası |
get_conversation_history, send_message, send_email, escalate_to_human | Mesajlaşma | WhatsApp, Telegram, e-posta… |
create_lead, update_lead, list_leads, get_lead, find_email, enrich_company, schedule_followup | Müşteri adayı işlemleri | Hunter / Apollo (zenginleştirme için) |
get_analytics_summary, get_analytics_report, get_search_console, get_campaign_stats | Ölçüm | Google Analytics, Search Console |
get_strategy, update_strategy | Strateji belgesini okur / yazar | – |
create_campaign, create_workflow_from_template, notify_owner, get_agent_activity | Platform işlemleri | – |
Tüm araçlar yalnızca sizin organizasyonunuzun verisine erişir.
Geliştirici notu: Araçlar
@agentflow/agentskayıt defterinden gelir;AgentToolContext { organizationId, projectId, integrations, services }ile çalışır.
Adımlar, düşünme derinliği ve bütçe
- Maks. araç adımı (varsayılan 25): araç çağrısı + yanıt döngüsü sayısı. Araştırma ajanlarında 40-60, chatbot'ta 8-12 makuldür.
- Düşünme derinliği: düşük, orta, yüksek, çok yüksek (kayıtlı ajanlarda ayrıca maksimum). Yüksek daha uzun düşünme ve daha çok çıktı token'ı demektir.
- Çalıştırma başına bütçe (varsayılan 2 $): tek çalıştırma için dolar tavanı. Aşıldığında ajan durur; o ana kadar üretilen kısmi çıktı ve rapor kaydedilir.
- İş akışı düzeyinde ayrıca çalıştırma bütçesi vardır. Organizasyon düzeyinde aylık bütçe %80'de uyarı üretir.
- Her yapay zekâ çağrısı bir kullanım kaydı oluşturur; Ayarlar → Kullanım ve İstatistik gezgininde görünür.
Bellek
Kayıtlı bir ajan her çalıştırmanın sonunda not alır ve bir sonraki çalıştırmada o notu geri okur. Örnekler: Community Manager'ın en son işlediği yorum, Lead Researcher'ın daha önce bulduğu şirketler, Content Creator'ın son 30 günde kullandığı konular.
Bellek proje + ajan başına tutulur. Ajanlar → ajan → Bellek sekmesinden görüntüler ve sıfırlarsınız. Hızlı çalıştırmalar bellek kullanmaz.
Strateji belgesi
Her projenin bir strateji belgesi vardır (Ayarlar → Projeler → Strateji). Alanlar: konumlandırma, sütunlar, konu ağırlıkları, kanallar (platform, haftalık gönderi, en iyi saatler), kitle segmentleri, KPI'lar, deneyler, notlar.
- Yazan: Analytics Strategist. Otomatik uygulama kapalıyken değişiklikler rapordaki önerilerde kalır; Uygula ile belgeye yazılır. Siz de belgeyi elle düzenleyebilirsiniz.
- Okuyanlar: diğer tüm ajanlar. Content Creator konu ağırlıklarını, Social Publisher en iyi saatleri, Outreach segment mesajlarını buradan alır.
Bu döngü OrqLabs'ın çekirdeğidir. Ayrıntı: Ajanlar analitiği nasıl kullanır.
Raporlar
Çoğu ajan bir rapor üretir: tür, başlık, özet, gövde, sayısal metrikler, yapısal veri ve öneriler. Raporlar sayfasında Sabitle ve Okundu eylemleri vardır. Uygula yalnızca uygulanabilir bir eylem taşıyan önerilerde çıkar: Analytics Strategist'in strateji değişiklikleri (belgeye yazar) ve Campaign Planner'ın önerdiği iş akışları (şablondan taslak iş akışı oluşturur). Diğer öneriler bilgi amaçlıdır.
Gönderilmeyi bekleyen ajan taslakları Onaylar sayfasına düşer: Content Creator gönderileri, otomatik yanıtı kapalı Community Manager'ın yorum yanıtları ve onayı açık Outreach Agent'ın ilk temas mesajları. Onayladığınızda gönderilir. Ajan kutusunda Rapor kaydet kapatılırsa rapor kaydedilmez ama report çıkışından yine akar.
Modeller
Her ajanın bir varsayılan modeli ve daha ucuz bir ekonomik seçeneği vardır. Seçim sırası: kutu modeli → iş akışı varsayılanı → organizasyon varsayılanı → platform varsayılanı (claude-opus-5). Planınız izin vermeyen bir model seçilirse çalıştırma başlamaz. Ayrıntı: Model seçimi ve fiyatlandırma.
İş akışında ajanlar
Her ajan agent.<ad> kutusudur: agent.contentCreator, agent.socialPublisher, agent.communityManager, agent.chatbot, agent.leadResearcher, agent.leadQualifier, agent.outreach, agent.marketAnalyst, agent.competitorAnalyst, agent.seoTraffic, agent.analyticsStrategist, agent.campaignPlanner, agent.reportWriter, agent.custom.
Ortak alanlar:
| Alan | Açıklama |
|---|---|
Ajan (agentId) | Kayıtlı bir ajan; boşsa katalog varsayılanları |
Görev (task) ① | Görev metni; ifadeler çalışır: {{ $json.topic }} hakkında gönderi yaz (Custom Agent'ta zorunlu) |
| Ajana özel girdiler ② | Her ajanın "Girdiler" tablosu |
Entegrasyonlar (integrationIds) | Ajanın kullanabileceği hesaplar |
| Model, Düşünme derinliği ③ | Gelişmiş bölümünde |
| Maks. araç adımı, Bütçe, Rapor kaydet ④ | 25 / 2 $ / açık |
İki çıkışı vardır: main (yapısal öğeler; örneğin Content Creator'da her gönderi ayrı öğe) ve report (tek rapor öğesi).
Aynı iş akışında farklı dallardaki ajanlar paralel çalışır. Birleştir kutusuyla sonuçları toplarsınız. Bir ajanın çıktısını başka bir ajana vermek için yalnızca bağlantı çizin; sonraki ajan gelen öğeleri bağlam olarak alır.
Ajanı tek başına çalıştırma
Ajanlar sayfasında karta tıklayın → Hızlı çalıştır → proje, görev ve girdiler → Çalıştır. Kayıtlı ajan için Yapılandırılmış → ajan → Çalıştır. Adım adım anlatım: İlk ajanınızı çalıştırma.
Sık sorulan sorular
Ajan yanlış bir şey yaparsa? Yazma yapan araçlar (yayınla, mesaj gönder, strateji güncelle) yalnızca ilgili ajanlarda vardır. Şablonlar onay adımıyla gelir. Ayrıca her çalıştırmanın adımlarını sonradan inceleyebilirsiniz.
Ajan hangi verimi görür? Yalnızca görevle ilgili veriyi: proje bilgileri, strateji, araç sonuçları. Tüm müşteri adayı veritabanı gönderilmez.
Bir ajan diğerini çağırabilir mi? İş akışında evet: bir ajanın çıkışını diğerine bağlarsınız. Campaign Planner ayrıca şablondan iş akışı oluşturabilir.
Türkçe çalışır mı? Evet. Proje dili Türkçe ise ajanlar Türkçe yazar. Görevi de Türkçe yazın.