Amigo Nedir?
Amigo, Croco.Team'in pazarlama operasyonları için geliştirdiği evrensel Telegram botudur. İçerik, sosyal medya ve analizler için ayrı araçlar kullanmak yerine Amigo; yapay zeka tarafından yönlendirilen ve kalıcı bellek ile güçlendirilen, modern bir pazarlama ekibinin ihtiyaç duyduğu her şeye tek bir arayüz üzerinden erişim sağlar.
Komut Sistemi
Amigo, tüm pazarlama iş akışını kapsayan 20'den fazla komut sunar:
/trends, sektörünüzle ilgili güncel trend konuları, kaynak atıfları ve etkileşim metrikleriyle birlikte ortaya çıkarır. /content, trend sinyalleri ve kampanya gereksinimlerine dayalı içerik fikirleri, taslaklar ve tam metinler oluşturur. /script, video senaryoları, podcast taslakları ve sunum anlatıları oluşturur. /reels, TikTok, Instagram Reels ve YouTube Shorts için optimize edilmiş kısa formlu video konseptleri üretir.
/image, sosyal medya gönderileri, reklamlar ve pazarlama materyalleri için yapay zeka tabanlı görsel oluşturma komutları hazırlar. /plan; zaman çizelgeleri, kaynak gereksinimleri ve başarı metriklerini içeren detaylı pazarlama planları oluşturur. /analyze, hedef kitle içgörüleri, rakip analizi ve performans tanıları sağlar.
/search, birden fazla kaynakta eş zamanlı olarak derinlemesine araştırma yapar. /translate, içeriği kelimesi kelimesine çevirmek yerine kültürel adaptasyonla çevirir. /marketing, her platformun gereksinimlerine göre uyarlanmış çok kanallı kampanya metinleri oluşturur. /twitter, optimize edilmiş tweetler, flood'lar (threads) ve yanıtlar oluşturur. /linkedin, profesyonel gönderiler, makaleler ve etkileşim stratejileri üretir.
Ek komutlar; blog içeriği, not alma, bellek yönetimi ve Notion ile Google Workspace gibi harici servislerle entegrasyonu kapsar.
Çok Kaynaklı Toplama
Bot, birden fazla kaynaktan içerik ve veri toplar:
SociaVault; etkileşim analizleri ve trend tespiti ile birlikte Twitter, Reddit ve TikTok içerik akışları sağlar. HikerAPI, rakip izleme ve içerik ilhamı için Instagram'a bağlanır. YouTube API; video araştırması, transkript çıkarma ve trend video analizine olanak tanır. Firecrawl, web araştırmalarını ve rakip içerik izlemeyi yönetir. OpenRouter, tek bir API üzerinden birden fazla modele erişim sağlayarak temel LLM arayüzü olarak hizmet verir.
Her kaynak, 30 dakikalık süreyle önbelleğe alınmış sonuçlar tutarak, zaman hassasiyeti olan işler için güncelliği sağlarken gereksiz API çağrılarını önler.
Bilgi Grafiği Belleği
Amigo, semantik arama için pgvector destekli PostgreSQL tabanlı kalıcı bir bilgi grafiği (knowledge graph) tutar. Varlık çıkarma (entity extraction), konuşmalarda adı geçen kişileri, şirketleri, ürünleri ve kavramları tanımlar. İlişki takibi, zamanla varlıklar arasında bağlantılar kurar.
Bellek sistemi, Amigo'nun önceki konuşmalara atıfta bulunmasını, kullanıcı tercihlerini hatırlamasını ve oluşturulmuş bağlam üzerine inşa etmesini sağlar. Her etkileşime sıfırdan başlamak yerine bot, tüm ekip üyelerine fayda sağlayan kurumsal bilgi birikimi toplar.
Outline entegrasyonu ek bellek sağlar; notlar, günlükler ve klasörler Outline wiki sunucusu ile çift yönlü olarak senkronize edilir. Outline'da oluşturulan yeni sayfalar Amigo'da aranabilir hale gelir; Amigo'daki konuşmalar Outline sayfaları oluşturabilir veya güncelleyebilir.
Model Mimarisi
Amigo, belirli modelleri sabit kodlamak yerine 10 farklı model rolü kullanır:
Chat, konuşma etkileşimlerini sıcaklık ve bağlam farkındalığı ile yönetir. Structured; JSON çıktı görevlerini, form doldurma ve veri çıkarma işlemlerini yürütür. Writer, pazarlama metinleri, blog yazıları ve sosyal içerikler üretir. Plan; proje planları, stratejiler ve yol haritaları oluşturur. Translate, diller arası içeriği kültürel adaptasyonla yönetir.
Marketing, kampanyaları optimize eder, hunileri (funnels) analiz eder ve dönüşüm odaklı metinler üretir. Embedding, semantik arama ve benzerlik tespiti için vektör temsilleri oluşturur. Image, görsel oluşturma komutlarını yönetir. Voice, ses transkripsiyonu ve sentezini işler. Video, video analizini ve klip oluşturmayı yönetir.
İş Akışı Hattı
Tüm çıktılar, tutarlı ton, doğru biçimlendirme ve uygun detay seviyeleri sağlayan LLM tabanlı dönüşümler uygulayan bir format-çıktı filtresinden geçer. Bir polish-çıktı (parlatma) adımı, nihai iyileştirme için regex dönüşümleri ve ek LLM temizliği uygular.
İş akışı hattı, ilk yanıtı hangi temel modelin oluşturduğuna bakılmaksızın tutarlı kalite sağlar.
Kritik Yapılandırma Notu
OpenRouter üzerinden akıl yürütme (reasoning) modelleri kullanılırken, @preset/manager kısmında Reasoning "OFF" (KAPALI) olarak ayarlanmalıdır. Akıl yürütme modelleri bazen boş (null) içerik döndürerek botun beklentilerini bozar. Akıl yürütmenin devre dışı bırakılması, tüm operasyonlar için kararlı çıktı sağlar.
Dağıtım
Amigo, Docker Compose üzerinde üç servis ile çalışır: 50501 portunda botun kendisi, 50504 portunda pgvector destekli PostgreSQL ve 50505 portunda Outline wiki sunucusu. Mastra iş akışı orkestrasyonu (v1.33.1 sürümüne sabitlenmiş), ajan sistemi genelindeki çok adımlı görevleri koordine eder.