Ir al contenido

API del motor

import { ejecutarMotor, configDesdeFila, crearModelo, CASOS_BASE } from "@/lib/agente/core";

ejecutarMotor(entrada): Promise<SalidaMotor>

Sección titulada «ejecutarMotor(entrada): Promise<SalidaMotor>»
Entrada Tipo
config ConfigAgente De configDesdeFila(fila)
conocimiento Conocimiento[] Filas activas de ia_conocimiento (el motor filtra vigencia)
adaptadores Adaptadores Ver Herramientas y adaptadores
modelo LanguageModel De crearModelo()
mensajes Turno[] Historial { role: "user" | "assistant", content }, empezando por user
datos? Record<string,string> Datos ya capturados del lead
ahora? Date Para pruebas
Salida
respuesta Texto a enviar (vacío si silencio o error)
traspaso { motivo, resumen, lead_id? } | null
optout, silencio Banderas de atajos
datos Datos del lead tras el turno
herramientas, fuentes Trazas para ia_eventos
guardrails { intentos, violaciones[], accion: "ok" | "reparada" | "bloqueada" | "atajo" }
tokens, latencia_ms, error? Operación
Función Uso
configDesdeFila(fila) Normaliza ia_agentes (o equivalente) con valores seguros por defecto
crearModelo(env, modeloFila) Modelo según AGENTE_PROVEEDOR / NAN_API_KEY
construirInstrucciones(p) Prompt por capas (útil para depurar)
revisarEntrada(texto) continuar | humano | optout | no_texto | silencio
revisarSalida({ texto, config, fuentes }) Lista de violaciones
limpiarFormato(texto) Markdown → formato WhatsApp
fechaLocal(zona), estaVigente(c, hoy), fueraDeHorario(horario) Tiempo en la zona del negocio
buscarEnCatalogo(lista, texto) Búsqueda por palabras para catálogos en memoria
CASOS_BASE, Caso Casos dorados base (@/lib/agente/core/casos para helpers u, a, fallas, sinViol, usó)
VERSION Versión del motor
Columna / clave Campo
nombre, negocio, tono, instrucciones Identidad y estilo
mensaje_bienvenida, mensaje_traspaso, mensaje_fuera_horario, mensaje_error, mensaje_optout, mensaje_no_texto Mensajes fijos
horario.zona Zona horaria (por defecto America/Bogota)
flujo.{rutas, etapas, campos_lead, etapa_traspaso} Flujo comercial
herramientas.{buscar_catalogo, buscar_documentos} false apaga la herramienta
guardrails.{politica_precios, max_caracteres, dominios_permitidos} Validación de salida
temperatura 0-1 (por defecto 0,4)