modelos

Respan: Span-01

Markdown · JSON

Respan: Span-01

Span-01 es el clasificador textual de comportamientos de Respan para conversaciones y trazas de agentes. Define los comportamientos en lenguaje natural y devuelve tres probabilidades para cada uno: presente, ausente y no observable, conservando la incertidumbre cuando la traza proporcionada no permite resolver la pregunta.

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 es el modelo de puntuación de comportamientos de Respan para conversaciones y trazas de agentes. Lee una interacción de texto junto con definiciones de comportamientos escritas en lenguaje natural y devuelve probabilidades para cada definición. La salida distingue si un comportamiento está presente, ausente o no es observable en la traza proporcionada. Esto aporta al flujo de evaluación una señal numérica con una forma explícita de representar la falta de evidencia, en lugar de una explicación generada que se deba analizar.

Define el comportamiento que quieres observar

Quien realiza la llamada proporciona los comportamientos. La inyección de prompts, las afirmaciones sin respaldo, la exposición de secretos, los bucles repetitivos, el uso indebido de herramientas y la frustración del usuario son posibles definiciones, no una taxonomía fija incorporada al modelo. Indica qué cuenta como comportamiento y qué no. Una definición precisa puede distinguir entre que un usuario pida una derivación a una persona y que simplemente exprese decepción. Otra puede distinguir entre que un asistente reconozca un problema y que prometa una acción que no puede realizar.

Utiliza identificadores estables con las definiciones para que los resultados sigan asociados al comportamiento evaluado. Mantén el criterio centrado en algo que la traza pueda mostrar. Si el comportamiento requiere un documento de origen, el resultado de una herramienta o una respuesta posterior del cliente, incluye esa evidencia en la interacción de texto donde corresponda. Una definición por sí sola no puede establecer un hecho ausente de la traza.

Prepara el contexto previo y el turno objetivo

La entrada documentada separa los mensajes anteriores, en span.input, del turno objetivo, en span.output. El contenido de cada mensaje es una cadena de texto. Proporciona el contexto real de la conversación y el turno que quieres puntuar, conservando los roles de los interlocutores y el orden necesario para interpretarlo. Este es un perfil de puntuación de texto; el texto de un documento preparado o una transcripción pueden ser evidencia, mientras que los medios de los que se obtuvo ese texto no son en sí mismos la entrada documentada.

Para una interacción de soporte, conserva la solicitud del cliente junto con la respuesta propuesta por el asistente. Para un agente que utiliza herramientas, conserva la observación pertinente de la herramienta y la respuesta que se basó en ella. Una definición ilustrativa de respaldo en evidencia podría preguntar si el asistente afirma una conclusión que la observación proporcionada no sustenta. El resultado útil se refiere al comportamiento definido en ese tramo, no a un diagnóstico completo de toda la aplicación.

Lee tres probabilidades para cada definición

Cada resultado incluye el identificador del comportamiento y p_present, p_absent y p_not_observable. Las tres probabilidades suman aproximadamente 1. Presente estima que el comportamiento ocurrió; ausente estima que no ocurrió; no observable estima que el tramo proporcionado carece de la evidencia necesaria para decidir. Son significados distintos y deben mantenerse separados al interpretar los resultados.

Por ejemplo, un tramo que termina con el asistente diciendo que resolverá un problema puede mostrar una promesa. Todavía no puede mostrar que el cliente haya aceptado la solución posterior si no hay una respuesta del cliente. Trata ese resultado de falta de evidencia como desconocido, en lugar de convertirlo en ausente. Una probabilidad baja de presencia no es automáticamente evidencia sólida de ausencia cuando una parte significativa de la distribución corresponde a no observable.

Puntuación en una pasada de varias definiciones de comportamientos

Respan describe Span-01 como un clasificador con razonamiento entrenado primero para clasificación general con RLAIF y después especializado en detección de comportamientos. Cada definición se ejecuta como una rama paralela sobre la misma traza, y el modelo devuelve las probabilidades de los comportamientos en una sola pasada de inferencia. La atención híbrida permite tratar trazas largas y complejas. No genera tokens, no redacta un juicio narrativo ni produce una explicación libre de su clasificación.

La guía conceptual y la referencia de puntuación no documentan un límite de cantidad de comportamientos por solicitud. Cada definición sigue formando parte de la evaluación proporcionada, por lo que conviene mantenerla clara y pertinente, en lugar de tratar la ausencia de un límite de cantidad como evidencia de capacidad ilimitada de entrada. El resultado contiene una entrada por comportamiento en el orden de la solicitud, identificada por su id. Varias definiciones describen varias observaciones independientes; no son elecciones de categorías mutuamente excluyentes que deban sumar uno entre todos los comportamientos.

Preparación de un artefacto de evaluación útil

Combina las probabilidades devueltas con umbrales específicos de la tarea y reglas de revisión fuera del modelo. El productor recomienda utilizar conversaciones etiquetadas para elegir esos umbrales y examinar los resultados de presencia limítrofes o con valores altos de no observable. Un flujo de soporte puede registrar por separado la frustración, una escalada propuesta y una promesa sin respaldo. Un flujo de calidad de agentes puede seguir acciones repetidas o si una respuesta utilizó la evidencia puesta a su disposición.

Conserva juntos el tramo de texto, la definición del comportamiento, el identificador del resultado y la distribución completa de las tres posibilidades. Cuando cambie la definición, reconoce que también cambia lo que mide la probabilidad. Revisa los errores aparentes frente a la conversación real, en lugar de tratar un resultado numérico como prueba de un evento no observado. Un artefacto útil es un registro de comportamientos vinculado a la traza y al criterio, con la incertidumbre conservada para una inspección posterior o para la siguiente decisión de una aplicación.

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

respan/span-01

Respan /respan/span-01

Primeros pasos

Span-01 es el clasificador textual de comportamientos de Respan para conversaciones y trazas de agentes. Define los comportamientos en lenguaje natural y devuelve tres probabilidades para cada uno: presente, ausente y no observable, conservando la incertidumbre cuando la traza proporcionada no permite resolver la pregunta.

Entradas aceptadas
Texto
Resultados
decisions

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · System One POST /v1/systemone
Tipos de entrada
text
Tipos de salida
decisions
Formato de salida
json
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
respan/span-01
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 una lista con minItems1.
Predeterminado—
Campoquestions.<id>.criteria.trueTipostring|object|arrayRequisitoObligatorioValores y límites
Se aplica cuando: Se ha proporcionado un objeto de criterios noul
Predeterminado—
Campoquestions.<id>.criteria.falseTipostring|object|arrayRequisitoObligatorioValores y límites
Se aplica cuando: Se ha proporcionado un 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.

Planes

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

Modo rápido
Sin especificar Cuando se selecciona el modo rápido
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (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.00004 / 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ónTramo 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.00004 / 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 importe 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",
  "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'
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 solo se devuelve tras la liquidación.

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

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

respan/span-01

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

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

¿Qué campos utiliza la solicitud?

POST /v1/systemone · respan/span-01: 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