Respan: Span-01
Span-01 est le classificateur de comportements textuels de Respan pour les conversations et les traces d’agents. Définissez les comportements en langage courant : il renvoie pour chacun trois probabilités, présent, absent et non observable, en préservant 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 d’évaluation 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 et d’un moyen explicite de représenter les éléments manquants, 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 étayé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, plutôt qu’une taxonomie fixe intégrée au modèle. Indiquez ce qui constitue le comportement et ce qui ne le constitue pas. Une définition précise peut distinguer une demande de transfert à une personne d’une simple expression de déception. Une autre peut distinguer la reconnaissance d’un problème par l’assistant d’une promesse d’action qu’il ne peut pas effectuer.
Utilisez des identifiants stables avec les définitions afin que les résultats restent associés au comportement évalué. Gardez le critère centré sur quelque chose que la trace peut montrer. Si le comportement nécessite un document source, un résultat d’outil ou une réponse ultérieure du client, incluez ces éléments dans l’interaction textuelle à l’endroit approprié. Une définition seule ne peut pas établir un fait absent de la trace.
Préparer le contexte précédent et le tour ciblé
L’entrée documentée sépare les messages précédents dans span.input du tour ciblé 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 à évaluer, en préservant les rôles des interlocuteurs et l’ordre nécessaire à son interprétation. Il s’agit d’un profil d’évaluation textuelle ; du texte documentaire préparé ou une transcription peuvent constituer des éléments à examiner, tandis que les médias dont ce texte provient ne sont pas eux-mêmes l’entrée documentée.
Pour une interaction d’assistance, gardez la demande du client avec la réponse proposée par l’assistant. Pour un agent utilisant des outils, conservez l’observation pertinente de l’outil et la réponse qui s’y appuie. Une définition illustrative de l’ancrage dans les sources pourrait demander si l’assistant affirme une conclusion que l’observation fournie ne justifie pas. Le résultat utile concerne le comportement défini dans cet extrait, plutôt qu’un diagnostic complet de l’application entière.
Lire trois probabilités pour chaque définition
Chaque résultat comprend l’identifiant du comportement et p_present, p_absent et p_not_observable. La somme des trois probabilités vaut approximativement 1. Présent estime que le comportement a eu lieu ; absent estime qu’il n’a pas eu lieu ; non observable estime que l’extrait fourni ne contient pas les éléments nécessaires pour décider. Ces sens sont distincts et doivent le rester lors de l’interprétation des résultats.
Par exemple, un extrait se terminant par l’affirmation de l’assistant qu’il résoudra un problème peut montrer une promesse. Il ne peut pas encore montrer que le client a accepté la solution ultérieure si aucune réponse du client n’est présente. Traitez ce résultat lié à des éléments manquants comme inconnu, plutôt que de le convertir en absent. Une faible probabilité de présence ne constitue pas automatiquement un indice fort d’absence lorsqu’une part importante de la distribution correspond à non observable.
Évaluation des définitions de comportements en une seule passe
Respan décrit Span-01 comme un classificateur de 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 comportements en une seule passe avant. L’attention hybride facilite le 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 d’évaluation ne documentent aucun plafond de nombre de comportements par requête. Chaque définition fait néanmoins partie de l’évaluation fournie ; gardez chacune claire et pertinente, plutôt que de traiter l’absence de plafond de nombre comme une preuve de 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 ; elles ne constituent pas des choix de catégories mutuellement exclusifs dont la somme devrait valoir un entre les 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 vérification extérieures au modèle. Le producteur recommande d’utiliser des conversations annotées pour choisir ces seuils et d’examiner les résultats de présence limites ou à forte non-observabilité. Un processus d’assistance peut consigner séparément la frustration, une escalade proposée et une promesse non étayée. Un processus de qualité des agents peut suivre les actions répétées ou vérifier si une réponse utilisait les éléments mis à sa disposition.
Gardez ensemble l’extrait textuel, la définition du comportement, l’identifiant du résultat et la distribution complète à trois issues. Lorsqu’une définition change, reconnaissez que cela modifie ce que mesure la probabilité. Examinez les erreurs apparentes au regard de la conversation réelle, plutôt que de traiter un résultat numérique comme une preuve d’un événement non observé. Un artefact utile est un enregistrement de comportement lié à la trace et au critère, avec l’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 classificateur de comportements textuels de Respan pour les conversations et les traces d’agents. Définissez les comportements en langage courant : il renvoie pour chacun trois probabilités, présent, absent et non observable, en préservant 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
- Entrée
text- 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 : obligatoire ; noul : facultatif. Les critères choice forment un objet ; score est un tableau avec minItems1. | 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’ID 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 ID de question est conservée avec son type exact, sa valeur noul/choice/score, son niveau de confiance, ses probabilités et sa légende. L’intégralité du JSON d’origine est stocké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 ainsi que 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 invalide | Étape suivanteCorrigez le champ indiqué de la requête. |
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