Respan: Span-01
Span-01 est le classifieur de comportements textuels de Respan pour les conversations et les traces d’agents. Définissez les comportements en langage courant : il renvoie trois probabilités pour chacun, présent, absent et non observable, et préserve l’incertitude lorsque la trace fournie ne permet pas de trancher la question.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Span-01 est le modèle de notation des comportements de Respan pour les conversations et les traces d’agents. Il lit une interaction textuelle accompagnée de définitions de comportements rédigées en langage courant et renvoie des probabilités pour chaque définition. La sortie distingue un comportement présent, absent ou non observable dans la trace fournie. Un processus d’évaluation dispose ainsi d’un signal numérique doté d’un moyen explicite de représenter l’absence d’éléments probants, plutôt que d’une explication générée à analyser.
Définir le comportement à observer
Les comportements sont fournis par l’appelant. L’injection de prompt, les affirmations non fondées, l’exposition de secrets, les boucles répétitives, le mauvais usage d’outils et la frustration de l’utilisateur sont des définitions possibles, et non une taxonomie fixe intégrée au modèle. Précisez ce qui relève du comportement et ce qui n’en relève pas. Une définition étroite peut distinguer un utilisateur qui demande un transfert vers un humain d’un utilisateur qui exprime simplement sa déception. Une autre peut distinguer un assistant qui reconnaît un problème d’un assistant qui promet une action qu’il ne peut pas accomplir.
Associez des identifiants stables aux définitions, afin que les résultats restent rattachés au comportement évalué. Maintenez le critère centré sur un élément que la trace peut montrer. Si le comportement exige un document source, le résultat d’un outil ou une réponse ultérieure du client, incluez ces éléments à leur place dans l’interaction textuelle. Une définition seule ne peut pas établir un fait absent de la trace.
Préparer le contexte précédent et le tour cible
L’entrée documentée sépare les messages précédents, placés dans span.input, du tour cible, placé dans span.output. Le contenu de chaque message est une chaîne de caractères. Fournissez le contexte réel de la conversation et le tour que vous souhaitez noter, en préservant les rôles des interlocuteurs et l’ordre nécessaires à son interprétation. Il s’agit d’un profil de notation de texte ; le texte d’un document préparé ou une transcription peuvent servir d’éléments probants, tandis que le média dont ce texte a été extrait ne constitue pas en lui-même l’entrée documentée.
Pour une interaction d’assistance, conservez la demande du client avec la réponse proposée par l’assistant. Pour un agent utilisant des outils, conservez l’observation d’outil pertinente et la réponse qui s’appuie sur elle. Une définition d’ancrage illustrative peut demander si l’assistant affirme une conclusion que l’observation fournie n’étaye pas. Le résultat utile porte sur le comportement défini dans ce segment, et non sur un diagnostic complet de l’application entière.
Lire trois probabilités pour chaque définition
Chaque résultat comprend l’identifiant du comportement ainsi que p_present, p_absent et p_not_observable. La somme des trois probabilités est d’environ 1. Présent estime que le comportement s’est produit ; absent estime qu’il ne s’est pas produit ; non observable estime que le segment fourni ne contient pas les éléments nécessaires pour trancher. Ces significations sont distinctes et doivent le rester lors de l’interprétation des résultats.
Par exemple, un segment qui se termine par un assistant annonçant qu’il va résoudre un problème peut montrer une promesse. Il ne peut pas encore montrer que le client a accepté la solution finale si aucune réponse du client n’est présente. Traitez ce résultat lié à l’absence d’éléments comme inconnu plutôt que de le convertir en absent. Une faible probabilité de présence ne constitue pas automatiquement une preuve solide d’absence lorsqu’une part importante de la distribution relève du non observable.
Notation en une seule passe sur l’ensemble des définitions
Respan décrit Span-01 comme un classifieur à raisonnement entraîné d’abord à la classification générale avec RLAIF, puis spécialisé dans la détection de comportements. Chaque définition s’exécute comme une branche parallèle sur la même trace, et le modèle renvoie les probabilités de comportement en une seule passe avant (forward pass). L’attention hybride soutient son traitement de traces longues et complexes. Il ne génère pas de tokens, ne rédige pas de jugement narratif et ne produit pas d’explication libre de sa classification.
Le guide conceptuel et la référence de notation ne documentent aucun plafond du nombre de comportements par requête. Chaque définition fait néanmoins partie de l’évaluation fournie : gardez-les claires et pertinentes plutôt que de considérer l’absence de plafond comme la preuve d’une capacité d’entrée illimitée. Le résultat contient une entrée par comportement, dans l’ordre de la requête, identifiée par son id. Plusieurs définitions décrivent plusieurs observations indépendantes ; ce ne sont pas des choix de catégories mutuellement exclusifs dont la somme devrait être égale à un sur l’ensemble des comportements.
Préparer un artefact d’évaluation utile
Combinez les probabilités renvoyées avec des seuils propres à la tâche et des règles de revue définies en dehors du modèle. L’éditeur recommande d’utiliser des conversations étiquetées pour choisir ces seuils et d’inspecter les présences limites ou les résultats à forte probabilité non observable. Un processus d’assistance peut enregistrer séparément la frustration, une proposition d’escalade et une promesse non fondée. Un processus de contrôle qualité d’agent peut suivre les actions répétées ou vérifier si une réponse a utilisé les éléments mis à sa disposition.
Conservez ensemble le segment de texte, la définition du comportement, l’identifiant du résultat et la distribution complète à trois issues. Lorsque la définition change, gardez à l’esprit que ce que mesure la probabilité change aussi. Examinez les erreurs apparentes au regard de la conversation réelle au lieu de traiter un résultat numérique comme la preuve d’un événement non observé. Un artefact utile est un relevé de comportement rattaché à la trace et au critère, avec une incertitude conservée pour une inspection ultérieure ou la décision suivante d’une application.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Premiers pas
Span-01 est le classifieur de comportements textuels de Respan pour les conversations et les traces d’agents. Définissez les comportements en langage courant : il renvoie trois probabilités pour chacun, présent, absent et non observable, et préserve l’incertitude lorsque la trace fournie ne permet pas de trancher la question.
- Entrées acceptées
- Texte
- Résultats
- decisions
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · System One POST /v1/systemone
- Types d’entrée
text- Types de sortie
decisions- Format de sortie
- json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites respan/span-01 | Par défaut— |
Champprovider | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquestions | Typeobject | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champsession_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champstate | Typeschema | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champtrace | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champuser | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquestions.<id>.type | Typestring | ExigenceObligatoire | Valeurs et limites noul, choice, score | Par défaut— |
Champquestions.<id>.instructions | Typestring|object|array | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champquestions.<id>.criteria | Typeobject|array | ExigenceFacultatif | Valeurs et limites Conditions: choice/score : obligatoires ; noul : facultatif. Les critères de choice forment un objet ; score est un tableau avec minItems égal à 1. | Par défaut— |
Champquestions.<id>.criteria.true | Typestring|object|array | ExigenceObligatoire | Valeurs et limites S’applique lorsque: objet de critères noul fourni | Par défaut— |
Champquestions.<id>.criteria.false | Typestring|object|array | ExigenceObligatoire | Valeurs et limites S’applique lorsque: objet de critères noul fourni | Par défaut— |
Combinaisons d’éléments d’entrée
noul · Obligatoire : state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obligatoire : state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obligatoire : state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, state, questions |
Paramètrematerial_types | Contrattext |
Paramètreoptional_controls | Contratprovider, session_id, trace, user |
Paramètremultimodal_input_binding | Contratnull |
Cycle de vie : synchronous
Envoyez l’identifiant exact du modèle et conservez la réponse native complète.
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Tokens de contexte, plus de | Tokens de contexte, jusqu’à la limite incluse | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Tokens de contexte, plus de— | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée $0.00004 / 1K tokens Sortie · Tokens en sortie $0 / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
| ConfigurationPalier 1 de longueur de requête | Barème tarifaire— | Tokens de contexte, plus de0 | Tokens de contexte, jusqu’à la limite incluseSans borne supérieure | Coût Entrée · Tokens en entrée $0.00004 / 1K tokens Sortie · Tokens en sortie $0 / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
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
Recevoir et enregistrer les résultats
Ailoot Ultra · System One
json
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Chaque réponse fournie pour un identifiant de question est conservée avec son type exact, sa valeur noul/choice/score, son degré de confiance, ses probabilités et sa légende. L’intégralité du JSON d’origine est enregistrée et renvoyée uniquement après le règlement.
Si la réponse d’origine doit être vérifiée
Conservez l’opération d’origine et la réponse complète ou partielle ; ne rejouez pas le POST.
Champs de la réponse
| Champ | Type |
|---|---|
Champmodel | Typestring |
Champid | Typestring |
Champprovider | Typestring |
Champanswers.<id>.type | Typestring |
Champanswers.<id>.noul | Typenumber |
Champanswers.<id>.choice | Typestring |
Champanswers.<id>.score | Typenumber |
Champanswers.<id>.confidence | Typenumber |
Champanswers.<id>.probabilities | Typeobject |
Champanswers.<id>.legend | Typeobject |
Champusage.input_tokens | Typeinteger |
Champusage.output_tokens | Typeinteger |
Champusage.cost | Typenumber |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamp obligatoire, représentation ou valeur non valide | Étape suivanteCorrigez le champ de requête indiqué. |
Alias
Alias du modèle
Ailoot Ultra respan/span-01
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Respan: Span-01
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/systemone·respan/span-01:text→decisions- Quels champs la requête utilise-t-elle ?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user