Saltar al contenido
Respuestas tipadas con probabilidades: una llamada con dos preguntas, una probabilidad de sí o no y una elección con su confianza.

Respuestas tipadas con probabilidades desde una sola API de modelos

, 3 min de lectura, By Jaber Jaber

Ingeniería

La API del RightNow decision model acepta texto, estado JSON (estado de robot), imágenes, voz, PDF y video (vista previa), y devuelve respuestas tipadas con probabilidades.

El RightNow decision model toma decisiones estructuradas: envía un estado y preguntas con nombre, y luego lee probabilidades, confianza y respuestas tipadas. Cada respuesta vuelve bajo el nombre de su pregunta: una probabilidad de sí o no entre 0 y 1, o la opción elegida con su confianza y la probabilidad de cada opción.

¿Qué es un modelo de decisiones?

Una decisión empareja tu estado con preguntas con nombre y devuelve cada resultado bajo su nombre. El estado es texto, un objeto JSON o un arreglo JSON.

Un estado JSON puede describir el estado de un robot, por ejemplo {"battery_percent":80,"moving":false}. Envía código como texto en state.

Cada pregunta tiene un nombre, un type e instructions. Ver Decisiones, o lee Presentamos el RightNow decision model.

¿Qué se puede enviar?

Entrada en línea: texto, estado JSON (estado de robot), imágenes, voz, PDF, video (vista previa). Solo los formatos listados son compatibles.

Un archivo se envía como un elemento dentro de state. Envía una imagen como data URL de PNG o JPEG, un PDF como data URL con su nombre, un video como data URL de MP4, y audio como datos WAV en base64 con su formato. Ver Entradas.

¿Qué devuelve?

answers contiene una respuesta por pregunta, bajo el nombre de la pregunta. Una respuesta noul es una probabilidad de sí o no, entre 0 y 1. Una respuesta choice es la opción elegida, con su confidence entre 0 y 1 y la probabilidad de cada opción en probabilities. usage.cost es el costo de la llamada.

Una llamada con dos preguntas tipadas. El estado dice que el pedido 1234 pide un reembolso 45 días después de la entrega, y la política permite 30 días. La pregunta de sí o no refund_allowed vuelve como una probabilidad entre 0 y 1. La pregunta de elección next_step vuelve como approve, deny o escalate, con su confianza y una probabilidad para cada opción.
La forma de la respuesta. Cada tipo representa un valor. Llámala con tu clave

¿Cómo se llama?

Una clave de la página de claves de API llama al RightNow decision model en la misma URL base que cualquier modelo abierto. Con una clave de la página de claves de API, llama a POST /v1/decisions. Envía rightnow-decision como model. Usa el alias para seguir el modelo vigente, o un ID fijado para elegir una versión.

Shell
curl https://api.rightnowai.co/v1/decisions \
  -H "Authorization: Bearer $RIGHTNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rightnow-decision",
    "state": "Order 1234: the customer asks for a refund 45 days after delivery. The policy allows 30 days.",
    "questions": {
      "refund_allowed": {"type": "noul", "instructions": "Is the refund allowed under the policy?"},
      "next_step": {"type": "choice", "instructions": "What should support do next?",
        "options": ["approve", "deny", "escalate"]}
    }
  }'
A call with your key. Call it with your key

Define RIGHTNOW_API_KEY en el proceso que hace la llamada. Mantén la clave en tu servidor y llama por HTTPS. Ver Guía rápida.

¿Cuánto cuesta?

Con el RightNow decision model pagas por la entrada, las preguntas respondidas y una llamada respondida.

Uncached text input costs USD 0.19 per million input tokens, and cached text input USD 0.019. Each answered question costs USD 0.0001, and each answered call USD 0.00001. Output is free.

Una llamada con un archivo cuesta el precio del texto y la tarifa de cada archivo de la tarjeta de precios. Las preguntas rechazadas no se cobran. Ver Precios.

¿Dónde están los límites?

El estado de texto estándar admite hasta 38,000 tokens. Con una clave de la página de claves de API, el audio es solo WAV y una llamada admite a lo más 32 preguntas.

El audio está limitado a 60 segundos por solicitud. Envía hasta 4 imágenes por solicitud. Un PDF puede tener hasta 500 páginas. Envía un MP4 H.264 silencioso de hasta 10 segundos, sin otros archivos.

calibrated es false en esta versión.

Una clave de la página de claves de API tiene su propio límite por minuto: lee X-RateLimit-Limit en sus respuestas. Ver Entradas y Límites.

Respuestas rápidas

¿Qué tipo de pregunta debo usar?

noul es una probabilidad de sí o no. En una llamada de texto, choice admite de 2 a 10 options y score admite de 2 a 4 levels.

¿Puedo enviar archivos?

Sí. Envía los archivos en línea. Solo los formatos listados están disponibles.

¿Qué ID de modelo envío?

Envía rightnow-decision. Para fijar una versión, usa rightnow-decision-3.0.0.

¿Cómo consigo una clave?

Crea una clave con nombre en Claves de API, en un workspace activo. Una clave pertenece a su workspace y se muestra una sola vez.

¿Se cobran las preguntas rechazadas?

No. Una solicitud con todo rechazado no tiene cargo de texto, pregunta, archivo ni llamada.