Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Geral

Conversa natural e funções (MCP)

Nas duas edições, o modelo de linguagem recebe um catálogo de funções declaradas em JSON Schema (src/data/mcp_tools.json). Durante conversas em português normal, a IA avalia se responde direto em texto ou se aciona uma ferramenta externa antes de formular a resposta final.

  1. Declaração de esquema: cada ferramenta informa nome, descrição de uso e parâmetros aceitos no arquivo mcp_tools.json com tipos e obrigatoriedade (required).
  2. Interceptação pelo handler: ao receber um objeto com chamada de ferramenta (tool_calls no WhatsApp ou JSON de tool no Discord), o llmHandler.js interrompe a resposta de texto crua e valida campos e limites numéricos antes da execução.
  3. Recuperação automática de saída: caso modelos menores emitam blocos internos <think> ou formatação irregular junto da chamada, o parser limpa os trechos internos e valida os argumentos reais.
  4. Retorno em conversa natural: no Discord, chamadas internas recursivas (isInternalComment: true) devolvem os dados brutos para a IA redigir uma fala humana natural. No WhatsApp, executeAgentLoop injeta o resultado da tool e consolida pedidos compostos em uma resposta única (por exemplo, consultar preço na Steam e converter o valor para outra moeda no mesmo turno).

Quando precisa de notícias recentes, notas de lançamento ou informações fora da base estática, a IA executa busca ao vivo combinando Brave Search API (quando BRAVE_API_KEY está ativa), DuckDuckGo e Bing. Ela lê o conteúdo principal das páginas selecionadas, filtra anúncios e responde citando fontes reais.

As duas edições analisam imagens enviadas ou citadas na conversa:

  • Discord: lê anexos enviados na mensagem ou presentes no histórico recente do canal via Gemini e mantém cache em image_descriptions.json (até 1.000 entradas, teto de 10 MB e timeout de 7s).
  • WhatsApp: lê imagens (JPEG, PNG, WEBP até 10 MB) e extrai via Sharp o primeiro quadro de figurinhas, encapsulando o resultado como dado externo não confiável contra tentativas de prompt injection escritas dentro de fotos.

O bot descreve e transcreve textos de prints, mas recusa pedidos para editar ou adulterar fotos já existentes.

Através de /anime_origem (Discord) ou >anime (WhatsApp), envia o frame ou print para a API pública do Trace.moe e informa o título oficial, número do episódio, minuto aproximado e porcentagem de semelhança.

Ao receber pedido por comando (/ia_imagem, >imagem) ou conversa natural, gera imagens inéditas entre 512 e 1280 pixels (1024×1024 padrão), traduzindo prompts quando necessário e aplicando lista de bloqueio anti-NSFW.

  • Discord: tenta em ordem Stability AI (se configurada STABILITY_API_KEY), Gradio SDXL-Flash, HuggingFace (FLUX.1), Stable Horde e Pollinations.
  • WhatsApp: aciona FLUX, Pollinations ou Stable Horde conforme as chaves e ordem definidas no .env.

Loja Steam (check_steam) e catálogos de jogos (search_game)

Seção intitulada “Loja Steam (check_steam) e catálogos de jogos (search_game)”
  • Steam (check_steam): consulta ao vivo a loja brasileira da Steam e retorna preço atual em reais (R$), percentual de desconto ativo, data de lançamento, desenvolvedores, nota Metacritic e link oficial.
  • Catálogos locais (search_game): consulta os índices locais fitgirl.json e dodi.json com tolerância a erros de digitação (distância de Levenshtein) e busca alternativa de nomes próximos. No Discord abre embed paginado com botões; no WhatsApp lista 5 opções válidas por 10 minutos para escolha por número (1..5 ou primeiro..quinto).

Converte moedas fiduciárias (BRL, USD, EUR, GBP, JPY) e criptomoedas (BTC, ETH, SOL), assumindo BRL como destino padrão se não informado:

  • No Discord, mantém fallback de API financeira com cache diário em arquivo JSON local para evitar requisições repetidas de moedas comuns.
  • No WhatsApp, consulta sob demanda AwesomeAPI (padrão, com suporte opcional a AWESOMEAPI_KEY) ou Frankfurter (Banco Central Europeu), informando expressamente a fonte e a data/horário exatos da cotação.
  • Deezer 320 kbps (search_and_download_music): busca a faixa no Deezer e baixa MP3 via deemix com capa e tags ID3 quando DEEZER_ARL e .venv estão configurados. No Discord, correspondências com confiança >= 80% iniciam direto e buscas ambíguas exibem menu suspenso com 5 opções.
  • Links da internet (download_audio e download_video): usam yt-dlp e FFmpeg para extrair áudio MP3 (bestaudio) ou MP4 em H.264 de plataformas suportadas (YouTube, Shorts, Instagram Reels, TikTok e X), apagando temporários do disco logo após o envio.
Ferramenta Plataforma Comportamento
get_current_music Discord Lê Spotify / Rich Presence seu ou de outro membro marcado e envia a faixa
db_read / db_write / db_edit / db_delete Discord Lê, agrega, grava e protege registros sob demanda em ai_database.json
join_voice_call / leave_voice_call / radio_voice_stt Discord Controla entrada e saída em canais de voz DAVE e escuta STT no Modo Rádio
ia_automod Discord Modera e bane globalmente contas que violem os Termos de Uso
show_bot_menu Discord Abre o painel interativo de ajuda por categorias (/ajuda)
create_sticker WhatsApp Gera figurinhas 512×512 sem corte em WebP estático ou animado com EXIF
download_game_torrent WhatsApp Valida o BTIH infohash e envia o .torrent ou magnet em arquivo .txt