O que é o Amigo?
O Amigo é o bot universal do Telegram da Croco.Team para operações de marketing. Em vez de ferramentas separadas para conteúdo, redes sociais e análises, o Amigo oferece uma interface unificada para tudo o que uma equipe de marketing moderna precisa - impulsionada por IA e aumentada por memória persistente.
Sistema de Comandos
O Amigo disponibiliza mais de 20 comandos que cobrem todo o fluxo de trabalho de marketing:
/trends revela os tópicos atuais em alta relevantes para o seu setor, com atribuição de fonte e métricas de engajamento. /content gera ideias de conteúdo, esboços e rascunhos completos com base em sinais de tendências e requisitos de campanha. /script cria roteiros de vídeo, esboços de podcasts e narrativas de apresentação. /reels gera conceitos de vídeos curtos otimizados para TikTok, Instagram Reels e YouTube Shorts.
/image solicita a geração de imagens por IA para posts em redes sociais, anúncios e materiais de marketing. /plan cria planos de marketing detalhados com cronogramas, requisitos de recursos e métricas de sucesso. /analyze fornece insights de público, análise de concorrentes e diagnósticos de desempenho.
/search realiza pesquisas profundas em múltiplas fontes simultaneamente. /translate lida com a tradução de conteúdo com adaptação cultural, em vez de conversão literal palavra por palavra. /marketing gera textos de campanhas multicanal adaptados aos requisitos de cada plataforma. /twitter cria tweets, threads e respostas otimizadas. /linkedin produz posts profissionais, artigos e estratégias de engajamento.
Comandos adicionais cobrem conteúdo de blog, anotações, gerenciamento de memória e integração com serviços externos como Notion e Google Workspace.
Agregação de Múltiplas Fontes
O bot agrega conteúdo e dados de múltiplas fontes:
O SociaVault fornece fluxos de conteúdo do Twitter, Reddit e TikTok com análises de engajamento e detecção de tendências. O HikerAPI conecta-se ao Instagram para monitoramento de concorrentes e inspiração de conteúdo. A API do YouTube permite a pesquisa de vídeos, extração de transcrições e análise de vídeos em alta. O Firecrawl lida com a pesquisa na web e o monitoramento de conteúdo de concorrentes. O OpenRouter serve como a interface principal de LLM, com acesso a múltiplos modelos através de uma única API.
Cada fonte mantém resultados em cache com expiração de 30 minutos, evitando chamadas de API redundantes e garantindo a atualidade para trabalhos sensíveis ao tempo.
Memória de Grafo de Conhecimento
O Amigo mantém um grafo de conhecimento persistente suportado por PostgreSQL com pgvector para busca semântica. A extração de entidades identifica pessoas, empresas, produtos e conceitos mencionados nas conversas. O rastreamento de relacionamentos constrói conexões entre entidades ao longo do tempo.
O sistema de memória permite que o Amigo referencie conversas anteriores, lembre-se de preferências do usuário e construa sobre o contexto estabelecido. Em vez de iniciar cada interação do zero, o bot acumula conhecimento organizacional que beneficia todos os membros da equipe.
A integração com o Outline fornece memória adicional - notas, diários e pastas são sincronizados bidirecionalmente com o servidor wiki do Outline. Novas páginas criadas no Outline tornam-se pesquisáveis no Amigo; conversas no Amigo podem criar ou atualizar páginas do Outline.
Arquitetura de Modelos
O Amigo utiliza 10 funções de modelo distintas em vez de codificar modelos específicos:
Chat lida com interações conversacionais com cordialidade e consciência de contexto. Structured conduz tarefas de saída JSON, preenchimento de formulários e extração de dados. Writer produz textos de marketing, posts de blog e conteúdo para redes sociais. Plan gera planos de projeto, estratégias e roadmaps. Translate gerencia conteúdo multilíngue com adaptação cultural.
Marketing otimiza campanhas, analisa funis e gera textos focados em conversão. Embedding cria representações vetoriais para busca semântica e detecção de similaridade. Image lida com prompts de geração de imagem. Voice processa a transcrição e síntese de áudio. Video gerencia a análise de vídeo e a geração de clipes.
Pipeline de Fluxo de Trabalho
Toda a saída passa por um filtro de formatação de saída (format-output) que aplica a transformação baseada em LLM - garantindo tom consistente, formatação correta e níveis de detalhamento apropriados. Uma etapa de polimento de saída (polish-output) aplica transformações de regex e limpeza adicional de LLM para o refinamento final.
O pipeline garante qualidade consistente, independentemente de qual modelo subjacente gerou a resposta inicial.
Nota Crítica de Configuração
Ao usar modelos de raciocínio (reasoning models) através do OpenRouter, o @preset/manager deve ter o Reasoning definido como OFF. Modelos de raciocínio às vezes retornam conteúdo nulo, quebrando as expectativas do bot. Desativar o raciocínio garante a estabilidade da saída para todas as operações.
Implantação
O Amigo roda no Docker Compose com três serviços: o próprio bot na porta 50501, PostgreSQL com pgvector na porta 50504 e o servidor wiki do Outline na porta 50505. A orquestração de fluxo de trabalho Mastra (fixada na v1.33.1) coordena tarefas de múltiplas etapas em todo o sistema de agentes.