Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari WhatsApp

Funcionalidades e agente no WhatsApp

A HikariZap opera como agente com loop iterativo de ferramentas (executeAgentLoop) e fila serializada (src/whatsapp/queue.js) adaptada às regras e limites do WhatsApp.

  1. Filtragem de entrada: responde livremente em DMs e, em grupos, apenas quando mencionada (@), respondida (reply), chamada pelo nome (BOT_NAME), acionada por > / / / . <pergunta> ou em pedido de figurinha com mídia.
  2. Contexto deslizante: mantém em RAM apenas as últimas 15 mensagens trocadas naquela conversa (Store), sem gravar logs longos de chats comuns em disco.
  3. Pedidos compostos com múltiplas funções: se você pedir na mesma frase algo como “pesquisa Elden Ring na Steam e converte o valor para euro”, a IA aciona check_steam, encadeia convert_currency e devolve uma resposta única consolidada.
  4. Reações visuais (TOOL_REACTIONS): marca sua mensagem com um emoji de andamento enquanto executa a ferramenta e limpa a reação ao responder.
  • Figurinhas 512×512 e reversão (>sticker, >toimg): ajusta fotos sem cortar nem esticar com Sharp em fundo transparente, cria stickers animados até 10s (24 fps, < 1 MB) com EXIF e reverte de volta para PNG transparente ou GIF completo.
  • Visão computacional em imagens e figurinhas: lê prints (<= 10 MB) e o primeiro quadro de figurinhas, marcando o texto extraído como dado não confiável contra injeção de prompt.
  • Games e Steam (>torrent, >steam): consulta fitgirl.json e dodi.json com seleção interativa de 5 opções válida por 10 minutos, validação de BTIH infohash e envio de magnet em .txt; consulta preços em R$, descontos e Metacritic na Steam.
  • Pesquisa web e câmbio (>pesquisa, >moeda): combina Brave Search, DuckDuckGo e Bing com remoção de ruído, e consulta câmbio ao vivo na AwesomeAPI ou Frankfurter (BCE) exibindo fonte e horário da cotação.
  • Deezer 320 kbps e mídia web (>musica, >baixar_audio, >baixar_video): baixa faixas em 320 kbps via deemix com capa ID3 ou streams via yt-dlp, respeitando WHATSAPP_MAX_MEDIA_MB e apagando arquivos temporários após o envio.