Saltar al contenido
SONOEDocs
EnglishENConsola

Score

Un Score ubica el estado en niveles ordenados que tú describes, del más bajo al más alto. La respuesta es una posición que puede quedar entre dos niveles, una probabilidad para cada nivel y una confianza.

Solicitud

type"score"requerido
instructionsstring | object | arrayopcional

Qué calificar. Si no la mandas, Sonoe pregunta qué nivel encaja mejor.

criteriaarray<string | object | array>requerido

Los niveles en orden, del más bajo al más alto. De 2 a 10.

{
  "model": "sonoe-latest",
  "state": "¡Me encanta, cinco estrellas, lo volvería a comprar!",
  "questions": {
    "sentimiento": {
      "type": "score",
      "instructions": "¿Qué tan positiva es esta reseña?",
      "criteria": ["Muy negativa", "Negativa", "Neutral", "Positiva", "Muy positiva"]
    }
  }
}

Respuesta

type"score"requerido
scorenumberrequerido

El nivel esperado: el índice de cada nivel (0, 1, 2…) ponderado por su probabilidad. Puede quedar entre niveles: 3.5 está entre «Positiva» y «Muy positiva».

legendmap<string, string | object | array>requerido
El índice de cada nivel (como texto) y el nivel que mandaste.
probabilitiesmap<string, number>requerido
El índice de cada nivel y su probabilidad. Suman 1.
confidencenumberrequerido
Qué tan seguro está Sonoe, de 0 a 1.
{
  "model": "sonoe-1.1.0",
  "answers": {
    "sentimiento": {
      "type": "score",
      "score": 3.155,
      "legend": { "0": "Muy negativa", "1": "Negativa", "2": "Neutral", "3": "Positiva", "4": "Muy positiva" },
      "probabilities": { "0": 0.0036, "1": 0.0181, "2": 0.0443, "3": 0.6876, "4": 0.2465 },
      "confidence": 0.4822
    }
  },
  "usage": { "input_tokens": 210, "output_tokens": 0 }
}

Cómo usar el score

El score es un número en tu escala, así que puedes compararlo y ponerle un umbral directamente:

s = answers["sentimiento"]
if s["score"] >= 3:
    pedir_una_resena_publica()

Si lo que necesitas es el nivel más probable, toma la clave con la probabilidad más alta en probabilities.

Consejos

  • El orden importa. Siempre del más bajo al más alto; el score se calcula con las posiciones.
  • Haz los niveles distintos. «Baja / Media / Alta» funciona; «Algo alta / Bastante alta / Alta» no.
  • Menos niveles, mejores respuestas. De 3 a 5 niveles suelen bastar.
  • En la API nativa, un Score es una pregunta scale: su value es el mismo número que score, y answer es el nivel más probable.