¿Qué es Amigo?
Amigo es el bot universal de Telegram de Croco.Team para operaciones de marketing. En lugar de herramientas separadas para contenido, redes sociales y analítica, Amigo proporciona una interfaz unificada para todo lo que un equipo de marketing moderno necesita, impulsada por IA y aumentada por una memoria persistente.
Sistema de Comandos
Amigo ofrece más de 20 comandos que cubren el flujo de trabajo de marketing completo:
/trends muestra los temas actuales de tendencia relevantes para su industria, con atribución de fuente y métricas de interacción. /content genera ideas de contenido, esquemas y borradores completos basados en señales de tendencia y requisitos de campaña. /script crea guiones de video, esquemas de podcasts y narrativas de presentación. /reels genera conceptos de video de formato corto optimizados para TikTok, Instagram Reels y YouTube Shorts.
/image solicita la generación de imágenes por IA para publicaciones sociales, anuncios y materiales de marketing. /plan crea planes de marketing detallados con cronogramas, requisitos de recursos y métricas de éxito. /analyze proporciona información sobre la audiencia, análisis de la competencia y diagnósticos de rendimiento.
/search realiza investigaciones profundas en múltiples fuentes simultáneamente. /translate gestiona la traducción de contenido con adaptación cultural en lugar de una conversión literal palabra por palabra. /marketing genera textos de campañas multicanal adaptados a los requisitos de cada plataforma. /twitter crea tweets, hilos y respuestas optimizados. /linkedin produce publicaciones profesionales, artículos y estrategias de interacción.
Comandos adicionales cubren contenido de blog, toma de notas, gestión de memoria e integración con servicios externos como Notion y Google Workspace.
Agregación de Múltiples Fuentes
El bot agrega contenido y datos de múltiples fuentes:
SociaVault proporciona flujos de contenido de Twitter, Reddit y TikTok con analítica de interacción y detección de tendencias. HikerAPI se conecta a Instagram para el monitoreo de la competencia e inspiración de contenido. La API de YouTube permite la investigación de videos, la extracción de transcripciones y el análisis de videos en tendencia. Firecrawl gestiona la investigación web y el monitoreo de contenido de la competencia. OpenRouter sirve como la interfaz principal de LLM con acceso a múltiples modelos a través de una sola API.
Cada fuente mantiene resultados en caché con una expiración de 30 minutos, evitando llamadas redundantes a la API y asegurando la actualidad para trabajos sensibles al tiempo.
Memoria de Grafo de Conocimiento
Amigo mantiene un grafo de conocimiento persistente respaldado por PostgreSQL con pgvector para la búsqueda semántica. La extracción de entidades identifica personas, empresas, productos y conceptos mencionados en las conversaciones. El seguimiento de relaciones construye conexiones entre entidades a lo largo del tiempo.
El sistema de memoria permite que Amigo haga referencia a conversaciones anteriores, recuerde las preferencias del usuario y se base en el contexto establecido. En lugar de comenzar cada interacción desde cero, el bot acumula conocimiento organizacional que beneficia a todos los miembros del equipo.
La integración con Outline proporciona memoria adicional: las notas, diarios y carpetas se sincronizan bidireccionalmente con el servidor wiki de Outline. Las nuevas páginas creadas en Outline se vuelven buscables en Amigo; las conversaciones en Amigo pueden crear o actualizar páginas de Outline.
Arquitectura de Modelos
Amigo utiliza 10 roles de modelo distintos en lugar de codificar modelos específicos:
Chat gestiona las interacciones conversacionales con calidez y conciencia del contexto. Structured impulsa las tareas de salida JSON, el completado de formularios y la extracción de datos. Writer produce textos de marketing, publicaciones de blog y contenido social. Plan genera planes de proyecto, estrategias y hojas de ruta. Translate gestiona el contenido multilingüe con adaptación cultural.
Marketing optimiza campañas, analiza embudos y genera textos enfocados en la conversión. Embedding crea representaciones vectoriales para la búsqueda semántica y la detección de similitudes. Image gestiona los prompts de generación de imágenes. Voice procesa la transcripción y síntesis de audio. Video gestiona el análisis de video y la generación de clips.
Pipeline de Flujo de Trabajo
Toda la salida pasa por un filtro de formato de salida que aplica una transformación basada en LLM, asegurando un tono consistente, un formato correcto y niveles de detalle apropiados. Un paso de pulido de salida aplica transformaciones de regex y una limpieza adicional de LLM para el refinamiento final.
El pipeline garantiza una calidad consistente independientemente de qué modelo subyacente haya generado la respuesta inicial.
Nota de Configuración Crítica
Al utilizar modelos de razonamiento a través de OpenRouter, el @preset/manager debe tener el razonamiento (Reasoning) configurado en OFF. Los modelos de razonamiento a veces devuelven contenido nulo, rompiendo las expectativas del bot. Desactivar el razonamiento garantiza una salida estable para todas las operaciones.
Despliegue
Amigo se ejecuta en Docker Compose con tres servicios: el bot en sí en el puerto 50501, PostgreSQL con pgvector en el puerto 50504 y el servidor wiki de Outline en el puerto 50505. La orquestación de flujo de trabajo de Mastra (fijada en la v1.33.1) coordina tareas de múltiples pasos a través del sistema de agentes.