Los monitores están incluidos en los planes Observability e Improve. En el plan Gratis, la página Monitores explica qué hacen y qué plan los habilita. Consulta Planes, límites y retención.
Monitorear empresas seleccionadas
Elige Empresas, busca las que necesitas y selecciona al menos una. La selección usa la empresa atribuida a cada conversación. Incluye automáticamente las conversaciones de todos los agentes para esas empresas, también las de futuros agentes. Se excluyen las conversaciones sin empresa o atribuidas a una empresa no seleccionada. Cambiar las empresas asignadas a un agente no modifica la cobertura histórica. Puedes guardar un monitor para empresas que todavía no tengan agentes ni conversaciones. Mostrará Todavía no hay conversaciones coincidentes hasta que lleguen resultados coincidentes. Esto se aplica a todos los tipos de monitor, incluidos los de audio. Cambia la selección en la configuración del monitor. El historial, las tasas, las exportaciones y las alertas usan la selección actual; los resultados guardados se conservan. Los filtros de empresa de la barra lateral y los filtros de metadatos reducen aún más esa selección. Las conversaciones históricas solo se evalúan si activas expresamente el análisis histórico. Un análisis en cola no puede añadir empresas fuera de la selección que autorizaste. Eliminar la última empresa seleccionada deja un monitor que no coincide con ninguna conversación. Deshabilitar la función Empresas no elimina ni amplía los alcances guardados. Las comparaciones de modelos de un alcance anterior se marcan como desactualizadas; ejecuta una nueva comparación para evaluar la selección actual.Componentes de un monitor
Un monitor es un pipeline de etapas que se ejecutan en orden:
Los filtros se ejecutan primero y detienen el pipeline cuando no se cumplen,
antes de incurrir en el costo de etapas posteriores. Coloca filtros gratuitos
antes de evaluaciones con modelos cuando puedan resolver la selección.
Cada
ai_analyze devuelve un booleano, número, opción de una lista, texto,
lista de textos o JSON. Designa una etapa booleana, numérica, de flujo,
herramienta o código como principal para calcular la tasa de afectación.
Sin etapa principal, el monitor solo extrae valores y muestra volumen, no tasa.
En cada paso de IA, configura Incluir prompt del agente e Incluir contexto
de la conversación (CRM) por separado. Ambos empiezan desactivados en pasos nuevos;
los existentes conservan sus ajustes (los antiguos sin ajustes explícitos
incluyen el prompt y excluyen el CRM). Los pasos con los mismos ajustes comparten
una petición; los demás usan peticiones separadas, reflejadas en el costo estimado.
Las comprobaciones de flujo siempre incluyen el prompt y excluyen el CRM. Un paso
no recibe resultados de IA de otros grupos de contexto. Las pruebas con conversaciones
reales incluyen los datos CRM disponibles solo en los pasos que los habilitan.
Un monitor compuesto únicamente por filtros es gratuito: superar los filtros
es la señal. Las etapas filter_regex positivas y no negadas también guardan
automáticamente el texto detectado, el fragmento, el rol y el índice del turno,
sin código ni LLM. Esta evidencia se incluye en los
webhooks monitor.matched, donde
se documentan los límites de tamaño y las coincidencias entre turnos.
Un monitor con código y sin etapas de IA cuesta USD 1 por cada 100.000 de resultados
exitosos (USD 0,00001 por resultado), una vez por monitor y conversación, sin
importar el número de etapas de código. No se cobran evaluaciones fallidas, sin
puntuación o descartadas por filtros. Los monitores mixtos de IA y código mantienen
su precio de IA sin un cargo adicional por código. Los reintentos siguen siendo
gratuitos por defecto.
Comprobaciones de herramientas
Usa una comprobación de herramientas para saber si el agente hizo algo, como ejecutarsubmit_order, reservar o buscar un cliente, en vez de si dijo
que lo hizo. La etapa busca nombres en turnos tool sin distinguir mayúsculas
ni puntuación: submit_order, submitOrder y submit-order son equivalentes.
- La confirmación verbal no demuestra éxito. Una expresión regular opcional
detecta afirmaciones en los turnos del agente. «Tu pedido está confirmado»
sin un evento correcto de
submit_orderse marca como afirmación sin ejecución. - La ausencia de metadatos no es un aprobado. Conversaciones antiguas o proveedores sin esos eventos reciben evidencia insuficiente, sin puntuación principal; tampoco se consideran fallos demostrados.
Etapas de código
Una etapa de código sirve para reglas deterministas que prefieres escribir. El fragmento TypeScript, sin imports, se ejecuta una vez por conversación y devuelve un valor. Los monitores sin IA usan el precio por resultado indicado arriba. El código funciona igual en pruebas, conversaciones nuevas y análisis histórico. Recibe un argumentoinput:
exit(value)detiene el pipeline.returnguarda el valor y continúa;exit(value)lo guarda y omite todas las etapas posteriores, incluido su costo de IA. Úsalo cuando una comprobación barata ya determine la respuesta.- Los resultados locales anteriores al primer paso de IA llegan a cada grupo. Una etapa de código que devuelve un valor antes del primer paso de IA lo aporta como señal de referencia. Los resultados de código posteriores y los de IA de otros grupos no se añaden a esas señales compartidas.
input. Se detienen bucles infinitos y uso
excesivo de memoria. Los imports se rechazan y la sintaxis se comprueba al guardar.
Crear un monitor
En Monitores → Nuevo monitor, busca o explora las plantillas. Todas las organizaciones reciben el mismo catálogo. Cada plantilla muestra sus salidas antes de elegirla; al seleccionarla puedes editar sus instrucciones. Elige Crear monitor personalizado para comenzar con una descripción en lenguaje natural. Indica qué observar y en qué agentes. El espacio de creación muestra un asistente a la izquierda y el monitor a la derecha. El asistente puede buscar conversaciones reales, probar filtros y proponer un pipeline completo. Sus propuestas se aplican al editor; también puedes editarlo manualmente y el asistente continuará desde el contenido actual.Evaluaciones de audio
Las plantillas de Evaluaciones de audio puntúan la grabación, no la transcripción: calidad del audio del usuario, latencia de respuesta y precisión de pronunciación o idioma. Elige una, ajusta el umbral y los agentes y créala como cualquier monitor.Pruébalo antes de activarlo
Probar ejecuta la configuración actual en hasta 10 conversaciones. Está disponible al crear un monitor y en la pestaña Configuración de los monitores guardados, incluso pausados. Selecciona Ejecutar prueba para ver el veredicto, los valores y el razonamiento de cada etapa, y cualquier error de evaluación. La prueba incluye cambios sin guardar, no activa el monitor ni guarda resultados en las conversaciones. Las etapas de IA consumen créditos o tokens de tu proveedor. Si modificas la configuración, los resultados anteriores se marcan como desactualizados: vuelve a probar. Una prueba completada confirma la ejecución; revisa los veredictos para comprobar su precisión.- El selector solo ofrece conversaciones con transcripción.
- Las pruebas usan el proveedor y el modelo seleccionados, incluida tu clave de OpenRouter, Vercel AI Gateway o TypeSafe. Un monitor guardado puede reutilizar su clave, y cualquier monitor puede elegir una clave guardada una sola vez en Configuración → Proveedores de IA.
- Probar y simular requiere ser propietario o administrador, por el gasto puntual de evaluar hasta diez conversaciones por clic, con una petición por cada grupo de contexto alcanzado en cada conversación. Todos los miembros pueden crear monitores; los miembros sin esos permisos ven una explicación en el paso Probar.
Simular una conversación
Simular una conversación genera una transcripción sintética a partir de una situación breve y del prompt vigente del agente, por ejemplo un usuario frustrado porque no encuentra su reserva. Se añade a las pruebas junto a las conversaciones reales. Sirve para casos raros o comportamientos que aún no ocurrieron. Las simulaciones de prueba no se guardan como conversaciones ni aparecen en el historial. Para escenarios reutilizables, aserciones y comparación entre prompts, consulta Simulaciones.Evaluar conversaciones recientes
Por defecto, el monitor empieza vacío y solo evalúa conversaciones posteriores a su creación. Evaluar también conversaciones recientes permite analizar hasta 10 días anteriores. El control muestra el número de conversaciones y el costo aproximado al ajustar el periodo. Está desactivado hasta que lo habilites y solo lo ven propietarios y administradores. El análisis se ejecuta en segundo plano después de guardar, de las conversaciones más nuevas a las más antiguas, con un máximo de 5.000 conversaciones. Si el periodo supera el límite, el control lo avisa y calcula el costo sobre el número limitado.Define tu orden de lectura
Arrastra un monitor por su control en las vistas Gráfico o Lista para establecer tu orden. Se aplica en todos tus listados, incluido el panel Monitores de una conversación. Con el teclado, enfoca el control con Tab, pulsa espacio para tomarlo, usa las flechas y pulsa espacio para soltarlo. Escape cancela.- El orden es personal. No cambia el de tus compañeros.
- Los monitores nuevos se añaden al final. Restablecer orden recupera el orden predeterminado.
- Con filtros solo se mueven los visibles. Los monitores ocultos mantienen sus posiciones.
Interpretar un monitor
Usa 1d, 7d, 15d o 30d para un periodo móvil hasta hoy, o Personalizado para un día UTC o fechas exactas; no se permiten fechas futuras. El periodo filtra valores principales, Gráfico, Lista y Comparar y se guarda en la URL. Las tarjetas y filas muestran el estado Activo/Pausado y la cobertura evaluada de la versión actual. Las tendencias históricas usan todas las versiones y el denominador indicado de conversaciones con transcripción. Abre Monitores → Reportes para consultar reportes guardados y descargar PDF. Propietarios y administradores pueden seleccionar monitores y Crear reporte, o usar Agregar al reporte desde un monitor. Los borradores conservan empresa, metadatos y fechas; los filtros de agente/grupo no se guardan y se avisa antes de guardar. Cada reporte admite hasta 20 monitores y 31 días calendario. Abre uno, elige la semana anterior, la actual o fechas explícitas y usa Descargar PDF en el encabezado. CSV/JSON, detalles de evaluación e historial se despliegan al abrirlos. El envío semanal se habilita de forma explícita. Cuando las exportaciones están habilitadas, todos los miembros pueden usar Crear exportación desde un monitor, una selección o Monitores → Exportaciones. Elige CSV, Excel o Parquet para hasta 20 monitores y 100.000 conversaciones, configura sus propios filtros y periodo en la zona horaria indicada y comprueba el número de conversaciones coincidentes antes de crearla. Se incluyen resultados históricos por defecto; activa Solo versión actual para restringirlos. Cada fila contiene los resultados guardados y los valores de etapas de una conversación, indicando la versión con la que se evaluó cada monitor. No incluye revisiones reemplazadas por una nueva evaluación. El razonamiento es opcional y no se incluyen transcripciones ni metadatos de conversaciones. La organización comparte el historial y puede descargar los archivos durante 30 días o regenerar exportaciones fallidas o vencidas con datos actuales. Descargar tabla conserva la descarga inmediata de la tabla de resultados. Antes de descargar todos los resultados coincidentes, Descargar tabla comprueba la cantidad: la descarga directa en CSV admite hasta 10.000 filas y la descarga de revisión hasta 1.000 casos. Si la selección supera el límite, elige Página actual, reduce los filtros de la tabla o abre Exportaciones para una exportación más grande. Las exportaciones usan su propio periodo y filtros; los filtros de la tabla no se copian automáticamente. Usa Hoy, Últimos 7 días o Últimos 30 días para elegir el periodo de la exportación. Hoy comienza a medianoche en la zona horaria indicada; los otros atajos usan ventanas móviles. Todos terminan en el instante en que los eliges. Editar cualquiera de los límites desactiva el atajo sin cambiar los demás filtros. En el historial, Reutilizar filtros abre una nueva solicitud a partir de una exportación en cola, en generación o lista. El período, los monitores, las condiciones y los demás ajustes guardados quedan precargados para revisarlos y editarlos. Puedes conservar el formato o elegir otro; cada solicitud usa datos actuales y conserva el archivo original. Las exportaciones fallidas o vencidas ofrecen el mismo flujo como Crear nuevamente. En el historial, Cambiar formato está disponible para exportaciones en cola, en generación y listas. Elige un formato distinto entre CSV, Excel o Parquet para crear otra exportación con los filtros guardados y datos actuales. La solicitud y el archivo originales se conservan; la nueva exportación mantiene la selección de versiones guardada. Si se limita a la versión actual, se resuelve al comenzar la generación. Para avisar a un receptor externo cuando el archivo esté listo, elige un destino activo y aprobado en Notificar al completar, o conserva Sin notificación. Los propietarios y administradores aprueban los destinos en Webhooks. El estado del envío es independiente de la generación del archivo.Exportar con una API key
Su backend puede solicitar exportaciones filtradas con una API key de organización, sin una sesión del navegador. Las exportaciones deben estar habilitadas y la organización debe tener acceso a Monitores. UsenAuthorization: Bearer YOUR_API_KEY;
no envíen un slug ni ID de organización. Las keys exclusivas de ingesta no pueden leer exportaciones.
- Envíen
POST https://api.zelto.ai/v1/monitor-exportscon un UUIDoperationIdyconfig. Sustituyan el ID del monitor y generen su propio ID de operación. - Consulten
GET https://api.zelto.ai/v1/monitor-exports/{id}con la misma key, cada cinco segundos, hasta questatusseacompleted,failedoexpired. - Cuando termine, llamen a
GET https://api.zelto.ai/v1/monitor-exports/{id}/downloadcon la key. Sigan la redirección 307 para descargar sin reenviar la API key al almacenamiento. La URL firmada dura como máximo 15 minutos y debe mantenerse privada.
operationId, configuración y dueño de la key al reintentar
una solicitud después de un timeout; así recuperan la exportación original sin
duplicar trabajo. Cambiar la configuración con el mismo ID devuelve 409. Una nueva
exportación requiere otro ID de operación. Las solicitudes devuelven 202, incluidos
los reintentos; revisen status en la respuesta.
La configuración admite companyId, agentId, groupId, hasta ocho condiciones
metadata y result por monitor (all, affected, not_affected). match: "all"
o "any" combina las condiciones explícitas de resultado; los metadatos siempre
se combinan con AND. since es inclusivo y until exclusivo, según la fecha de
llamada (startedAt, o ingreso si falta). versionScope es historical por defecto;
current usa las versiones vigentes al iniciar la generación. Los límites,
formatos, retención y explicaciones opcionales son los mismos de la exportación
anterior. Estos endpoints exportan resultados guardados, incluida la evidencia
regex capturada automáticamente cuando está disponible; no reprocesan llamadas
ni extraen keywords adicionales. Los resultados históricos y los filtros sin una
coincidencia regex positiva pueden tener valores de etapas vacíos.
Cuando los webhooks de exportaciones están habilitados, notificationEndpointId
puede identificar un destino activo y aprobado por un administrador de su
organización; el dueño de la key debe conservar su membresía. Se envía
monitor_export.completed al terminar. Consulten
Webhooks
para ver el contenido y validar la firma. Nunca incluyan una API key en una URL
ni en el contenido de un webhook.
Una exportación inexistente devuelve 404; descargar mientras se genera devuelve
409 y un archivo vencido devuelve 410. La función deshabilitada o los fallos
temporales devuelven 503. Cada solicitud verifica el acceso actual de la key;
las descargas quedan auditadas.
Filtrar por metadatos de la conversación
La barra Metadatos filtra las conversaciones utilizadas para calcular las cifras, no los monitores que aparecen. Añade una clave comocampaign o model.provider,
un operador y un valor. Se sugieren claves recientes. Los operadores son igual,
distinto, contiene, no contiene, mayor/menor que y sus formas inclusivas, está
definido, no está definido, verdadero y falso. Hasta ocho filas se combinan con
AND, igual que en Conversaciones.
El filtro afecta tasas, recuentos y gráficos de la lista, columnas de Comparar,
tendencias y gráficos por etapa del Resumen, el embudo y las filas de
Resultados. Se guarda como ?meta=key:op:value, se conserva al cambiar de
vista, periodo o pestaña y pasa de la lista al detalle y a Comparar. En Comparar,
la barra aparece al elegir dos o más columnas.
Al abrir un monitor desde el resumen o un reporte, la vista de lectura conserva
fechas y filtros y muestra cobertura y conversaciones de la versión actual. Desde un
reporte también conserva su zona horaria. El enlace de regreso vuelve al mismo
periodo; Abrir configuración del monitor sale de ese alcance y abre el detalle:
- Resumen: tasa de afectación y gráficos de etapas compatibles.
- Resultados: conversaciones evaluadas con veredictos y valores por etapa.
- Benchmark: compara los niveles Rápido, Equilibrado y Avanzado con una muestra automática de conversaciones ya evaluadas.
- Configuración: pipeline, agentes y modelo. Editar aumenta la versión; los resultados históricos conservan la versión original y no se recalculan.
- Alertas: umbrales y destinatarios.
Alertas
En Alertas, define si el valor debe estar por encima o por debajo de un porcentaje, el periodo móvil y, opcionalmente, cuántos días consecutivos debe mantenerse la infracción. Las notificaciones se envían a Slack, a una lista de correos o a ambos. Se evalúan diariamente: espera la primera notificación dentro de un día desde el inicio del incumplimiento, más los días consecutivos que hayas exigido.De un hallazgo a un monitor
Un hallazgo reúne evidencia de un problema; un monitor lo comprueba continuamente. En las acciones del hallazgo, Promover a monitor crea uno con sus conversaciones existentes para comenzar la tendencia con ese historial.Mediante MCP y el agente
MCP exponecreate_monitor con criterios o un starterKey de
list_starter_monitors, create_pipeline_monitor, list_monitors,
get_monitor_results, update_monitor, set_monitor_enabled, delete_monitor,
promote_finding_to_monitor y save_monitor_alert.
update_monitor cambia nombre, pausa o etiquetas, sustituye los agentes
(agentIds; [] significa todos los agentes de la organización, incluidos
monitores de audio) o sustituye la selección de empresas (companyIds, al menos
una). agentIds y companyIds son mutuamente excluyentes; omitir ambos conserva
el alcance guardado. Las herramientas de creación también aceptan companyIds,
y list_monitors devuelve el alcance y las empresas seleccionadas. Editar el
alcance por empresas actualiza el historial visible sin eliminar resultados
guardados ni evaluar automáticamente conversaciones antiguas. La herramienta también
modifica sampleRate entre 1 y 100. Para cambiar la rúbrica o el pipeline sin perder
los resultados, usa update_monitor_pipeline (solo propietario o administrador; consulta
MCP). Antes de crear un tool_check, llama a list_agent_tools para
obtener los nombres exactos de las herramientas que los agentes invocaron.
Para cambiar el contexto de un paso de IA existente, consulta su ID con
get_monitor y pasa stageContext: [{ stageId: "step-id", useAgentPrompt: false, useCallContext: true }] a update_monitor. Las opciones omitidas se conservan;
todos los cambios enviados se aplican de forma atómica. Cambiar el contexto
aumenta la versión para evaluaciones futuras, sin modificar resultados históricos.
Relacionado
- Agentes: a quién se asigna un monitor.
- Conversaciones: resultados por conversación.
- Hallazgos: problemas que puedes promover.
- Simulaciones: escenarios sintéticos reutilizables.
- Slack: destino de alertas.
- Proveedores de IA: ejecuta monitores con la clave propia de tu organización de OpenAI, Anthropic, OpenRouter, Vercel AI Gateway o TypeSafe.
Modelos TypeSafe con tu propia clave
Selecciona TypeSafe (BYOK) en la configuración del modelo del monitor, eligejev-latest (o introduce un ID de modelo de TypeSafe) y proporciona tu clave API
de TypeSafe. Zelto cifra la clave por monitor. Dejar el campo vacío al editar
conserva la clave guardada solo si el proveedor no cambia. Al cambiar de
proveedor debes introducir una nueva clave.
TypeSafe admite estos resultados de verificaciones con IA:
- Sí / no: una probabilidad Noul de al menos el 50 % se convierte en
true. - Categoría: Choice devuelve una de tus opciones de categoría únicas.
- Número: introduce entre 2 y 10 niveles descriptivos, uno por línea, de menor a mayor. La puntuación fraccionaria se distribuye uniformemente entre el mínimo y el máximo (por defecto, 0–100). Una puntuación de 1,5 en tres niveles equivale a 7,5 en un rango de 0–10. Usa estas puntuaciones para evaluaciones, no para extraer números.
Evaluar evidencia de la traza
Activá Usar la traza de la llamada en una etapa de IA o código para evaluar pasos, entradas, salidas, errores, tiempos y logs registrados junto con la transcripción. La IA puede citar identificadores de spans y marcas de tiempo. El código accede ainput.trace.spans e input.trace.logs, por ejemplo:
Reintentar resultados con error
En la pestaña Resultados, los propietarios y administradores pueden seleccionar resultados con error individuales o todos los errores elegibles de la página y pulsar Reintentar seleccionados. Cada resultado se encola para un reintento inmediato con la configuración actual, incluso si los reintentos automáticos están desactivados. Los resultados con un reintento activo muestran Reintento encolado y no pueden seleccionarse de nuevo hasta que termine. La selección se limita a la página actual (hasta 50 resultados) y se borra al cambiar de página o filtros. No está disponible para monitores pausados, monitores de audio ni vistas limitadas a una empresa. Los reintentos de resultados de monitores son gratuitos por defecto; un administrador de la plataforma puede habilitar el cobro de reintentos futuros. En Configuración → Reintentos, los propietarios y administradores pueden activar Reintentar automáticamente los resultados con error y elegir un plazo entre 1 minuto y 7 días. Está desactivado por defecto. Cada conversación con error se reintenta como máximo una vez por versión del monitor, con su configuración actual. Incluye los errores existentes: su plazo comienza al guardar la configuración. Los errores nuevos esperan desde el momento de su evaluación. El worker comprueba los reintentos pendientes aproximadamente cada minuto; una cola ocupada puede retrasar el inicio. La misma política de cobro se aplica a los reintentos automáticos. Un reintento completado reemplaza el resultado guardado y actualiza los informes. No se reintentan resultados correctos, conversaciones excluidas por filtros ni resultados sin datos de referencia. Esta opción no se aplica a monitores de audio basados en grabaciones. Desactiva la opción o pausa el monitor para cancelar los trabajos que no han comenzado. Desactivar los reintentos automáticos no cancela los reintentos seleccionados explícitamente. Si el reintento vuelve a fallar, conserva el error sin generar un bucle de reintentos.Enviar resultados de monitores a tu sistema
Usa webhooks salientes para enviar cada nuevo resultado positivo de un monitor a tu base de datos o CRM. Configura destinos en Configuración → Integraciones → Webhooks, verifica una prueba y evita duplicados usando el ID del evento recibido. Estos eventosmonitor.matched por conversación son distintos de los webhooks de reportes semanales agregados.
