feat(secretaria): tool solicitar_horario_especial (zona cinza)

Quando o cliente pede um horário PONTUAL fora dos disponíveis (mais cedo/mais tarde), a IA usa solicitar_horario_especial → registra um pedido na agenda do satélite (POST /pedido) e responde "vou confirmar com a secretária e retorno" (sem garantir o horário). brain.ts injeta essa regra no prompt. Par do satélite (scoreodonto): janela flex + fila da secretária humana. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-06 05:29:45 +02:00
parent 837a7a44d9
commit 0f20fe5314
6 changed files with 100 additions and 2 deletions
@@ -331,6 +331,57 @@ exports.BUILTIN_TOOLS = [
            return { ok: true, protocolo: conv?.protocol_number ?? '', resumo: summary };
        },
    },
+    // ── solicitar_horario_especial ──────────────────────────────────────────────
+    // Zona cinza: o cliente pede um horário FORA da janela livre (mais cedo/mais
+    // tarde). A IA NÃO agenda — registra um pedido para a secretária HUMANA confirmar
+    // e diz que vai retornar.
+    {
+        name: 'solicitar_horario_especial',
+        description: 'Use QUANDO o cliente pedir um horário que NÃO aparece na lista de horários disponíveis — ' +
+            'mais cedo ou mais tarde que o normal (ex.: "tem às 8h30?", "consegue depois das 17h?"). ' +
+            'NUNCA diga que não tem: registre o pedido com esta tool e diga ao cliente que você vai ' +
+            'CONFIRMAR com a secretária e RETORNAR. Não garanta o horário. Só para horários pontuais fora do padrão.',
+        parameters: {
+            type: 'object',
+            properties: {
+                data: { type: 'string', description: 'Data desejada no formato YYYY-MM-DD.' },
+                hora: { type: 'string', description: 'Horário desejado HH:MM.' },
+                nome_cliente: { type: 'string', description: 'Nome completo do cliente.' },
+                telefone_cliente: { type: 'string', description: 'Telefone do cliente (opcional).' },
+                dentista: { type: 'string', description: 'Nome do dentista, se o cliente indicou (opcional).' },
+                procedimento: { type: 'string', description: 'Procedimento/motivo (opcional).' },
+            },
+            required: ['data', 'hora', 'nome_cliente'],
+        },
+        async execute(args, ctx) {
+            if (!ctx.agenda?.url || !ctx.agenda.clinicaId)
+                return { ok: false, erro: 'Agenda indisponível.' };
+            let telefone = String(args['telefone_cliente'] ?? '').replace(/\D/g, '');
+            if (!telefone && ctx.extChatId) {
+                const jid = ctx.extChatId.split(':').pop() ?? '';
+                telefone = (jid.split('@')[0] ?? '').replace(/\D/g, '');
+            }
+            try {
+                const r = await fetch(`${ctx.agenda.url.replace(/\/$/, '')}/pedido`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'x-nw-agenda-secret': ctx.agenda.secret ?? '' },
+                    signal: AbortSignal.timeout(12000),
+                    body: JSON.stringify({
+                        clinica_id: ctx.agenda.clinicaId, data: args['data'], hora: args['hora'],
+                        dentista_nome: args['dentista'] ?? null, nome_cliente: args['nome_cliente'],
+                        telefone, procedimento: args['procedimento'] ?? null,
+                    }),
+                });
+                const j = await r.json().catch(() => ({}));
+                if (!r.ok || j.ok === false)
+                    return { ok: false, mensagem: j.motivo ?? 'Não foi possível registrar o pedido.' };
+                return { ok: true, registrado: true, instrucao: 'Diga ao cliente que você vai VERIFICAR esse horário com a secretária e RETORNA com a confirmação. NÃO garanta o horário agora.' };
+            }
+            catch (e) {
+                return { ok: false, erro: e.message };
+            }
+        },
+    },
 ];
 function resolveTools(names) {
    return names