Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Referência técnica

Arquitetura e criação de ferramentas

O Projeto Hikari mantém Discord e WhatsApp em processos e repositórios independentes, sem acoplar rotas web administrativas nem misturar sessões de runtime.

  • Discord (Hikari): armazena estado persistente em src/data/ai_database.json, permissões por servidor em server_tools.json e descrições visuais em image_descriptions.json.
  • WhatsApp (HikariZap): isola sessão Web em .whatsapp-auth/ com trava .lock, saúde do pool em ai-health.json e vínculos PN <-> LID em src/data/zap/identities.json.
  • Quedas de conexão, troca de QR Code ou manutenção em uma plataforma não interferem na outra.

Este site é compilado como páginas estáticas pelo Astro e Starlight, sem backend conectado às máquinas que executam os bots:

  • O Explorador de comandos e o Gerador de config rodam integralmente no navegador.
  • Chaves privadas e tokens nunca trafegam pela página; o gerador exporta credenciais apenas como placeholders para edição local no servidor.
  • Toda administração em produção ocorre direto pelas plataformas (/config_servidor, /ia_ferramentas, /config_criador no Discord e >pausar, >retomar, >fila no WhatsApp).

Os dois projetos declaram assinaturas em JSON Schema no arquivo src/data/mcp_tools.json e conectam a implementação ao loop do llmHandler.js:

  1. Declare o esquema adicionando o novo objeto function dentro de src/data/mcp_tools.json com name, description clara e parameters (required e tipos).
  2. Implemente o handler dentro do fluxo de src/handlers/llmHandler.js (processQueue()) encapsulado em bloco try-catch para impedir que falhas de APIs terceiras congelem o processo.
  3. Humanize o retorno: o fluxo dispara chamada recursiva (isInternalComment: true) após retornar o JSON da ferramenta para a IA formular uma resposta natural, e imprime o "thought" no console durante depuração.
  4. Atenção a permissões e JSON: garanta que o bot possui as permissões necessárias no servidor caso a ferramenta manipule canais ou mensagens, e valide saídas estruturadas de modelos menores para evitar vazamento de objetos crus no texto.