Ce este Amigo?
Amigo este botul universal de Telegram al Croco.Team pentru operațiuni de marketing. În loc de instrumente separate pentru conținut, social media și analize, Amigo oferă o interfață unificată pentru tot ceea ce are nevoie o echipă de marketing modernă – condusă de AI și augmentată de o memorie persistentă.
Sistemul de Comenzi
Amigo expune peste 20 de comenzi care acoperă întregul flux de lucru de marketing:
/trends evidențiază subiectele actuale în tendințe relevante pentru industria dumneavoastră, cu atribuire a sursei și metrici de engagement. /content generează idei de conținut, schițe și drafturi complete bazate pe semnalele de tendințe și pe cerințele campaniei. /script creează scenarii video, schițe de podcast și narațiuni pentru prezentări. /reels generează concepte de video scurt optimizate pentru TikTok, Instagram Reels și YouTube Shorts.
/image generează prompt-uri pentru generarea de imagini AI pentru postări social media, reclame și materiale de marketing. /plan creează planuri de marketing detaliate, cu cronograme, cerințe de resurse și metrici de succes. /analyze oferă perspective asupra audienței, analiză a competitorilor și diagnostice de performanță.
/search efectuează cercetări profunde pe mai multe surse simultan. /translate gestionează traducerea conținutului cu adaptare culturală, în loc de o conversie literală, cuvânt cu cuvânt. /marketing generează texte de campanie multi-canal adaptate pentru cerințele fiecărei platforme. /twitter creează tweet-uri, thread-uri și răspunsuri optimizate. /linkedin produce postări profesionale, articole și strategii de engagement.
Comenzile suplimentare acoperă conținutul pentru blog, luarea notițelor, gestionarea memoriei și integrarea cu servicii externe precum Notion și Google Workspace.
Agregarea Multi-Sursă
Botul agregă conținut și date din mai multe surse:
SociaVault oferă fluxuri de conținut de pe Twitter, Reddit și TikTok, cu analize de engagement și detectarea tendințelor. HikerAPI se conectează la Instagram pentru monitorizarea competitorilor și inspirație pentru conținut. YouTube API permite cercetarea video, extragerea transcrierilor și analiza videoclipurilor în tendințe. Firecrawl gestionează cercetarea web și monitorizarea conținutului competitorilor. OpenRouter servește ca interfață principală LLM, oferind acces la multiple modele printr-un singur API.
Fiecare sursă menține rezultate în cache cu o expirare de 30 de minute, evitând apelurile API redundante și asigurând în același timp prospețimea pentru activitățile sensibile la timp.
Memoria de tip Knowledge Graph
Amigo menține un graf de cunoștințe (knowledge graph) persistent, susținut de PostgreSQL cu pgvector pentru căutare semantică. Extracția de entități identifică persoane, companii, produse și concepte menționate în conversații. Urmărirea relațiilor construiește conexiuni între entități de-a lungul timpului.
Sistemul de memorie permite Amigo să facă referire la conversații anterioare, să rețină preferințele utilizatorului și să construiască pe baza contextului stabilit. În loc să înceapă fiecare interacțiune de la zero, botul acumulează cunoștințe organizaționale care beneficiază toți membrii echipei.
Integrarea Outline oferă memorie suplimentară – notițele, jurnalele și folderele se sincronizează bidirecțional cu serverul wiki Outline. Noile pagini create în Outline devin căutabile în Amigo; conversațiile din Amigo pot crea sau actualiza pagini Outline.
Arhitectura Modelului
Amigo folosește 10 roluri de modele distincte, în loc să codifice direct modele specifice:
Chat gestione interacțiunile conversaționale cu căldură și conștientizare contextuală. Structured gestionează sarcinile cu output JSON, completarea formularelor și extragerea datelor. Writer produce texte de marketing, postări pe blog și conținut pentru rețelele sociale. Plan generează planuri de proiect, strategii și foarfe de drum (roadmaps). Translate gestionează conținutul multilingv cu adaptare culturală.
Marketing optimizează campaniile, analizează pâlniile de conversie și generează texte axate pe conversie. Embedding creează reprezentări vectoriale pentru căutare semantică și detectarea similitudinii. Image gestionează prompturile pentru generarea de imagini. Voice procesează transcrierea și sinteza audio. Video gestionează analiza video și generarea de clipuri.
Workflow Pipeline
Toate output-urile trec printr-un filtru de format-output care aplică o transformare bazată pe LLM - asigurând un ton consistent, formatare corectă și niveluri de detaliu adecvate. Un pas de polish-output aplică transformări regex și o curățare suplimentară prin LLM pentru rafinarea finală.
Pipeline-ul asigură o calitate constantă, indiferent de modelul de bază care a generat răspunsul inițial.
Critical Configuration Note
Atunci când utilizați modele de raționament (reasoning models) prin OpenRouter, @preset/manager trebuie să aibă Reasoning setat pe OFF. Modelele de raționament returnează uneori conținut null, încălcând așteptările botului. Dezactivarea raționamentului asigură un output stabil pentru toate operațiunile.
Deployment
Amigo rulează în Docker Compose cu trei servicii: botul în sine pe portul 50501, PostgreSQL cu pgvector pe portul 50504 și serverul wiki Outline pe portul 50505. Orchestrarea workflow-ului Mastra (fixată pe v1.33.1) coordonează sarcinile multi-pas prin întregul sistem de agenți.