WhatsApp

Cérebro único da IA

Mapa Master do caminho rápido e seguro para Chat, Alexa, Dinka Voice e futuro Dinka OS responderem com dados reais sem duplicar lógica.

Somente leitura por padrão
1. Pergunta entra

Chat web, Alexa, Dinka Voice ou Dinka OS enviam texto + empresa + contexto mínimo.

/api/v1/ai/chat · /api/v1/alexa/query
2. Cérebro decide

Intenções locais, KB e o serviço central respondem antes de cair no Gemini.

IntentService.ts · DinkaBusinessQueryService.ts
3. Resposta sai

Texto/card para chat e Alexa. Voz/TTS apenas fala a resposta, sem virar outro cérebro.

ttsRoutes.ts · AiAudioService.ts

Fonte da resposta certa

Ordem recomendada para o chat responder sem “achismo”.

Dados de negócio: banco/serviços internos, não Gemini. Ex.: vendas, estoque, pedidos, notas, rastreio.
Uso do sistema: KB e documentação curada. Ex.: onde configurar, como usar, quais caminhos.
Tela atual: pageKey + context enxuto enviado pela página.
Gemini: fallback para explicar, resumir e interpretar texto livre, sem acesso direto a segredos.
Ações: só por allowlist, com confirmação, auditoria e permissões.

Arquivos centrais

Caminhos que devem ser lidos antes de mexer no cérebro.

public_html/api/src/modules/ai/AiService.ts
public_html/api/src/modules/ai/IntentService.ts
public_html/api/src/modules/ai/DinkaBusinessQueryService.ts
public_html/api/src/modules/ai/GeminiChatService.ts
public_html/api/src/modules/ai/AiKbService.ts
public_html/api/src/modules/ai/AiActionsRegistry.ts
public_html/api/src/modules/voice/AiAudioService.ts
public_html/api/src/routes/alexaRoutes.ts

Caminho futuro para Dinka OS

Dinka OS pode usar o mesmo cérebro, mas não deve acessar banco, arquivos ou chaves direto.

Identidade

Device/site token com escopo mínimo por empresa/site.

Gateway

Backend decide ferramenta, valida permissão e registra auditoria.

Leitura

Reusar DinkaBusinessQueryService para respostas rápidas e corretas.

Controle

Somente allowlist + confirmação. Alexa continua read-only.

Regra Master

Se uma resposta precisa ser exata e vem do ERP, marketplace, nota, pedido ou produto, crie/ajuste serviço interno. Não resolver só com prompt no Gemini.