Jev: Preguntar

Descripción

Este nodo es el más general de la familia Jev. Envía un texto (state) y un conjunto de preguntas tipadas a Jev, el modelo de decisiones de TypeSafe, y devuelve una respuesta por pregunta con probabilidades. No genera texto: elige entre las opciones que defines.

Jev evalúa todas las preguntas de la petición en paralelo, así que añadir preguntas apenas aumenta la latencia. Es el patrón fan-out: pide de una vez todo lo que pueda hacer falta y decide después, en el workflow, qué respuestas usar.

Tipos de pregunta

Tipo	Pregunta que responde	`criteria`	Respuesta
`noul`	¿Es verdadero?	opcional `{"true": "...", "false": "..."}`	probabilidad de 0 a 1
`choice`	¿Cuál de estas opciones?	objeto de opciones (1 a 255)	opción, confianza y probabilidades
`score`	¿Qué nivel de esta escala?	lista de niveles (1 a 10)	puntuación decimal, confianza y probabilidades

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.
questions	json	Sí	Mapa `{nombre: {type, instructions, criteria}}` o lista `[{name, ...}]`. Los nombres admiten letras, números, `_` y `-`.

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": "next-node",
  "data": {
    "...": "datos de entrada, intactos",
    "jev": {
      "answers": {
        "urgente": {
          "type": "noul",
          "probability": 0.95,
          "confidence": 0.9,
          "answer": "yes"
        },
        "equipo": {
          "type": "choice",
          "choice": "technical",
          "confidence": 0.7,
          "probabilities": {
            "billing": 0.1,
            "technical": 0.8,
            "sales": 0.1
          }
        },
        "enfado": {
          "type": "score",
          "score": 1.5,
          "normalized": 0.75,
          "label": "Very angry, strong language",
          "confidence": 0.6
        }
      },
      "model": "jev-1.13.0",
      "usage": {
        "input_tokens": 120,
        "output_tokens": 12
      },
      "cost_usd": 0.000005
    }
  }
}

Una sola salida (nextModule).

Ejemplo

Triaje de un ticket en una sola llamada

Preguntas:

{
  "urgente": { "type": "noul", "instructions": "The message conveys urgency or time-sensitivity" },
  "equipo": {
    "type": "choice",
    "instructions": "Which team should handle this",
    "criteria": { "billing": "Payment or subscription issues", "technical": "Bugs or integration problems", "sales": "Pricing or account questions" }
  },
  "enfado": {
    "type": "score",
    "instructions": "How frustrated the customer appears",
    "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
  }
}

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.