Cos'è Amigo?
Amigo è il bot Telegram universale di Croco.Team per le operazioni di marketing. Invece di utilizzare strumenti separati per i contenuti, i social media e l'analisi, Amigo fornisce un'interfaccia unificata per tutto ciò di cui un team di marketing moderno ha bisogno — guidata dall'IA e potenziata da una memoria persistente.
Sistema di Comandi
Amigo mette a disposizione oltre 20 comandi che coprono l'intero flusso di lavoro di marketing:
/trends mette in luce gli argomenti di tendenza attuali rilevanti per il tuo settore, con l'attribuzione delle fonti e le metriche di engagement. /content genera idee per i contenuti, bozze e testi completi basati sui segnali di tendenza e sui requisiti della campagna. /script crea script per video, bozze per podcast e narrazioni per presentazioni. /reels genera concept per video brevi ottimizzati per TikTok, Instagram Reels e YouTube Shorts.
/image avvia la generazione di immagini tramite IA per post sui social, annunci e materiali di marketing. /plan crea piani di marketing dettagliati con cronoprogrammi, requisiti di risorse e metriche di successo. /analyze fornisce approfondimenti sul pubblico, analisi dei concorrenti e diagnostica delle prestazioni.
/search esegue ricerche approfondite su più fonti simultaneamente. /translate gestisce la traduzione dei contenuti con adattamento culturale piuttosto che una conversione letterale parola per parola. /marketing genera testi per campagne multicanale adattati ai requisiti di ogni piattaforma. /twitter crea tweet, thread e risposte ottimizzati. /linkedin produce post professionali, articoli e strategie di engagement.
Ulteriori comandi coprono i contenuti del blog, il prendere appunti, la gestione della memoria e l'integrazione con servizi esterni come Notion e Google Workspace.
Aggregazione Multi-Fonte
Il bot aggrega contenuti e dati da più fonti:
SociaVault fornisce flussi di contenuti da Twitter, Reddit e TikTok con analisi dell'engagement e rilevamento dei trend. HikerAPI si connette a Instagram per il monitoraggio dei concorrenti e l'ispirazione per i contenuti. L'API di YouTube consente la ricerca di video, l'estrazione di trascrizioni e l'analisi dei video di tendenza. Firecrawl gestisce la ricerca web e il monitoraggio dei contenuti dei concorrenti. OpenRouter funge da interfaccia LLM primaria con accesso a più modelli tramite un'unica API.
Ogni fonte mantiene risultati in cache con una scadenza di 30 minuti, evitando chiamate API ridondanti e garantendo al contempo l'attualità per i lavori sensibili al tempo.
Memoria a Grafo della Conoscenza
Amigo mantiene un grafo della conoscenza persistente supportato da PostgreSQL con pgvector per la ricerca semantica. L'estrazione di entità identifica persone, aziende, prodotti e concetti menzionati nelle conversazioni. Il tracciamento delle relazioni crea connessioni tra le entità nel tempo.
Il sistema di memoria consente ad Amigo di fare riferimento a conversazioni precedenti, ricordare le preferenze dell'utente e costruire sulla base del contesto stabilito. Invece di iniziare ogni interazione da zero, il bot accumula conoscenze organizzative che avvantaggiano tutti i membri del team.
L'integrazione con Outline fornisce memoria aggiuntiva: note, diari e cartelle vengono sincronizzati bidirezionalmente con il server wiki di Outline. Le nuove pagine create in Outline diventano ricercabili in Amigo; le conversazioni in Amigo possono creare o aggiornare pagine di Outline.
Architettura del Modello
Amigo utilizza 10 ruoli di modello distinti invece di codificare modelli specifici:
Chat gestisce le interazioni conversazionali con calore e consapevolezza del contesto. Structured guida i task con output JSON, il completamento di moduli e l'estrazione di dati. Writer produce testi di marketing, post per blog e contenuti per i social. Plan genera piani di progetto, strategie e roadmap. Translate gestisce i contenuti multilingue con adattamento culturale.
Marketing ottimizza le campagne, analizza i funnel e genera testi focalizzati sulla conversione. Embedding crea rappresentazioni vettoriali per la ricerca semantica e il rilevamento della similarità. Image gestisce i prompt per la generazione di immagini. Voice elabora la trascrizione e la sintesi audio. Video gestisce l'analisi dei video e la generazione di clip.
Pipeline del Flusso di Lavoro
Tutti gli output passano attraverso un filtro di formattazione dell'output che applica una trasformazione basata su LLM — garantendo un tono coerente, una formattazione corretta e livelli di dettaglio appropriati. Una fase di rifinitura dell'output (polish-output) applica trasformazioni regex e un'ulteriore pulizia tramite LLM per il perfezionamento finale.
La pipeline garantisce una qualità costante indipendentemente dal modello sottostante che ha generato la risposta iniziale.
Nota Critica sulla Configurazione
Quando si utilizzano modelli di ragionamento tramite OpenRouter, l'opzione Reasoning in @preset/manager deve essere impostata su OFF. I modelli di ragionamento a volte restituiscono contenuti nulli, interrompendo le aspettative del bot. La disattivazione del ragionamento garantisce un output stabile per tutte le operazioni.
Deployment
Amigo gira in Docker Compose con tre servizi: il bot stesso sulla porta 50501, PostgreSQL con pgvector sulla porta 50504 e il server wiki di Outline sulla porta 50505. L'orchestrazione del flusso di lavoro di Mastra (fissata alla v1.33.1) coordina i task multi-step attraverso il sistema di agenti.