models

Respan: Span-01 Lite

Markdown · JSON

Respan: Span-01 Lite

Span-01 Lite es el perfil de Respan, con nombre propio, para puntuar comportamientos en conversaciones de texto y trazas de agentes. Utiliza comportamientos definidos por quien realiza la llamada y devuelve para cada uno probabilidades de presente, ausente y no observable, con el mismo flujo de puntuación documentado que Span-01.

Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

Span-01 Lite es un perfil de modelo con nombre propio dentro de la familia de puntuación de comportamientos Span-01 de Respan. La guía de inicio rápido y la tabla de modelos del productor identifican Lite como uno de los dos perfiles que utilizan el mismo flujo de puntuación. Recibe una interacción de texto y definiciones de comportamientos en lenguaje natural, y devuelve tres probabilidades para cada definición: presente, ausente y no observable. La salida útil del perfil es un registro de comportamientos con incertidumbre explícita, no una respuesta escrita a la conversación.

Elige la observación y sus límites

Define el comportamiento con palabras que se ajusten a tu tarea. Para comprobar una transferencia a una persona, especifica si significa que el usuario pide expresamente hablar con alguien, que el asistente dice que hace falta una transferencia o cualquiera de las dos condiciones. Si la mera decepción no debe contar, indícalo. Para comprobar una disculpa, define qué formulaciones constituyen una disculpa, en lugar de depender de una etiqueta poco clara. Cada definición tiene un identificador que el evaluador devuelve con sus probabilidades.

El conjunto de comportamientos pertenece a quien realiza la llamada. Ejemplos como frustración, promesas sin respaldo, uso indebido de herramientas o acciones repetitivas del agente son definiciones que se deben proporcionar, no una lista fija de categorías nativas. Mantén cada definición observable en la interacción suministrada. Un tramo corto puede resolver si el asistente se disculpó, pero carecer de evidencia de que un problema externo se haya resuelto realmente.

Prepara el tramo de conversación

La entrada documentada de Respan coloca los mensajes anteriores en span.input y el turno que se evalúa en span.output. El contenido de los mensajes es una cadena de texto. Conserva el contexto necesario para entender el turno, incluidos los roles de los interlocutores, la solicitud pertinente del usuario y cualquier evidencia textual que haya utilizado el asistente. Para una comprobación de calidad, proporciona el turno real, en lugar de una paráfrasis que elimine el comportamiento que se está evaluando.

Una revisión ilustrativa puede tomar un mensaje del usuario que describe problemas repetidos y una respuesta del asistente que ofrece investigar. Define la frustración del usuario y la promesa del asistente como observaciones separadas. Si el resultado de una herramienta importa para juzgar si una afirmación tenía respaldo, conserva el texto pertinente de ese resultado en el contexto. La salida es una evaluación de esas definiciones en el tramo proporcionado; el modelo no realiza la investigación prometida ni modifica la conversación.

Presente, ausente y no observable

La respuesta de puntuación contiene el id del comportamiento con p_present, p_absent y p_not_observable, cuya suma es aproximadamente 1. No observable significa que la traza no permite responder a la pregunta. Es distinto de ausente. Para una definición como la aceptación de una solución por parte del cliente, un tramo que termina antes de que el cliente reaccione constituye evidencia incompleta, aunque la respuesta del asistente suene segura.

Conserva los tres valores al preparar un resultado para su revisión. Una categoría elegida según el valor más alto puede ser útil para mostrar el resultado, pero la distribución conserva el grado de incertidumbre de la observación. No utilices únicamente un valor bajo de presencia para concluir que el comportamiento definitivamente no ocurrió. Cuando predomina la falta de evidencia, la acción útil puede ser obtener el contexto pertinente o conservar el resultado como desconocido, en lugar de inventar una explicación.

Varias definiciones sobre la misma evidencia

El flujo de puntuación del productor evalúa conjuntamente varias definiciones de comportamientos sobre una traza y devuelve un resultado para cada identificador en el orden de la solicitud. Su documentación no especifica un límite de cantidad de comportamientos por solicitud. Esto no establece una ventana universal de tokens ni un tamaño ilimitado de traza. Mantén las definiciones orientadas a un propósito y la evidencia pertinente, y conserva la asociación entre cada resultado devuelto y la definición que lo produjo.

Los resultados de comportamientos son observaciones independientes, en lugar de una respuesta única de elección excluyente. La frustración, una disculpa y una transferencia propuesta pueden estar presentes en el mismo intercambio. Sus distribuciones individuales de tres posibilidades tienen significado dentro de cada definición; sumar los valores de presencia de distintos comportamientos no crea una distribución normalizada de categorías ni una puntuación de rúbrica ordenada.

Conserva el perfil seleccionado junto con sus resultados

El fabricante documenta los nombres Lite y estándar con un formato compartido de solicitud y resultado. Ese contrato permite preparar trazas e interpretar probabilidades de comportamientos para cualquiera de los perfiles con esos nombres. No establece que Lite tenga los mismos pesos, cantidad de parámetros o calidad que la otra edición. Mantén identificable el perfil seleccionado al revisar sus resultados, en lugar de intercambiar silenciosamente resultados de ediciones distintas.

Utiliza conversaciones etiquetadas de la tarea prevista para elegir umbrales de registro, asignación o revisión. Conserva los resultados con valores altos de no observable y las observaciones limítrofes para examinarlos, y compara cualquier error aparente con el turno original y la definición del comportamiento. El artefacto final útil contiene el identificador del tramo de texto, la definición, el perfil seleccionado y el resultado completo de probabilidades de las tres posibilidades. Un paso posterior de la aplicación decide qué hacer con esa observación; la salida de puntuación de Lite no ejecuta por sí misma una transferencia, bloquea una respuesta ni genera una corrección.

Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite

respan/span-01-lite

Respan /respan/span-01-lite

Inicio

Span-01 Lite es el perfil de Respan, con nombre propio, para puntuar comportamientos en conversaciones de texto y trazas de agentes. Utiliza comportamientos definidos por quien realiza la llamada y devuelve para cada uno probabilidades de presente, ausente y no observable, con el mismo flujo de puntuación documentado que Span-01.

Entradas aceptadas
Texto
Resultados
decisions

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · System One POST /v1/systemone
Entrada
text
Salida
decisions
Formato de salida
json
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
respan/span-01-lite
Predeterminado—
CampoproviderTiposchemaRequisitoOpcionalValores y límitesPredeterminado—
CampoquestionsTipoobjectRequisitoObligatorioValores y límitesPredeterminado—
Camposession_idTipostringRequisitoOpcionalValores y límitesPredeterminado—
CampostateTiposchemaRequisitoObligatorioValores y límitesPredeterminado—
CampotraceTiposchemaRequisitoOpcionalValores y límitesPredeterminado—
CampouserTipostringRequisitoOpcionalValores y límitesPredeterminado—
Campoquestions.<id>.typeTipostringRequisitoObligatorioValores y límites
noul, choice, score
Predeterminado—
Campoquestions.<id>.instructionsTipostring|object|arrayRequisitoObligatorioValores y límitesPredeterminado—
Campoquestions.<id>.criteriaTipoobject|arrayRequisitoOpcionalValores y límites
Condiciones: choice/score: obligatorios; noul: opcional. Los criterios de choice son un objeto; score es un arreglo con minItems1.
Predeterminado—
Campoquestions.<id>.criteria.trueTipostring|object|arrayRequisitoObligatorioValores y límites
Se aplica cuando: Se proporcionó el objeto de criterios noul
Predeterminado—
Campoquestions.<id>.criteria.falseTipostring|object|arrayRequisitoObligatorioValores y límites
Se aplica cuando: Se proporcionó el objeto de criterios noul
Predeterminado—
Combinaciones de materiales de entrada

noul · Obligatorio: state, questions.<id>.type=noul, questions.<id>.instructions

choice · Obligatorio: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object

score · Obligatorio: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1

Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, state, questions
Parámetromaterial_typesContratotext
Parámetrooptional_controlsContratoprovider, session_id, trace, user
Parámetromultimodal_input_bindingContratonull

Ciclo de vida: synchronous

Envía el ID exacto del modelo y conserva la respuesta nativa completa.

Tarifas

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo fast
Sin especificar Cuando se selecciona el modo fast
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default

Tarifas de Ailoot

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasTokens de contexto, más deTokens de contexto, hasta inclusiveCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseTokens de contexto, más de—Tokens de contexto, hasta inclusiveSin límite superiorCargo
Entrada · Tokens de entrada $0 / 1K tokens
Salida · Tokens de salida $0 / 1K tokens
Entrada · Lectura de caché — / 1K tokens
Entrada · Escritura en caché — / 1K tokens
Entrada · Escritura en caché, 1 hora — / 1K tokens
ConfiguraciónNivel 1 por longitud de la solicitudTabla de tarifas—Tokens de contexto, más de0Tokens de contexto, hasta inclusiveSin límite superiorCargo
Entrada · Tokens de entrada $0 / 1K tokens
Salida · Tokens de salida $0 / 1K tokens
Entrada · Lectura de caché — / 1K tokens
Entrada · Escritura en caché — / 1K tokens
Entrada · Escritura en caché, 1 hora — / 1K tokens

Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →

Solicitudes de ejemplo

Ailoot Ultra · System One

Estructura oficial de solicitud conservada; ejemplo de documentaciónUsa el material real de tu solicitud y conserva el resultado completo
{
  "model": "respan/span-01-lite",
  "questions": {
    "is_bug": {
      "criteria": {
        "false": "The customer is asking a question or requesting a feature.",
        "true": "The customer describes broken or unexpected product behavior."
      },
      "instructions": "Is the customer reporting a software defect?",
      "type": "noul"
    },
    "team": {
      "criteria": {
        "account": "Login, permissions, or profile issues.",
        "frontend": "Rendering, layout, or browser compatibility issues.",
        "payments": "Checkout, billing, or payment processing issues."
      },
      "instructions": "Which team should own this ticket?",
      "type": "choice"
    },
    "urgency": {
      "criteria": [
        "Can wait for the next release",
        "Should be fixed this week",
        "Blocking revenue right now"
      ],
      "instructions": "How urgent is this ticket?",
      "type": "score"
    }
  },
  "state": {
    "customer_tier": "enterprise",
    "ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
  }
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='respan/span-01-lite'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT

Recibir y guardar resultados

Ailoot Ultra · System One

json

Conserva todos los resultados completados

Conserva todas las respuestas, archivos y partes de contenido completos recibidos.

Se conserva cada respuesta al ID de pregunta proporcionado con su tipo exacto, valor noul/choice/score, confianza, probabilidades y leyenda. El JSON original completo se almacena y devuelve únicamente después de liquidar el cargo.

Si es necesario revisar la respuesta original

Conserva la operación original y la respuesta completa o parcial; no repitas el POST.

Campos de respuesta
CampoTipo
CampomodelTipostring
CampoidTipostring
CampoproviderTipostring
Campoanswers.<id>.typeTipostring
Campoanswers.<id>.noulTiponumber
Campoanswers.<id>.choiceTipostring
Campoanswers.<id>.scoreTiponumber
Campoanswers.<id>.confidenceTiponumber
Campoanswers.<id>.probabilitiesTipoobject
Campoanswers.<id>.legendTipoobject
Campousage.input_tokensTipointeger
Campousage.output_tokensTipointeger
Campousage.costTiponumber
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta400 · invalid_request_errorCondiciónCampo obligatorio, representación o valor no válidoSiguiente pasoCorrige el campo indicado de la solicitud.

Alias

Alias del modelo

Ailoot Ultra respan/span-01-lite

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

respan/span-01-lite

FAQ · Respan: Span-01 Lite
¿Qué entradas y resultados están disponibles?

POST /v1/systemone · respan/span-01-lite: text → decisions

¿Qué campos utiliza la solicitud?

POST /v1/systemone · respan/span-01-lite: model, provider, questions, session_id, state, trace, user

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia