Report Writer

Bu rehberde: Haftanın özetini işletme sahibi diliyle yazan ajanı tanırsınız. Ne toplar, kime göre yazar, nasıl gönderilir.

⏱ 8 dakika

Kimlik kartı#

Ne yapar?#

Report Writer dönemdeki ajan aktivitesini (çalıştırmalar, üretilen içerik, maliyet), içerik performansını, müşteri adayı hareketlerini, kampanya sonuçlarını ve Google Analytics özetini toplar. Tek, okunabilir bir rapor yazar: öne çıkanlar, sayılar, dikkat gereken konular, sonraki adımlar.

Analiz yapmaz; o Analytics Strategist'in işidir. Anlatır ve önceliklendirir. Raporu bildirim olarak gönderir.

Haftalık özetler ①'deki filtreyle "Haftalık özet" türü altında listelenir.

Girdiler#

Çıktılar#

main çıkışından tek öğe; report çıkışından haftalık özet.

{
  "title": "Haftalık özet – 15-21 Eylül 2026",
  "audience": "owner",
  "headline": "9 gönderi yayınlandı, 14 yeni nitelikli aday, bot 212 konuşmanın %81'ini çözdü; toplam AI maliyeti $6.40.",
  "sections": [
    { "title": "Öne çıkanlar", "bullets": ["LinkedIn 'demleme' gönderisi 1.240 tıklama getirdi", "3 aday toplantı aşamasına geçti"] },
    { "title": "Sayılar", "table": [["Metrik", "Bu hafta", "Geçen hafta"], ["Oturum", "3.120", "2.640"], ["Nitelikli aday", "14", "9"]] },
    { "title": "Dikkat", "bullets": ["Instagram erişimi 19 Eylül'de düştü", "2 onay 72 saati aşıp otomatik reddedildi"] },
    { "title": "Sonraki adımlar", "bullets": ["Strateji değişikliğini onayla", "WhatsApp şablonu onay bekliyor"] }
  ],
  "markdown": "# Haftalık özet …",
  "metrics": { "postsPublished": 9, "leadsQualified": 14, "botResolutionRate": 0.81, "llmCostUsd": 6.4 },
  "reportUrl": "https://app.orqlabs.com/app/org/reports/rep_…"
}

Kullandığı araçlar#

• get_agent_activity: dönemdeki ajan çalıştırmaları, durumları, maliyetleri.
• get_analytics_summary: GA4 özeti (bağlıysa).
• get_post_performance: yayınlanan gönderiler ve metrikleri.
• get_campaign_stats: kampanya gönderim/teslim/yanıt.
• list_leads: yeni, nitelikli, yanıtlayan, dönüşen adaylar.
• notify_owner: raporu bildirir.

Gerekli hesaplar#

Yoktur. Bağlı olan her veri kaynağı rapora eklenir; olmayanlar atlanır.

Örnek görev metinleri#

1. "Geçen haftanın özetini işletme sahibi için yaz: en fazla 250 kelime, 5 sayı, 3 aksiyon."
2. "Pazarlama ekibi için 30 günlük ayrıntılı rapor; her ajanın ne yaptığını ve maliyetini ayrı başlıkta ver."
3. "{{ $vars.clientName }} müşterisi için haftalık rapor; OrqLabs adını geçirme, 'ekibimiz' de."
4. "Yalnızca aday ve outreach sonuçlarına odaklan; sosyal medyayı tek cümleyle geç."
5. "Raporu Slack'e uygun kısa biçimde yaz (başlık + 6 madde), sonra tam sürümü rapor olarak kaydet."

İpuçları#

• Ajans kullanımında her müşteri (proje) için ayrı kayıtlı Report Writer oluşturup Ek talimatlar ile markalama kurallarını verin.
• İşletme sahibi seçeneğinde sayılar yuvarlanır; tam sayı isteyen ekipler için "ekip" seçin.
• Raporu e-posta veya Slack'e göndermek için iş akışına Bildir kutusu ekleyin: kanallar [email, slack], link {{ $json.reportUrl }}.

Beklenen rapor#

Haftalık özet: başlık cümlesi, öne çıkanlar, sayılar tablosu (bu dönem / önceki dönem), ajan aktivitesi (çalıştırma, maliyet), dikkat gereken konular (hatalar, bekleyen onaylar, bütçe uyarıları), sonraki adımlar, ilgili raporlara bağlantılar. Metrikler: yayınlanan gönderi, oluşturulan aday, nitelikli aday, açılan konuşma, bot çözüm oranı, oturum, yapay zekâ maliyeti.

Maliyet beklentisi#

7 günlük özet, 5-6 araç çağrısı (~40K giriş / ~4K çıkış):

30 günlük rapor yaklaşık iki katıdır. Ekonomi model çoğu özet için yeterlidir.

İş akışında kullanım#

Hazır şablon yoktur. Önerilen:

Zamanlama (Pazartesi 08:00, Europe/Istanbul) → Report Writer (7 gün, işletme sahibi)
→ Bildir (başlık {{ $json.report.title }}, gövde {{ $json.report.headline }}, kanallar [inapp, email], link {{ $json.reportUrl }})

Analitik incelemesiyle zincirleme: Analytics Strategist → Report Writer ("Teknik incelemeyi işletme sahibi diliyle özetle"). Slack'e: Report Writer → Mesaj gönder (Slack, kanal C0123, metin {{ $json.report.headline }}).

Sık karşılaşılan sorunlar#

Sık sorulan sorular#

Her Pazartesi otomatik gelir mi? Zamanlama tetikleyicili bir iş akışı kurarsanız evet. E-posta bildirimi için Bildir kutusu ekleyin.

Analytics Strategist ile farkı ne? Strategist analiz eder ve strateji değiştirir. Report Writer anlatır; karar önermez, olanı özetler.

Müşterime gösterebilir miyim? Evet. "Ekibimiz" dili ve markalama kuralları için kayıtlı ajan oluşturun.

Sonraki adım#

• Analytics Strategist
• Raporlar ve istatistikleri anlama
• Kullanım ve maliyet takibi