Preguntas

Una solicitud lleva un mapa de preguntas. Tú eliges cada clave y la respuesta vuelve bajo la misma clave. Cada pregunta se responde por separado y sobre el mismo estado: ninguna ve la respuesta de otra, y todas se evalúan en una sola pasada del modelo.

Tres tipos

Los nombres de la primera columna son los de /v1/systemone (la API compatible con Jev). La API nativa /v1/decide usa los de la última columna, con campos un poco distintos.

{
  "model": "sonoe-latest",
  "state": "La app se cierra cada vez que abro mis facturas.",
  "questions": {
    "es_error": { "type": "noul", "instructions": "¿El cliente reporta un error de la app?" },
    "area": {
      "type": "choice",
      "instructions": "¿De qué parte del producto se trata?",
      "criteria": { "facturacion": "Facturas, pagos, planes", "cuenta": "Acceso, perfil, ajustes", "pedidos": null }
    },
    "gravedad": {
      "type": "score",
      "instructions": "¿Cuánto le impide esto al cliente usar el producto?",
      "criteria": ["Nada", "Algo", "Por completo"]
    }
  }
}

Cómo elegir el tipo

• Un hecho de sí o no («¿Es spam?», «¿Menciona un reembolso?») → Noul.
• Una categoría de un conjunto (equipo, intención, idioma, área del producto) → Choice. Si puede que ninguna encaje, añade una opción para eso, como "otra": "Ninguna de estas".
• Un grado (urgencia, sentimiento, calidad) → Score, con niveles del más bajo al más alto.

Varias preguntas concretas suelen ganarle a una amplia. En vez de un solo Choice con 20 etiquetas combinadas, pregunta un Choice para el área y un Score para la urgencia, y combínalos en tu código.

Cómo escribir buenas preguntas

• Palabras simples. Con Sonoe 1.1, «Is this about a payment or a charge?» funciona mejor que «Is this about billing?».
• Describe las opciones. Un Choice con "facturacion": "Pagos, cobros, reembolsos" acierta más que con "facturacion": null.
• Una cosa por pregunta. «¿Es urgente y sobre facturación?» son dos preguntas.
• Ordena los niveles de un Score del más bajo al más alto y que sean distintos entre sí.
• Sé breve. La pregunta se vuelve a leer con cada opción, así que unas instrucciones largas cuestan tokens en cada una.

Costo

Pagas por los tokens que Sonoe lee. En cada pregunta, el modelo lee el estado y la pregunta una vez por opción: un Noul los lee dos veces (sí y no), un Choice de 5 opciones cinco veces. Mira Errores y límites.