nubot-lite 0.1.0 → 0.1.2

package/template/worker/src/agent/prompt.ts

@@ -1,134 +1,137 @@
-// Prompt por bloques.
-// Orden pensado para la caché de Anthropic: lo que no cambia entre conversaciones
-// va en `system`; lo que cambia (hora, datos del cliente) va como mensaje de sistema al final.
-
-import type Anthropic from "@anthropic-ai/sdk";
-import type { MessageRow } from "../inbox/store";
-import type { StoredAttachment } from "../media/files";
-
-export interface AgentSettings {
-  businessName: string;
-  agentName: string;
-  agentRole: string;
-  instructions: string;
-  /** Para qué conversa el agente: vender, agendar, dar soporte… */
-  purpose: string;
-  timezone: string;
-  model: string;
-  /** Herramientas activas; null = todas las del plan. */
-  tools: string[] | null;
-  /** Apagado, no responde y las conversaciones nuevas quedan en espera de un asesor. */
-  active: boolean;
-}
-
-export interface TurnContext {
-  contact: { name: string | null; phone: string | null; metadata: Record<string, string> };
-  tags: string[];
-  availableTags: string[];
-  stage: string | null;
-  stages: string[];
-  productOfInterest: string | null;
-  requestTypes: { name: string; description: string; fields: { name: string; label: string; required: boolean }[] }[];
-}
-
-export function buildSystemPrompt(s: AgentSettings): string {
-  return [
-    `<base_rules>
-Atiendes a clientes por WhatsApp en nombre de ${s.businessName}.
-- Responde en el idioma del cliente, con mensajes cortos, como en un chat.
-- No inventes precios, stock, horarios ni condiciones: si no lo sabes, búscalo con tus herramientas; si no aparece, dilo y ofrece pasar con una persona.
-- No uses markdown: WhatsApp no muestra encabezados ni tablas.
-- Si el cliente manda una nota de voz, verás su transcripción; respóndela como si la hubieras escuchado.
-</base_rules>`,
-    `<agent_profile>
-Nombre: ${s.agentName}
-Rol: ${s.agentRole}${s.purpose.trim() ? `\nObjetivo: ${s.purpose.trim()}` : ""}
-</agent_profile>`,
-    `<tool_instructions>
-- Datos de la empresa: search_knowledge antes de responder.
-- Productos: search_products; muestra fotos con send_product_images cuando ayude; registra el producto que le interesa con set_product_of_interest.
-- Cuando el cliente dé datos suyos, guárdalos con update_lead_info.
-- Cuando avance en la compra, muévelo de etapa con move_to_funnel_stage.
-- Fechas relativas: resolve_date.
-- Si el cliente quiere agendar o pedir algo de los tipos de solicitud: junta los datos con validate_request, resume y pide confirmación, y recién entonces create_request. Si se arrepiente: cancel_request.
-- Si pide hablar con una persona, está molesto o no puedes ayudar: transfer_to_human.
-</tool_instructions>`,
-    s.instructions.trim() ? `<custom_instructions>\n${s.instructions.trim()}\n</custom_instructions>` : "",
-  ]
-    .filter(Boolean)
-    .join("\n\n");
-}
-
-/** Contexto que cambia en cada turno; va al final para no romper la caché del prefijo. */
-export function buildTurnContext(s: AgentSettings, ctx: TurnContext, now: Date): string {
-  const when = new Intl.DateTimeFormat("es-PE", { timeZone: s.timezone, dateStyle: "full", timeStyle: "short" }).format(now);
-  const data = Object.entries(ctx.contact.metadata).map(([k, v]) => `${k}: ${v}`);
-  const customer = [
-    ctx.contact.name && `Nombre: ${ctx.contact.name}`,
-    ctx.contact.phone && `Teléfono: ${ctx.contact.phone}`,
-    ...data,
-    ctx.tags.length > 0 && `Etiquetas: ${ctx.tags.join(", ")}`,
-    ctx.productOfInterest && `Producto de interés: ${ctx.productOfInterest}`,
-  ].filter(Boolean);
-  return [
-    `<timestamp>${when} (${s.timezone})</timestamp>`,
-    customer.length ? `<customer_context>\n${customer.join("\n")}\n</customer_context>` : "",
-    ctx.stages.length ? `<funnel>\nEtapa actual: ${ctx.stage ?? "sin etapa"}\nEtapas: ${ctx.stages.join(" → ")}\n</funnel>` : "",
-    `<available_tags>${ctx.availableTags.join(", ") || "ninguna"}</available_tags>`,
-    ctx.requestTypes.length
-      ? `<request_types>\n${ctx.requestTypes
-          .map(
-            (t) =>
-              `${t.name}${t.description ? ` (${t.description})` : ""}: ${t.fields.map((f) => `${f.name} = ${f.label}${f.required ? "" : " (opcional)"}`).join("; ")}`,
-          )
-          .join("\n")}\n</request_types>`
-      : "",
-  ]
-    .filter(Boolean)
-    .join("\n");
-}
-
-export function describeAttachments(raw: string): string {
-  const list = JSON.parse(raw || "[]") as StoredAttachment[];
-  return list
-    .map((a) => {
-      if (a.type === "audio") {
-        const label = a.voice ? "nota de voz" : "audio";
-        return a.transcript ? `[${label}: "${a.transcript}"]` : `[${label} sin transcribir]`;
-      }
-      if (a.type === "image") return "[imagen]";
-      if (a.type === "video") return "[video]";
-      if (a.type === "sticker") return "[sticker]";
-      return `[archivo${a.name ? `: ${a.name}` : ""}]`;
-    })
-    .join(" ");
-}
-
-/** true si el mensaje tiene adjuntos que todavía se están descargando o transcribiendo. */
-export function hasPendingMedia(m: MessageRow): boolean {
-  const list = JSON.parse(m.attachments || "[]") as StoredAttachment[];
-  return list.some((a) => !a.key && !a.error);
-}
-
-/**
- * Convierte el historial a mensajes de Claude. El cliente es `user`; el bot y los asesores, `assistant`.
- * `images` agrega fotos (ya en base64) a mensajes del cliente por id.
- * Devuelve null si el último mensaje no es del cliente: no hay nada que responder.
- */
-export function toClaudeMessages(
-  history: MessageRow[],
-  images: Map<string, Anthropic.ImageBlockParam[]> = new Map(),
-): Anthropic.MessageParam[] | null {
-  const turns: Anthropic.MessageParam[] = [];
-  for (const m of history) {
-    if (m.sender_type === "system" || m.sender_type === "note") continue;
-    const text = [m.content?.trim(), describeAttachments(m.attachments)].filter(Boolean).join(" ");
-    if (!text) continue;
-    const role = m.sender_type === "contact" ? "user" : "assistant";
-    if (turns.length === 0 && role === "assistant") continue; // el primer turno tiene que ser del cliente
-    const pics = role === "user" ? images.get(m.id) : undefined;
-    turns.push({ role, content: pics?.length ? [...pics, { type: "text", text }] : text });
-  }
-  if (turns.length === 0 || turns[turns.length - 1].role !== "user") return null;
-  return turns;
-}
+// Prompt por bloques.
+// Orden pensado para la caché de Anthropic: lo que no cambia entre conversaciones
+// va en `system`; lo que cambia (hora, datos del cliente) va como mensaje de sistema al final.
+
+import type Anthropic from "@anthropic-ai/sdk";
+import type { MessageRow } from "../inbox/store";
+import type { StoredAttachment } from "../media/files";
+
+export interface AgentSettings {
+  businessName: string;
+  agentName: string;
+  agentRole: string;
+  instructions: string;
+  /** Para qué conversa el agente: vender, agendar, dar soporte… */
+  purpose: string;
+  timezone: string;
+  model: string;
+  /** Herramientas activas; null = todas las del plan. */
+  tools: string[] | null;
+  /** Apagado, no responde y las conversaciones nuevas quedan en espera de un asesor. */
+  active: boolean;
+}
+
+export interface TurnContext {
+  /** La red por la que escribe el cliente. */
+  channel: string;
+  contact: { name: string | null; phone: string | null; metadata: Record<string, string> };
+  tags: string[];
+  availableTags: string[];
+  stage: string | null;
+  stages: string[];
+  productOfInterest: string | null;
+  requestTypes: { name: string; description: string; fields: { name: string; label: string; required: boolean }[] }[];
+}
+
+export function buildSystemPrompt(s: AgentSettings): string {
+  return [
+    `<base_rules>
+Atiendes a clientes por chat (WhatsApp, Instagram o Facebook) en nombre de ${s.businessName}.
+- Responde en el idioma del cliente, con mensajes cortos, como en un chat.
+- No inventes precios, stock, horarios ni condiciones: si no lo sabes, búscalo con tus herramientas; si no aparece, dilo y ofrece pasar con una persona.
+- No uses markdown: estos chats no muestran encabezados ni tablas.
+- Si el cliente manda una nota de voz, verás su transcripción; respóndela como si la hubieras escuchado.
+</base_rules>`,
+    `<agent_profile>
+Nombre: ${s.agentName}
+Rol: ${s.agentRole}${s.purpose.trim() ? `\nObjetivo: ${s.purpose.trim()}` : ""}
+</agent_profile>`,
+    `<tool_instructions>
+- Datos de la empresa: search_knowledge antes de responder.
+- Productos: search_products; muestra fotos con send_product_images cuando ayude; registra el producto que le interesa con set_product_of_interest.
+- Cuando el cliente dé datos suyos, guárdalos con update_lead_info.
+- Cuando avance en la compra, muévelo de etapa con move_to_funnel_stage.
+- Fechas relativas: resolve_date.
+- Si el cliente quiere agendar o pedir algo de los tipos de solicitud: junta los datos con validate_request, resume y pide confirmación, y recién entonces create_request. Si se arrepiente: cancel_request.
+- Si pide hablar con una persona, está molesto o no puedes ayudar: transfer_to_human.
+</tool_instructions>`,
+    s.instructions.trim() ? `<custom_instructions>\n${s.instructions.trim()}\n</custom_instructions>` : "",
+  ]
+    .filter(Boolean)
+    .join("\n\n");
+}
+
+/** Contexto que cambia en cada turno; va al final para no romper la caché del prefijo. */
+export function buildTurnContext(s: AgentSettings, ctx: TurnContext, now: Date): string {
+  const when = new Intl.DateTimeFormat("es-PE", { timeZone: s.timezone, dateStyle: "full", timeStyle: "short" }).format(now);
+  const data = Object.entries(ctx.contact.metadata).map(([k, v]) => `${k}: ${v}`);
+  const customer = [
+    ctx.contact.name && `Nombre: ${ctx.contact.name}`,
+    ctx.contact.phone && `Teléfono: ${ctx.contact.phone}`,
+    ...data,
+    ctx.tags.length > 0 && `Etiquetas: ${ctx.tags.join(", ")}`,
+    ctx.productOfInterest && `Producto de interés: ${ctx.productOfInterest}`,
+  ].filter(Boolean);
+  return [
+    `<timestamp>${when} (${s.timezone})</timestamp>`,
+    `<channel>${ctx.channel}</channel>`,
+    customer.length ? `<customer_context>\n${customer.join("\n")}\n</customer_context>` : "",
+    ctx.stages.length ? `<funnel>\nEtapa actual: ${ctx.stage ?? "sin etapa"}\nEtapas: ${ctx.stages.join(" → ")}\n</funnel>` : "",
+    `<available_tags>${ctx.availableTags.join(", ") || "ninguna"}</available_tags>`,
+    ctx.requestTypes.length
+      ? `<request_types>\n${ctx.requestTypes
+          .map(
+            (t) =>
+              `${t.name}${t.description ? ` (${t.description})` : ""}: ${t.fields.map((f) => `${f.name} = ${f.label}${f.required ? "" : " (opcional)"}`).join("; ")}`,
+          )
+          .join("\n")}\n</request_types>`
+      : "",
+  ]
+    .filter(Boolean)
+    .join("\n");
+}
+
+export function describeAttachments(raw: string): string {
+  const list = JSON.parse(raw || "[]") as StoredAttachment[];
+  return list
+    .map((a) => {
+      if (a.type === "audio") {
+        const label = a.voice ? "nota de voz" : "audio";
+        return a.transcript ? `[${label}: "${a.transcript}"]` : `[${label} sin transcribir]`;
+      }
+      if (a.type === "image") return "[imagen]";
+      if (a.type === "video") return "[video]";
+      if (a.type === "sticker") return "[sticker]";
+      return `[archivo${a.name ? `: ${a.name}` : ""}]`;
+    })
+    .join(" ");
+}
+
+/** true si el mensaje tiene adjuntos que todavía se están descargando o transcribiendo. */
+export function hasPendingMedia(m: MessageRow): boolean {
+  const list = JSON.parse(m.attachments || "[]") as StoredAttachment[];
+  return list.some((a) => !a.key && !a.error);
+}
+
+/**
+ * Convierte el historial a mensajes de Claude. El cliente es `user`; el bot y los asesores, `assistant`.
+ * `images` agrega fotos (ya en base64) a mensajes del cliente por id.
+ * Devuelve null si el último mensaje no es del cliente: no hay nada que responder.
+ */
+export function toClaudeMessages(
+  history: MessageRow[],
+  images: Map<string, Anthropic.ImageBlockParam[]> = new Map(),
+): Anthropic.MessageParam[] | null {
+  const turns: Anthropic.MessageParam[] = [];
+  for (const m of history) {
+    if (m.sender_type === "system" || m.sender_type === "note") continue;
+    const text = [m.content?.trim(), describeAttachments(m.attachments)].filter(Boolean).join(" ");
+    if (!text) continue;
+    const role = m.sender_type === "contact" ? "user" : "assistant";
+    if (turns.length === 0 && role === "assistant") continue; // el primer turno tiene que ser del cliente
+    const pics = role === "user" ? images.get(m.id) : undefined;
+    turns.push({ role, content: pics?.length ? [...pics, { type: "text", text }] : text });
+  }
+  if (turns.length === 0 || turns[turns.length - 1].role !== "user") return null;
+  return turns;
+}