Co je Amigo?
Amigo je univerzální Telegram bot společnosti Croco.Team pro marketingové operace. Namísto oddělených nástrojů pro obsah, sociální sítě a analytiku poskytuje Amigo jednotné rozhraní pro vše, co moderní marketingový tým potřebuje – poháněné AI a rozšířené o trvalou paměť.
Systém příkazů
Amigo nabízí více než 20 příkazů pokrývajících celý marketingový workflow:
/trends vyhledává aktuální trendy relevantní pro váš obor, včetně uvedení zdrojů a metrik zapojení. /content generuje nápady na obsah, osnovy a celé návrhy na základě trendů a požadavků kampaní. /script vytváří scénáře pro videa, osnovy podcastů a narativy pro prezentace. /reels generuje koncepty krátkých videí optimalizované pro TikTok, Instagram Reels a YouTube Shorts.
/image generuje prompty pro tvorbu AI obrázků pro sociální sítě, reklamy a marketingové materiály. /plan vytváří detailní marketingové plány s časovými osami, požadavky na zdroje a metriky úspěchu. /analyze poskytuje vhledy do publika, analýzu konkurence a diagnostiku výkonu.
/search provádí hloubkový výzkum napříč více zdroji současně. /translate zajišťuje překlad obsahu s kulturní adaptací namísto doslovného převodu slovo od slova. /marketing generuje texty pro vícekanálové kampaně adaptované na požadavky každé platformy. /twitter vytváří optimalizované tweety, vlákna a odpovědi. /linkedin produkuje profesionální příspěvky, články a strategie pro zapojení.
Další příkazy pokrývají obsah blogů, poznamenávání, správu paměti a integraci se externími službami, jako jsou Notion a Google Workspace.
Agregace z více zdrojů
Bot agreguje obsah a data z více zdrojů:
SociaVault poskytuje streamy obsahu z Twitteru, Redditu a TikToku s analytikou zapojení a detekcí trendů. HikerAPI se připojuje k Instagramu pro monitoring konkurence a inspiraci obsahem. YouTube API umožňuje výzkum videí, extrakci přepisů a analýzu trendujících videí. Firecrawl zajišťuje webový výzkum a monitoring obsahu konkurence. OpenRouter slouží jako primární rozhraní pro LLM s přístupem k více modelům prostřednictvím jednoho API.
Každý zdroj udržuje vyrovnávací mezipaměť (cache) s 30minutovou expirací, což předchází redundantním voláním API a zároveň zajišťuje aktuálnost pro práci časově kritickou.
Paměť založená na znalostním grafu
Amigo udržuje trvalý znalostní graf podporovaný PostgreSQL s pgvector pro sémantické vyhledávání. Extrakce entit identifikuje osoby, společnosti, produkty a koncepty zmíněné v konverzaci. Sledování vztahů buduje v čase vazby mezi entitami.
Systém paměti umožňuje Amigu odkazovat na předchozí konverzace, pamatovat si preference uživatele a stavět na již vytvořeném kontextu. Místo toho, aby každou interakci začínal od nuly, bot kumuluje organizační znalosti, které přinášejí přínos všem členům týmu.
Integrace Outline poskytuje další paměť – poznámky, deníky a složky se synchronizují obousměrně se serverem Outline wiki. Nové stránky vytvořené v Outline jsou vyhledatelné v Amigu; konverzace v Amigu mohou vytvářet nebo aktualizovat stránky v Outline.
Architektura modelů
Amigo využívá 10 odlišných rolí modelů namísto pevného kódování konkrétních modelů:
Chat zvládá konverzační interakce s vřelostí a uvědoměním kontextu. Structured pohání úlohy s JSON výstupem, vyplňování formulářů a extrakci dat. Writer vytváří marketingové texty, blogové příspěvky a obsah pro sociální sítě. Plan generuje projektové plány, strategie a roadmapy. Translate spravuje vícejazyčný obsah s kulturní adaptací.
Marketing optimalizuje kampaně, analyzuje konverzní trychtýře a generuje texty zaměřené na konverzi. Embedding vytváří vektorové reprezentace pro sémantické vyhledávání a detekci podobnosti. Image zvládá prompty pro generování obrázků. Voice zpracovává audio transkripci a syntézu. Video spravuje analýzu videa a generování klipů.
Workflow Pipeline
Veškerý výstup prochází filtrem format-output, který aplikuje transformaci založenou na LLM – čímž zajišťuje konzistentní tón, správné formátování a appropriate úrovně detailů. Krok polish-output aplikuje transformace pomocí regex a dodatečné čištění pomocí LLM pro finální doladění.
Pipeline zajišťuje konzistentní kvalitu bez ohledu na to, který podkladový model vygeneroval původní odpověď.
Critical Configuration Note
Při používání reasoning modelů prostřednictím OpenRouter musí mít @preset/manager nastaveno Reasoning na OFF. Reasoning modely někdy vrací null obsah, což narušuje očekávání bota. Vypnutí reasoning zajišťuje stabilní výstup pro všechny operace.
Deployment
Amigo běží v Docker Compose se třemi službami: samotný bot na portu 50501, PostgreSQL s pgvector na portu 50504 a server wiki Outline na portu 50505. Orchestrace workflow Mastra (připoutaná na v1.33.1) koordinuje vícestupňové úlohy napříč systémem agentů.