Clasificación de intención sobre la que puedes enrutar
Detectar la intención es elegir entre etiquetas que tú defines, no resumir el mensaje. Pide la elección y recibirás la distribución que necesitas para decidir qué pasa después.
La intención es una elección, no un resumen
La mayoría de los pipelines de intención piden a un modelo de chat que nombre la intención en prosa, y luego gastan las siguientes cien líneas en analizar y reintentar. La tarea en sí es una clasificación de conjunto cerrado: entra un mensaje, sale una etiqueta y un número que dice cuánta seguridad tenía el modelo.
Esta API adopta la segunda lectura. Tú declaras las intenciones que existen en tu producto y el modelo devuelve una probabilidad para cada una en una sola pasada, incluidas las bajas, que son lo que te permite escalar en lugar de adivinar.
La solicitud y lo que vuelve
El endpoint gratuito acepta un estado y una lista de preguntas, cada una con un prompt y las opciones que permites. El endpoint con clave acepta el mismo estado con preguntas tipadas que llevan instructions y criteria, que es donde corresponde la guía por etiqueta.
La respuesta replica tus ids: una opción, una confianza y un objeto probabilities indexado por las etiquetas que enviaste. Pide una intención u ocho; cada una se responde sobre su propio conjunto cerrado.
Enruta por la puntuación, no solo por la ganadora
La ganadora por sí sola descarta la información que hace seguro el enrutado. Una primera etiqueta con 0,41 y otra con 0,95 nombran una intención, pero solo una pertenece a una cola automatizada.
Aplica un umbral a la distribución: por encima, enruta; por debajo, retén y escala; y registra el vector completo para revisión. La API no decide tu umbral: te da el número sobre el que aplicarlo.
- Automatiza la mayoría de alta confianza hacia la cola correcta.
- Manda el centro ambiguo a una persona en lugar de a la cola equivocada.
- Guarda la distribución como prueba cuando alguien pregunte por qué un ticket fue a donde fue.
Varias preguntas, una solicitud
Rara vez la intención es lo único que necesita un enrutador. La urgencia, el sentimiento y si el cliente quiere darse de baja son preguntas acotadas distintas sobre el mismo mensaje, y pueden enviarse juntas: un estado, varias preguntas tipadas, un conjunto de respuestas.
Así las preguntas no discrepan sobre lo que decía el mensaje y el camino entre el cliente y la cola mantiene un solo viaje de ida y vuelta.
Límites que conviene conocer
El conjunto de etiquetas es cerrado, así que una intención que olvidaste declarar solo puede volver como la etiqueta declarada que mejor encaje, o como other si se la diste. Las etiquetas solapadas reparten la probabilidad entre ellas, lo que aparece como baja confianza en lugar de como error.
Para productos con intenciones por inquilino, usa un conjunto de etiquetas por solicitud o normaliza antes las etiquetas propias de cada inquilino en una taxonomía común. El modelo lee el estado y las opciones; no recuerda tu taxonomía entre llamadas.
Preguntas frecuentes
¿Cuántas etiquetas de intención admite una pregunta?
De dos a doce por pregunta de elección, y hasta ocho preguntas por solicitud tanto en el nivel gratuito como en los planes de pago. Una taxonomía de más de doce intenciones suele ser varias preguntas: primero un dominio y después la intención dentro de él.
¿Funciona en idiomas distintos del inglés?
Los nombres de las etiquetas y las instrucciones pueden escribirse en el idioma de tus mensajes. Mide el acuerdo sobre tu propia muestra antes de confiar en ello: las etiquetas de intención son específicas de cada producto y las evaluaciones publicadas no cubren tu taxonomía.
¿Puedo clasificar un hilo de tickets completo?
El estado es texto o JSON, así que un hilo puede enviarse como texto o como un array JSON de turnos. El nivel gratuito limita el estado a 8.000 caracteres; el de pago acepta 200.000 y el modelo rechaza lo que exceda su propia ventana en lugar de truncarlo.
¿Se puede probar gratis la clasificación de intención?
Sí. El playground del navegador y el endpoint sin clave funcionan con una asignación diaria y sin cuenta, y una clave de pago eleva el límite y añade estados con imagen.
Sigue leyendo
Notas del modelo
Un correo corto cuando salga un nuevo modelo de decisión o cambie un benchmark. Sin spam, baja en un clic.