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.
Ciclo técnico de execução
Seção intitulada “Ciclo técnico de execução”- Declaração de esquema: cada ferramenta informa nome, descrição de uso e parâmetros aceitos no arquivo
mcp_tools.jsoncom tipos e obrigatoriedade (required). - Interceptação pelo handler: ao receber um objeto com chamada de ferramenta (
tool_callsno WhatsApp ou JSON de tool no Discord), ollmHandler.jsinterrompe a resposta de texto crua e valida campos e limites numéricos antes da execução. - 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. - 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,executeAgentLoopinjeta 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).
Ferramentas universais nas duas plataformas
Seção intitulada “Ferramentas universais nas duas plataformas”Pesquisa web em tempo real (search_web)
Seção intitulada “Pesquisa web em tempo real (search_web)”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.
Visão computacional (imageVisionHandler.js)
Seção intitulada “Visão computacional (imageVisionHandler.js)”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 de10 MBe timeout de7s). - WhatsApp: lê imagens (
JPEG,PNG,WEBPaté10 MB) e extrai viaSharpo 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.
Reconhecimento de cenas de anime (anime_source)
Seção intitulada “Reconhecimento de cenas de anime (anime_source)”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.
Geração de imagens (generate_image)
Seção intitulada “Geração de imagens (generate_image)”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 locaisfitgirl.jsonedodi.jsoncom 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..5ouprimeiro..quinto).
Conversor de moedas e cripto (convert_currency)
Seção intitulada “Conversor de moedas e cripto (convert_currency)”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.
Downloads de música e vídeo
Seção intitulada “Downloads de música e vídeo”- Deezer 320 kbps (
search_and_download_music): busca a faixa no Deezer e baixa MP3 viadeemixcom capa e tags ID3 quandoDEEZER_ARLe.venvestã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_audioedownload_video): usamyt-dlpe 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.
Ferramentas específicas por plataforma
Seção intitulada “Ferramentas específicas por plataforma”| 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 |
Gera figurinhas 512×512 sem corte em WebP estático ou animado com EXIF |
|
download_game_torrent |
Valida o BTIH infohash e envia o .torrent ou magnet em arquivo .txt |
