Jev: Condición con IA

Descripción

Un If con criterio: en vez de comparar un campo con un valor, le pregunta a Jev algo que solo se decide leyendo el texto («¿el cliente está pidiendo un reembolso?», «¿el mensaje transmite urgencia?») y sale por una de tres salidas:

Sí: la probabilidad es igual o mayor que el umbral del Sí (por defecto 0,7).
No: es igual o menor que el umbral del No (por defecto 0,3).
Dudoso: está entre los dos. Es la salida para revisión humana.

Si Dudoso no está conectada, el flujo sigue por el lado más probable, y el nodo se comporta como un sí/no normal (jev.route_fallback será true).

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial TypeSafe (API key).
model	select	Sí	Modelo de Jev. `jev-latest` es un alias que cambia de modelo al publicarse versiones nuevas (hoy apunta a `jev-1.13.0`); en producción fija `jev-1.13.0` o `jev-1.14.0`.
state_mode	select	Sí	Qué se evalúa: `text` (un texto), `object` (objeto con campos con nombre, lo recomendado) o `all` (todos los datos que llegan al nodo).
state	textarea	No	Texto u objeto JSON a evaluar. Admite variables `\{\{campo\}\}`.
long_context	boolean	No	Contexto largo (experimental): sube el límite del texto de 64k a 262k tokens. Es más lento y menos preciso; úsalo solo si el texto no cabe de otra forma.
output_key	text	No	Clave de los datos donde se guarda el resultado. Por defecto `jev`; el resto de los datos se conserva.
question	textarea	Sí	Afirmación sí/no que Jev debe responder, p. ej. «El mensaje transmite urgencia».
criteria_true	textarea	No	Cuándo se considera «Sí» (opcional).
criteria_false	textarea	No	Cuándo se considera «No» (opcional).
threshold_yes	number	No	Sí si la probabilidad es mayor o igual. Por defecto 0,7.
threshold_no	number	No	No si la probabilidad es menor o igual. Por defecto 0,3. Debe ser menor que el del Sí.

Credenciales

Se requiere una credencial TypeSafe (credentials_id) con la api_key de la consola de TypeSafe (variable TYPESAFE_API_KEY). La clave es de tu cuenta: TypeSafe factura el consumo, no Floogos. En la credencial, el botón Test llama a GET /v1/models (no gasta tokens).

Salida

El resultado se añade a los datos de entrada (no los reemplaza): el ticket o el formulario siguen disponibles aguas abajo. Se lee como \{\{jev.campo\}\}.

{
  "nextModule": "selected-route-target",
  "data": {
    "...": "datos de entrada, intactos",
    "jev": {
      "answer": "yes",
      "probability": 0.93,
      "confidence": 0.86,
      "route": "yes",
      "route_fallback": false,
      "model": "jev-1.13.0",
      "usage": {
        "input_tokens": 80,
        "output_tokens": 3
      },
      "cost_usd": 0.000003
    }
  }
}

Varias salidas: route_yes, route_no, route_uncertain. Cada puerto se conecta a su destino; el nodo elige por cuál sale.

Ejemplo

Escalar solo lo urgente

Estado: \{\{mensaje\}\}. Pregunta: The customer is asking for a refund. Conecta Sí al nodo que crea la tarea de reembolso, No al flujo normal y Dudoso a una notificación para una persona.

Notas

Privacidad: el texto que evalúas sale de Floogos hacia TypeSafe, un tercero. Según su documentación no se usa para entrenar y la retención cero solo existe en su plan empresarial. No envíes datos que no puedas compartir; filtra antes con el nodo Jev: Verificar reglas (pii) si hace falta.
Idioma: Jev rinde mejor en inglés; otros idiomas, incluido el español, funcionan con menor precisión. Prueba con tus propios datos antes de automatizar y escribe las instrucciones en inglés si el resultado no es fiable.
Variables: el motor sustituye \{\{campo\}\} en la configuración antes de ejecutar el nodo. El nodo no vuelve a sustituir, así que un texto de usuario que contenga llaves viaja tal cual.
Coste: 0,042 $ por millón de tokens de entrada; la salida no se cobra. jev.cost_usd es una estimación por ejecución.
Errores: missing_credentials, validation (configuración o 422), auth_error (401), rate_limited (429), overloaded (529), state_too_large, jev_error y connection_error. 429, 529, 5xx y los cortes de red se reintentan solos (hasta 3 veces con espera creciente); el resto no.
Confianza: confidence no es una garantía de acierto: calibra los umbrales con tus propios casos y empieza de forma conservadora. No automatices acciones destructivas.