Bu rehberde: Bir ajanı iş akışına koymadan, tek başına çalıştırırsınız. Örnek olarak Market Analyst ile hızlı bir pazar taraması yaparsınız. Adımları canlı izler, raporu okur ve ajanı kayıtlı hâle getirirsiniz.
⏱ 15 dakika
Neden tek başına çalıştırmalı?
Ajanı tek başına denemek, görev metninizi ve ayarlarınızı öğrenmenin en hızlı yoludur. Sonuçtan memnun kalınca aynı ayarları iş akışına taşırsınız.
Market Analyst entegrasyon gerektirmez. Serper veya Tavily bağlıysa sonuç daha zengin olur.
Adım 1: Ajan kataloğu
Sol menüden Ajanlar sayfasını açın.
- ① Katalog: 14 ajan türü. Her kartta kategori, varsayılan model ve önerilen entegrasyonlar yazar.
- ② Yapılandırılmış: kendi kaydettiğiniz ajanlar (özel talimat, araç seti, model, bellek).
- ③ Hızlı çalıştır: ayar kaydetmeden tek seferlik çalıştırma.
Bir kartı açtığınızda Hızlı çalıştır, Yapılandır ve Kurulum rehberi seçenekleri görünür.
Adım 2: Tek seferlik çalıştırma
- Market Analyst kartında Hızlı çalıştır düğmesine basın. Bir pencere açılır.
- Formu doldurun:
| Alan | Ne yazmalı |
|---|---|
| Proje | Kahve Durağı |
| Görev ② | "Türkiye'de online özel kahve (specialty) pazarını değerlendir. Büyüklük, büyüme, ana oyuncular, fiyat bantları ve bizim için 3 fırsat çıkar. Kaynak ver." |
| Research focus ③ | "Türkiye online specialty kahve pazarı" |
| Region ③ | "Türkiye" |
| Depth ③ | quick (ilk deneme için hızlı tarama) |
| Model | Boş bırakın (varsayılan) veya planınıza uygun claude-sonnet-5 |
| Düşünme derinliği | Orta |
| Maks. araç adımı | 20 |
| Çalıştırma başına bütçe (USD) | 1 |
- Çalıştır düğmesine basın. Çalıştırma sıraya alınır ve birkaç saniye içinde başlar.
quick derinlikte çalıştırma genellikle 1-3 dakika sürer ve dengeli modelde 15-40 sent tutar.
Geliştirici notu: API karşılığı
POST /orgs/:orgId/agents/run { type: "MARKET_ANALYST", task, input: { focus, region, depth }, projectId, modelId? }.
Adım 3: Adımları izleyin
Çalıştırma sayfası adımları canlı akıtır.
| Adım türü | Ne görürsünüz |
|---|---|
| Düşünme ① | Modelin plan özeti (kısaltılmış) |
| Araç çağrısı ② | Araç adı ve girdisi. Örneğin: web_search { query: "Türkiye kahve pazarı 2026 rapor" } |
| Araç sonucu | Sonuç özeti ve süre. Hata varsa kırmızı işaret |
| Mesaj | Ara veya son metin |
| Hata | Çalıştırmayı durduran hata |
Üst çubukta toplam token, tahmini maliyet ve adım sayacı yer alır. İptal düğmesi o ana kadar üretilen kısmi sonucu kaydeder.
Adım 4: Sonuç ve rapor
Çalıştırma bittiğinde üç şey görürsünüz:
- Özet: tek paragraf.
- Çıktı: yapısal veri. Market Analyst için
report,segments,opportunities,sourcesbölümleri. - Rapor: Raporlar sayfasında "Pazar araştırması" türünde yeni kayıt.
Raporun sonundaki ③ önerilerde Uygula düğmesi yalnızca otomatik uygulanabilir olanlarda aktiftir. Örneğin: "Strateji belgesine 'Ofis satın alma' segmentini ekle".
Diğer bitiş durumları: bütçe aşıldı (kısmi çıktı kaydedilir), adım sınırı (maks. adım doldu), hata (nedeni gösterilir).
Adım 5: Kayıtlı ajan oluşturun
Aynı ayarları tekrar girmemek ve bellek kullanmak için ajanı kaydedin.
- Ajanlar sayfasında Market Analyst kartında Yapılandır düğmesine basın.
- Formu doldurun:
| Alan | Açıklama |
|---|---|
| Ajan adı ① | "Pazar analisti – kahve" |
| Proje ① | Markanız |
| Model ve düşünme derinliği ② | Varsayılan model. Fiyat yanında görünür |
| Ek talimatlar | Ek kurallar: "Her iddiaya kaynak ver. Rakamları TL ve USD yaz. 800 kelimeyi geçme." |
| Sistem prompt'unu değiştir | Tüm ana talimatı değiştirir. İleri düzey; katalog davranışını kaybedersiniz |
| Araçlar ③ | Kullanabileceği araçlar. Örneğin sayfa okumayı kapatmak |
| Entegrasyonlar | Kullanabileceği hesaplar |
| Varsayılan girdiler ④ | Ajana özel girdi varsayılanları: depth: standard, region: Türkiye |
| Maks. araç adımı, bütçe ⑤ | Sınırlar |
- Kaydet düğmesine basın. Artık Ajanlar → Yapılandırılmış → Çalıştır ile tek tıkla çalışır. İş akışı node'unda da seçilebilir.
Kayıtlı ajanlar çalıştırmalar arasında bellek tutar. Market Analyst önceki raporunun ana bulgularını hatırlar ve tekrar etmek yerine değişimi vurgular. Belleği ajan sayfasındaki Bellek → Sıfırla ile temizlersiniz.
Denemeye değer diğer ajanlar
| Ajan | Hızlı görev | Gereken |
|---|---|---|
| Content Creator | "LinkedIn için abonelik kutumuzu anlatan 2 gönderi" | – |
| Competitor Analyst | Rakipler: "Petra Roasting", "Kronotrop"; boyutlar: mesaj, fiyat | Serper önerilir |
| Lead Researcher | Profil: "İstanbul'da 10-50 çalışanlı, ofis kahvesi satın alan teknoloji şirketleri", 10 adet | Serper + Hunter |
| SEO & Traffic | Proje sitesi, 10 sayfa | Search Console önerilir |
| Report Writer | Dönem: son 7 gün, hedef okuyucu: işletme sahibi | – |
Maliyeti kontrol altında tutma
- İlk denemelerde bütçe 1 USD, maks. adım 15-20.
- Ekonomi modelini (
claude-haiku-4-5,gpt-5-mini) sınıflandırma ve kısa içerik için; dengeli modeli içerik ve müşteri adayı işleri için; amiral gemisini strateji ve derin araştırma için kullanın. - Ayarlar → Kullanım sayfası her çalıştırmanın maliyetini model ve ajan bazında listeler.
Sık sorulan sorular
Ajan yanlış bir şey yaparsa ne olur? Tek seferlik çalıştırma yalnızca rapor üretir; yayın yapmaz, mesaj göndermez. Yazma yapan ajanları (Social Publisher, Outreach) iş akışında onay adımıyla kullanın.
Görevi Türkçe yazabilir miyim? Evet. Ajan Türkçe anlar ve proje dili Türkçe ise Türkçe yazar.
Kayıtlı ajan ile hızlı çalıştırma arasındaki fark ne? Kayıtlı ajan ayarlarını saklar ve bellek tutar. Hızlı çalıştırma her seferinde sıfırdan başlar.
Çalıştırma çok uzun sürüyor, ne yapmalıyım?
İptal deyin. Kısmi sonuç kaydedilir. Sonra derinliği quick yapın veya maks. adımı düşürün.