Kendi ajanınız

Varsayılan olarak Borkol bir çalıştırmanın her adımını OpenRouter anahtarınızla çalıştırır. Zaten kendi ajanınızı, örneğin Hermes Agent çalıştırıyorsanız adımları kendi modelleriyle o yapabilir. Borkol marka bağlamını, akışı ve kontrolleri tutar; ajanınız işi alır, Borkol'un kullanacağı aynı brifingi okur ve sonuçları geri gönderir. Sizin için hiçbir şey değişmez: isteğinizi yine Genel bakış sayfasına yazarsınız ve senaryolar yine Senaryolar altına gelir.

Kurulum üç şey gerektirir: bir token, ajanınıza yapıştırılan üç kurulum bloğu ve Ajanınız olarak ayarlanmış marka.

Token oluşturun#

Pazarlama → Ayarlar → Bağlantılar → Daha fazla · Kendi ajanınız (/m/marketing/settings/integrations?section=agent), ajanlarınızın bağlanmak için kullandığı token'ları listeler. Önceden ayarlarda kendi bölümündeydi; eski adres /m/marketing/settings/agent onu hâlâ açar.

1. Token oluştur düğmesine tıklayın ve bir Ad verin, örneğin "Dizüstü bilgisayarımdaki Hermes".
2. Token oluştur düğmesine tıklayın. Sonraki pencere bka_ ile başlayan token'ı gösterir. Token'ı şimdi kopyalayın: yalnızca bir kez gösterilir. Pencereyi kapattıktan sonra yalnızca son dört karakteri görünür ve Borkol'da kimse onu yeniden gösteremez.
3. Aynı pencere, token'ınız doldurulmuş olarak üç kurulum bloğunu gösterir (aşağıya bakın). Gerekenleri kopyalayın ve Tamam düğmesine tıklayın.

Oluşturma penceresindeki Daha fazla, varsayılan olarak kapalı iki isteğe bağlı sınır içerir:

Bir token etkin olduğunda listenin altındaki bir satır Yapay zeka akışı bölümüne bağlantı verir; orada bir marka için Adımların çalıştığı yer ayarını Ajanınız yaparsınız.

Liste her token için Ad, Token altında son dört karakteri, Marka, Son kullanım (ajan ilk kez bağlanana kadar Hiç) ve Durum (Etkin veya İptal edildi) gösterir.

Token'ları yalnızca hesap sahibi oluşturabilir ve iptal edebilir. Ekip üyeleri listeyi "Token'ları yalnızca hesap sahibi oluşturabilir veya iptal edebilir." notuyla görür.

Üç kurulum bloğu#

Tek seferlik pencere blokları token'ınızla birlikte gösterir. Token listesinin altındaki Kurulum talimatları aynı blokları daha sonra, token yerine <token'ınız> ile gösterir: oraya kendi token'ınızı yapıştırın.

Hermes ile#

1. Ajan yapılandırması (Hermes) bloğunu ~/.hermes/config.yaml dosyasına ekleyin.
2. Skill'i kurun: hermes skills install https://api.borkol.com/mcp/marketing/SKILL.md (Skill bloğundaki adres).
3. Zamanlama satırını bir kez çalıştırın. Hermes zamanlanmış işleri kendi gateway'inde çalıştırır, bu yüzden hermes gateway çalışır durumda kalsın.

Hemen denemek için Hermes'e "Use the borkol-marketing skill: check Borkol for work and do it." deyin.

Başka bir MCP istemcisi#

Sunucu HTTP üzerinden Model Context Protocol konuşur, bu yüzden her MCP istemcisi bağlanabilir. İstemciyi yapılandırma bloğundaki sunucu adresine yönlendirin ve token'ı Authorization: Bearer <token> olarak gönderin. Skill metni her ajan için talimat olarak çalışır.

Bir markayı ajanınıza geçirin#

Pazarlama → Ayarlar → Yapay zeka akışı → Daha fazla → Adımları kim çalıştırır tek bir alan içerir, Adımların çalıştığı yer: Borkol (varsayılan) veya Ajanınız. Her yapay zeka akışı ayarı gibi marka başınadır ve alttaki çubukla kaydedilir. Başlamış çalıştırmalar ayarlarını korur. Ajanınız seçiliyken adım modelleri geçerli değildir: ajanınız kendi modellerini seçer ve sayfa bunu modellerin üstünde belirtir.

Henüz token yokken Ajanınız seçilirse "Ajanınızın henüz bir token'ı yok. Kendi ajanınız bölümünden bir tane oluşturun." yazısı token sayfasına bağlantıyla görünür.

Ajanınızda çalışan bir marka OpenRouter anahtarı gerektirmez: anahtar olmadan çalıştırma başlatabilirsiniz.

Ajan ne yapar#

Ajanınız Borkol Marketing sunucusundaki şu araçlarla çalışır:

Her sonuç, Borkol'un kendi çalıştırdığı bir adımla aynı biçim ve limitlere göre kontrol edilir: senaryo sayısı, senaryo başına hook sayısı, izin verilen etiketler. Yanlış biçimdeki çıktı, hatalı alanı belirten bir hata olarak ajana döner; ajan düzeltip yeniden gönderir. Geçerli bir sonuç gelene kadar adım açık kalır. Senaryolar reklam kodlarını alır ve kontrolden tam olarak Borkol'daki gibi geçer.

Ajanınızın gönderdikleri talimat değil, veridir: sonraki brifinglerde yalnızca alıntı olarak yer alır ve kontrol, talimat benzeri metni tekrarlayan bir senaryoyu başarısız sayar. Ajanın araştırma sırasında önerdiği bilgi kayıtları, diğer çalıştırmaların önerileri gibi Bilgi altında kabul bekler.

Reklam sonuçlarını bildirme#

Reklam platformunuzu okuyabilen bir ajan, sizin bir dosya içe aktarmanız yerine sonuçları report_metrics ile Borkol'a gönderebilir. Sonuçlar bir reklam sonuçları içe aktarması ile tam olarak aynı şekilde saklanır ve öğrenimleri besler. Token'ın Sonuçları geri gönderme (work:submit) yetkisi olmalıdır; yoksa araç sunulmaz.

Argümanlar:

Her satır:

Her satır dosya içe aktarmasıyla aynı kurallarla kontrol edilir. Kontrolden geçmeyen satır dışarıda bırakılır ve dizini, alanı ve nedeniyle errors altında listelenir; diğer satırlar kaydedilir. Yanıt {ok, created, updated, matched, unmatched, skipped, errors} şeklindedir: matched satırlar reklam kodları üzerinden bir senaryoya bağlanmıştır, unmatched satırlar saklanır ve senaryo oluştuğunda bağlanır, skipped satırlar Meta reklamları bağlantısının zaten eşitlediği bir reklam ve güne aittir, böylece asla iki kez sayılmaz. Aynı reklamı ve günü yeniden göndermek onu günceller.

Tüm çağrıyı durduran hatalar:

Tek bir markayla sınırlı bir token brand_id göndermeyebilir.

Çalıştırma sayfasında#

Ajanınızda çalışan bir çalıştırma Ayrıntılar altında Çalıştığı yer: Ajanınız gösterir ve adımları iki ek durum gösterebilir:

Takılan bir adım çalıştırmanın üstüne bir satır ekler: "Ajanınız bir adımı zamanında almadı. Ajanınızın çalıştığını ve zamanlamasının açık olduğunu kontrol edin ya da markayı yeni çalıştırmalara açmak için çalıştırmayı iptal edin.", Kendi ajanınız bağlantısıyla. Zil takılan her adım için bir bildirim gösterir ("Ajanınız {step} adımını almadı: {istek}") ve mobil uygulama bunu anlık bildirim olarak gönderir. Ajan adımı aldığında normal şekilde devam eder. Takılan bir çalıştırma markası için hâlâ etkin sayılır; Aynı anda çalıştırma 1 iken o markanın yeni çalıştırmaları onun arkasında bekler: markayı serbest bırakmak için çalıştırmayı iptal edin.

Ajanınızın başlattığı ama bir saat içinde bitirmediği bir adım Ajanınız bekleniyor durumuna döner, böylece bir sonraki kontrol onu yeniden alabilir.

Maliyet#

Ajanınız kendi modellerinin ücretini öder; OpenRouter anahtarınızdan hiçbir şey alınmaz. Ajan maliyetini bildirdiğinde çalıştırma sayfası bunu adım başına ve toplamda ajanınız tarafından bildirildi olarak gösterir. Bildirim isteğe bağlıdır, bu yüzden bildirimi olmayan bir adım maliyet göstermez ve hiç bildirimi olmayan bir çalıştırma Ajanınız tarafından bildirilmedi gösterir. Model yalnızca ajan bildirdiyse görünür.

Çalıştırma başına maliyet sınırı yalnızca Borkol'da çalışan çalıştırmalar için geçerlidir. Ajanınızda çalışan bir çalıştırma maliyet limitinde asla duraklatılmaz.

Token iptal edin#

Etkin bir token'ın satır menüsünde İptal et bulunur. "Bu token iptal edilsin mi?" onayından sonra onu kullanan ajan artık bağlanamaz ve satır İptal edildi gösterir. Bu işlem geri alınamaz: yeni bir token oluşturun ve ajanın yapılandırmasını güncelleyin. Ajanın üstlendiği bir adım hemen Ajanınız bekleniyor durumuna döner, böylece başka bir ajan onu alabilir.

Kim ne yapabilir#

Token oluşturmak ve iptal etmek yalnızca hesap sahibine açıktır. Adımların çalıştığı yer ayarını değiştirmek, yapay zeka akışının geri kalanı gibi pazarlama düzenleme erişimi gerektirir. Okuma erişimi olan üyeler token listesini ve çalıştırma sayfalarını görür.