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 |
Otras funciones
Sección titulada «Otras funciones»| 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 |
ConfigAgente (desde la fila)
Sección titulada «ConfigAgente (desde la fila)»| 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) |