Saltar al contenido principal
Una pregunta Choice pide a GLiDE que elija una opción de un conjunto fijo, definido por quien hace la llamada, de entre 2 y 255 opciones con nombre. La respuesta incluye la opción seleccionada, un valor de confianza y una distribución de probabilidad completa sobre todas las opciones que definiste. Usa un Choice cuando la respuesta sea una de varias categorías sin orden: qué equipo debería encargarse de un ticket, a qué categoría pertenece un producto o en qué idioma está escrito un fragmento.

Solicitud

string
requerido
Siempre "choice".
string | object
requerido
La pregunta que se va a evaluar, como cadena u objeto no vacío. Un objeto JSON se serializa como texto JSON compacto.
object
requerido
Un objeto que asigna entre 2 y 255 claves de opción a cadenas de descripción, por ejemplo {"billing": "Payment or charge disputes", "returns": "Refund or return requests"}. Una sola opción no es válida porque no puede representar una decisión ni un margen de confianza significativo. Tanto los nombres de las opciones como sus descripciones se envían al modelo, así que escribe descripciones que distingan entre sí las opciones que suenan parecidas.

Objeto de respuesta

La entrada correspondiente dentro de answers es:
  • choice: la opción con mayor probabilidad.
  • probabilities: la distribución completa sobre todas las opciones que definiste; las claves coinciden con las claves de tu criteria y suman ~1.
  • confidence: top1 − top2, el margen de probabilidad entre la mejor y la segunda mejor opción, de 0 (dos opciones empatadas) a 1 (una opción concentra ~toda la masa de probabilidad). Consulta confianza e incertidumbre para saber cómo actuar en consecuencia.

Uso del resultado

Haz todas las preguntas que necesites en una sola llamada

Evalúa varias preguntas Choice sobre el mismo state en una sola solicitud en lugar de hacer una solicitud por pregunta. Se responden de forma independiente, así que añadir una pregunta consume tokens pero apenas cambia la latencia. Una llamada de triaje de soporte podría preguntar department, urgency y tone a la vez en lugar de hacer tres viajes de ida y vuelta; tu código puede actuar sobre department e ignorar el resto hasta que los necesite. Consulta Combinar varias preguntas para ver un ejemplo práctico. Dale al modelo la lista completa de opciones reales en lugar de una lista reducida: una pregunta Choice acepta entre 2 y 255 opciones y cada una cuesta solo unos pocos tokens. Añade una opción other o none of the above cuando la entrada pueda no cubrir todos los casos, para que GLiDE tenga dónde colocar la masa de probabilidad en lugar de forzar una mala coincidencia con una de tus opciones con nombre.