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 transferencia 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, un escalamiento propuesto 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-01Inicio
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
- Entrada
text- Salida
decisions- Formato de salida
- json
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites respan/span-01 | Predeterminado— |
Campoprovider | Tiposchema | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoquestions | Tipoobject | RequisitoObligatorio | Valores y límites | Predeterminado— |
Camposession_id | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campostate | Tiposchema | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campotrace | Tiposchema | RequisitoOpcional | Valores y límites | Predeterminado— |
Campouser | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoquestions.<id>.type | Tipostring | RequisitoObligatorio | Valores y límites noul, choice, score | Predeterminado— |
Campoquestions.<id>.instructions | Tipostring|object|array | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campoquestions.<id>.criteria | Tipoobject|array | RequisitoOpcional | Valores 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.true | Tipostring|object|array | RequisitoObligatorio | Valores y límites Se aplica cuando: Se proporcionó el objeto de criterios noul | Predeterminado— |
Campoquestions.<id>.criteria.false | Tipostring|object|array | RequisitoObligatorio | Valores 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ámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, state, questions |
Parámetromaterial_types | Contratotext |
Parámetrooptional_controls | Contratoprovider, session_id, trace, user |
Parámetromultimodal_input_binding | Contratonull |
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ón | Tabla de tarifas | Tokens de contexto, más de | Tokens de contexto, hasta inclusive | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Tokens de contexto, más de— | Tokens de contexto, hasta inclusiveSin límite superior | Cargo 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ónNivel 1 por longitud de la solicitud | Tabla de tarifas— | Tokens de contexto, más de0 | Tokens de contexto, hasta inclusiveSin límite superior | Cargo 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 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
{
"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 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
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Campoid | Tipostring |
Campoprovider | Tipostring |
Campoanswers.<id>.type | Tipostring |
Campoanswers.<id>.noul | Tiponumber |
Campoanswers.<id>.choice | Tipostring |
Campoanswers.<id>.score | Tiponumber |
Campoanswers.<id>.confidence | Tiponumber |
Campoanswers.<id>.probabilities | Tipoobject |
Campoanswers.<id>.legend | Tipoobject |
Campousage.input_tokens | Tipointeger |
Campousage.output_tokens | Tipointeger |
Campousage.cost | Tiponumber |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampo obligatorio, representación o valor no válido | Siguiente 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
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