Müşteri brifinden yayındaki gönderilere: Bir ajanın yönettiği tam bir hafta, çağrı çağrı
Shager'da bir müşteri haftası örneği: brif, medya yükleme, hesap bazında taslaklar, inceleme, müşteri onayı, planlama, yayın kontrolü ve raporlama.
Bir ajanla müşteri brifinden yayındaki gönderilere ulaşmak sekiz aşamadan geçer: erişimi ve çalışma alanını doğrulamak, bağlı hesapları kontrol etmek, medyayı yüklemek, plan yapmak, hesap bazında açıklamalarla taslak hazırlamak, incelemek, müşteri onayını almak, ardından planlayıp doğrulamak. Her aşamada yoğun işi ajan yapar. İnsan ise üç karar verir: planı onaylamak, yayınlama yetkisini vermek ve müşteri istiyorsa, müşterinin bir onay linki üzerinden kendi onayını vermesi.
Aşağıda kurgusal bir müşteri için gerçekçi bir hafta var; ajanın yaptığı her Shager çağrısıyla, sırasıyla. Müşterimiz Harbor Coffee'nin 14 kafesi var; her birinin bir Facebook Sayfası ve bir Instagram profesyonel hesabı bulunuyor, bir de marka için tek bir YouTube kanalı.
Pazartesi sabahı: Brif geliyor
Müşteri temsilcisi, müşterinin bağlam klasörüne bir brif bırakıyor: yeni bir sonbahar içeceği, perşembe günü lansman, ilk hafta sonu için yüzde 20 indirim, 25 saniyelik dikey bir video ve müşterinin CDN'inde barındırılan iki fotoğraf. Başka hiçbir şey yok. Ajanın kalıcı talimatları, brifte yazmayan hiçbir şeyi uydurmasını yasaklıyor; bu yüzden kullanacağı tek bilgiler indirim, tarih ve ürün adı.
Oturum müşterinin klasöründe başlıyor; dolayısıyla ajanda ajansın kuralları ve Harbor Coffee'nin marka sesi dosyası yüklü, diğer müşterilere dair hiçbir şey yok. Bunun neden önemli olduğunu tek ajan, çok müşteri yazısında anlattık.
1. aşama: Kim ve nerede, doğrulayın
whoami -> organization, claimed or sandbox, key scopes
list_workspaces -> "Harbor Coffee" (ws_harbor), timezone Europe/London
whoami, iş başlamadan önce iki soruyu yanıtlar: Bu kuruluş sahiplenilmiş mi ve anahtarda publish var mı? Sahiplenilmemiş bir test ortamıysa ajan yine yükleme yapıp taslak hazırlayabilir, ama bir insan sahiplenene kadar planlama ve onay talepleri açık bir hatayla başarısız olur. Sahiplenme süreci /auth.md adresinde anlatılıyor.
2. aşama: Hesapları kontrol edin
list_channels ws_harbor -> 29 channels: 14 Facebook, 14 Instagram, 1 YouTube
list_groups ws_harbor -> "All cafes FB", "All cafes IG", "Brand YouTube"
Ajan her kanalın durumuna bakıyor. Bir Instagram hesabının bağlantısı kopmuş görünüyor. Ajan bunu görmezden gelip taslağı onsuz hazırlamak yerine, o kafenin müdürü için bir bağlantı linki oluşturuyor:
{
"tool": "create_connect_link",
"arguments": { "workspace_id": "ws_harbor", "label": "Harbor Quayside, Instagram reconnect" }
}
Müşteri temsilcisi linki iletiyor. Kafe müdürü, Shager hesabı olmadan bu link üzerinden Instagram'a giriş yapıyor ve hesap aynı gün içinde list_channels listesine geri dönüyor.
3. aşama: Medyayı yükleyin
Her dosya için bir tane olmak üzere üç çağrı. Video boyutlarını ve süresini de taşıyor; böylece Reels ve Shorts doğrulaması yayın anında değil, şimdi yapılabiliyor.
{
"tool": "upload_media_from_url",
"arguments": {
"workspace_id": "ws_harbor",
"url": "https://cdn.harbor-coffee.example/autumn/launch.mp4",
"file_name": "autumn-launch.mp4",
"width": 1080, "height": 1920, "duration_ms": 25000
}
}
İki fotoğraf da aynı şekilde, video alanları olmadan yükleniyor.
4. aşama: Plan yapın ve bekleyin
Ajan hemen taslak yazmak yerine bir plan öneriyor:
| Gün | Gönderi | Format | Hedef |
|---|---|---|---|
| Salı | Merak uyandıran fotoğraf | FEED | All cafes FB, All cafes IG |
| Perşembe | Lansman videosu | REEL / SHORT | All cafes FB, All cafes IG, Brand YouTube |
| Cumartesi | İndirim hatırlatma fotoğrafı | FEED | All cafes FB, All cafes IG |
Müşteri temsilcisi "devam" diye yanıtlıyor ve cumartesi gönderisini cuma öğleden sonraya alıyor. Tek bir mesaj; zayıf bir plan asla 85 ayrı hesap açıklamasına dönüşmüyor.
5. aşama: Hesap bazında açıklamalarla taslak hazırlayın
Planlanan her gönderi, schedule_at olmadan yapılan tek bir create_post çağrısına dönüşüyor; bu da bir taslak kaydediyor. Lansman gönderisi tam yapıyı gösteriyor:
{
"tool": "create_post",
"arguments": {
"workspace_id": "ws_harbor",
"group_ids": ["grp_all_fb", "grp_all_ig", "grp_brand_yt"],
"media_ids": ["med_launch"],
"caption": "The autumn drink is here. 20% off this weekend.",
"youtube_title": "Harbor Coffee autumn drink, first pour",
"youtube_privacy": "public",
"cta_url": "https://harbor-coffee.example/autumn",
"campaign": "autumn-launch",
"label": "Harbor autumn launch video",
"first_comment": "Find your nearest Harbor and the weekend offer: https://harbor-coffee.example/autumn",
"per_channel": [
{ "channel_id": "ch_fb_quayside", "format": "REEL",
"caption": "Quayside regulars, it's here. Autumn's first pour, 20% off this weekend." },
{ "channel_id": "ch_ig_quayside", "format": "REEL",
"caption": "First pour at Quayside. 20% off all weekend, details in bio." },
{ "channel_id": "ch_yt_brand", "format": "SHORT",
"caption": "The new Harbor autumn drink, poured for the first time." }
]
}
}
Gerçek çağrıda per_channel 29 girdi içeriyor ve her açıklama o kafeye özgü. Açıklamalardaki ve yorumlardaki her URL, yayın anında o hesaba özel bir kısa linke dönüşüyor ve utm_content hesabı tanımlıyor; bu yüzden ajan düz URL'ler yazıyor. Açıklamaları çeşitlendirme zanaatı yapay zekâ ile hesap bazında açıklama çeşitlemesi yazısında.
6. aşama: Ayrı bir turda inceleyin
Yalnızca okuma araçlarıyla ve bir inceleme komutuyla çalışan ikinci bir oturum, status değeri DRAFT olarak list_posts çağırıyor ve her taslak için get_post çalıştırıyor. Kopya açıklamaları, brifte olmayan bilgileri, tıklanamayacağı yerlere konmuş linkleri ve dikey olmayan medyadaki video formatlarını kontrol ediyor. Bu sefer, link biyografide olduğu halde "link aşağıda" diyen iki Instagram açıklamasını işaretliyor. Taslak ajanı, düzeltilmiş taslaklar oluşturarak bunları düzeltiyor; eskileri planlamaya alınmıyor.
7. aşama: Müşteri onayı
Harbor Coffee'nin çalışma alanında approval_required açık; yani müşteri onaylamadan hiçbir şey planlanamaz. Ajan her taslağı onaya gönderiyor:
{
"tool": "request_approval",
"arguments": {
"workspace_id": "ws_harbor",
"post_id": "pst_launch",
"reviewer_name": "Dana, Harbor Coffee marketing",
"reviewer_email": "dana@harbor-coffee.example",
"send_email": true
}
}
Müşteri linki açıyor, gönderiyi inceliyor ve giriş yapmadan onaylıyor. Gönderinin durumu IN_REVIEW üzerinden APPROVED durumuna ya da CHANGES_REQUESTED durumuna geçiyor; ikincisinde ajan düzeltip yeniden gönderiyor. İyi onay kurallarının nasıl tasarlanacağını ajan gönderileri için insan onayı yazısında ele aldık.
8. aşama: Planlayın ve doğrulayın
Onaydan sonra planlama adımı publish kapsamına sahip bir anahtarla çalışıyor. Ajan her saati çalışma alanının saat diliminde, o tarihe ait farkla hesaplıyor:
{
"tool": "schedule_post",
"arguments": {
"workspace_id": "ws_harbor",
"post_id": "pst_launch",
"schedule_at": "2026-10-15T08:30:00+01:00"
}
}
Facebook ve Instagram'da 14'er hesap ve varsayılan 30 ila 90 saniyelik aralıklarla her platformun gönderimi yaklaşık 13 dakika sürüyor; iki platform paralel çalışıyor. Perşembe saat 9.15'te ajan get_post çağırıyor. Yirmi sekiz hesap, canlı URL'leriyle yayınlanmış görünüyor. Birinde izin hatası var. Ajan hesabı adıyla raporluyor ve yeni bir bağlantı linki öneriyor; körü körüne yeniden denemiyor.
Ertesi pazartesi: Rapor
Hafta raporla kapanıyor: Neyin yayına çıktığı için list_posts, hesap bazındaki sonuçlar için get_post, hafta boyunca hesap ve gönderi başına tıklamalar için de get_analytics; müşteri paylaşırsa bunlar utm_content üzerinden CRM'deki potansiyel müşterilerle eşleştiriliyor. Gözetimsiz çalıştırma dahil kurulumun tamamı ajanın hazırladığı haftalık müşteri raporu yazısında.
Kim ne yaptı
| Aşama | Ajan | İnsan |
|---|---|---|
| Erişim ve çalışma alanı | Kontrol eder, durumu bildirir | |
| Hesaplar | Kopuk olanı bulur, linki oluşturur | Linki iletir |
| Medya ve plan | Yükler, önerir | "Devam" der |
| Taslaklar ve inceleme | 85 açıklama yazar, inceler | |
| Onay | Linkleri gönderir | Müşteri onaylar |
| Planlama | Saatleri hesaplar, planlar | publish yetkisini bir kez verir |
| Yayın ve rapor | Doğrular, raporlar | Raporu okur |
SSS
Böyle bir hafta bir insanın ne kadar zamanını alır?
Bu örnekteki insan kararları birkaç mesaj ve bir onaydan ibaret. Kesin süre müşteriye ve planın ne kadar gidip gelme gerektirdiğine bağlı. Değişen, işin türü: açıklama yazmak ve link oluşturmak yerine incelemek ve karar vermek.
Ajan rutin gönderilerde müşteri onayını atlayabilir mi?
Yalnızca çalışma alanı onay gerektirmiyorsa. approval_required çalışma alanı bazında ayarlanır; aylık planı onaylayan bir müşteride kapalı olabilir, temkinli bir müşteride açık kalır. Ajan mevcut bir çalışma alanında bu ayarı kendi başına değiştiremez.
Müşteri onaydan sonra değişiklik isterse ne olur?
Gönderinin yayını başlamadıysa ajan cancel_post çağırır; bu, gönderiyi onaylanmış bir taslağa döndürür. Ardından düzeltilmiş bir sürüm oluşturup yeniden onaya gönderir. Yayın başladıktan sonra platformların kendisindeki değişiklikler elle yapılması gereken bir iştir.
Bundan sonra
Her şeye uygulamadan önce bu sırayı küçük bir hesap grubu olan tek bir müşteride çalıştırın. Ajanınız henüz bağlı değilse ajanlar için giriş sayfası MCP sunucusunu, REST API'yi ve kendi kendine kaydı anlatıyor.
