Wat is Amigo?
Amigo is de universele Telegram-bot van Croco.Team voor marketingoperaties. In plaats van afzonderlijke tools voor content, sociale media en analytics, biedt Amigo een uniforme interface voor alles wat een modern marketingteam nodig heeft - aangedreven door AI en uitgebreid met persistent geheugen.
Commando-systeem
Amigo biedt meer dan 20 commando's die de volledige marketingworkflow dekken:
/trends brengt actuele trending onderwerpen in kaart die relevant zijn voor jouw sector, inclusief bronvermelding en engagement-metrieken. /content genereert contentideeën, outlines en volledige concepten op basis van trending signalen en campagne-eisen. /script maakt videoscripts, podcast-outlines en presentatieverhalen. /reels genereert short-form videoconcepten, geoptimaliseerd voor TikTok, Instagram Reels en YouTube Shorts.
/image activeert AI-afbeeldingsgeneratie voor social posts, advertenties en marketingmateriaal. /plan maakt gedetailleerde marketingplannen met tijdlijnen, resource-vereisten en succesmetrieken. /analyze biedt inzichten in het publiek, concurrentieanalyse en prestatiediagnostiek.
/search voert diepgaand onderzoek uit over meerdere bronnen tegelijkertijd. /translate regelt contentvertaling met culturele adaptatie in plaats van een letterlijke woord-voor-woord conversie. /marketing genereert multi-channel campagne-copy, aangepast aan de vereisten van elk platform. /twitter maakt geoptimaliseerde tweets, threads en reacties. /linkedin produceert professionele posts, artikelen en engagement-strategieën.
Aanvullende commando's dekken blogcontent, notities, geheugenbeheer en integratie met externe diensten zoals Notion en Google Workspace.
Multi-Source Aggregatie
De bot aggregeert content en data uit meerdere bronnen:
SociaVault biedt contentstreams van Twitter, Reddit en TikTok met engagement-analytics en trenddetectie. HikerAPI verbindt met Instagram voor concurrentiemonitoring en contentinspiratie. De YouTube API maakt videoresearch, transcriptie-extractie en analyse van trending video's mogelijk. Firecrawl regelt webresearch en monitoring van content van concurrenten. OpenRouter dient als de primaire LLM-interface met toegang tot meerdere modellen via één enkele API.
Elke bron behoudt gecachte resultaten met een vervaltijd van 30 minuten, waardoor redundante API-aanroepen worden voorkomen terwijl de actualiteit voor tijdgevoelig werk wordt gewaarborgd.
Knowledge Graph Geheugen
Amigo onderhoudt een persistent knowledge graph, ondersteund door PostgreSQL met pgvector voor semantisch zoeken. Entity-extractie identificeert personen, bedrijven, producten en concepten die in gesprekken worden genoemd. Relationship tracking bouwt in de loop van de tijd verbindingen tussen entiteiten op.
Het geheugensysteem stelt Amigo in staat om te verwijzen naar eerdere gesprekken, gebruikersvoorkeuren te onthouden en voort te bouwen op de vastgestelde context. In plaats van elke interactie vanaf nul te beginnen, verzamelt de bot organisatorische kennis waar alle teamleden baat bij hebben.
Outline-integratie biedt extra geheugen - notities, journaals en mappen synchroniseren bidirectioneel met de Outline-wiki-server. Nieuwe pagina's die in Outline zijn aangemaakt, worden doorzoekbaar in Amigo; gesprekken in Amigo kunnen Outline-pagina's aanmaken of bijwerken.
Modelarchitectuur
Amigo gebruikt 10 verschillende modelrollen in plaats van specifieke modellen hard te coderen:
Chat regelt conversationele interacties met warmte en contextbewustzijn. Structured stuurt JSON-outputtaken, het invullen van formulieren en data-extractie aan. Writer produceert marketing-copy, blogposts en social content. Plan genereert projectplannen, strategieën en roadmaps. Translate beheert meertalige content met culturele adaptatie.
Marketing optimaliseert campagnes, analyseert funnels en genereert conversiegerichte copy. Embedding maakt vectorrepresentaties voor semantisch zoeken en gelijkenisdetectie. Image regelt prompts voor afbeeldingsgeneratie. Voice verwerkt audiotranscriptie en synthese. Video beheert videoanalyse en clipgeneratie.
Workflow Pipeline
Alle output gaat door een format-outputfilter dat LLM-gebaseerde transformatie toepast - wat zorgt voor een consistente toon, correcte opmaak en passende detailniveaus. Een polish-outputstap past regex-transformaties en aanvullende LLM-opschoning toe voor de uiteindelijke verfijning.
De pipeline garandeert een consistente kwaliteit, ongeacht welk onderliggend model de initiële reactie heeft gegenereerd.
Kritieke Configuratieopmerking
Bij het gebruik van reasoning-modellen via OpenRouter moet Reasoning bij de @preset/manager op OFF staan. Reasoning-modellen retourneren soms null-content, wat de verwachtingen van de bot doorbreekt. Het uitschakelen van reasoning garandeert een stabiele output voor alle operaties.
Deployment
Amigo draait in Docker Compose met drie services: de bot zelf op poort 50501, PostgreSQL met pgvector op poort 50504 en de Outline-wiki-server op poort 50505. De Mastra workflow-orchestratie (vastgezet op v1.33.1) coördineert stappenplannen over het agentsysteem.