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-liteInicio
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
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites respan/span-01-lite | 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 / 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 / 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-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
| 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-lite
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
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