Respan: Span-01 Lite
Span-01 Lite est le profil d’évaluation des comportements de Respan, nommé séparément, pour les conversations textuelles et les traces d’agents. Il utilise des comportements définis par l’appelant et renvoie pour chacun des probabilités de présence, d’absence et de non-observabilité, selon le même processus d’évaluation documenté que Span-01.
À 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 Lite est un profil de modèle nommé séparément dans la famille Span-01 d’évaluation des comportements de Respan. Le guide de démarrage et le tableau des modèles du producteur identifient Lite comme l’un des deux profils utilisant le même processus d’évaluation. Il reçoit une interaction textuelle et des définitions de comportements en langage courant, puis renvoie trois probabilités pour chaque définition : présent, absent et non observable. La sortie utile du profil est un enregistrement de comportement avec une incertitude explicite, plutôt qu’une réponse écrite à la conversation.
Choisir l’observation et sa délimitation
Définissez le comportement avec des mots correspondant à votre tâche. Pour vérifier un transfert à une personne, précisez si cela signifie que l’utilisateur demande explicitement une personne, que l’assistant affirme qu’un transfert est nécessaire ou que l’une de ces deux conditions est satisfaite. Si une simple déception ne doit pas compter, indiquez-le. Pour vérifier des excuses, définissez les formulations qui constituent des excuses, plutôt que de vous appuyer sur un libellé flou. Chaque définition possède un identifiant que l’évaluateur renvoie avec ses probabilités.
L’ensemble des comportements appartient à l’appelant. Des exemples tels que la frustration, les promesses non étayées, le mauvais usage d’outils ou les actions répétitives d’un agent sont des définitions à fournir, et non une liste fixe de catégories natives. Gardez chaque définition observable dans l’interaction fournie. Un court extrait peut permettre de déterminer si l’assistant s’est excusé tout en ne contenant pas d’éléments établissant qu’un problème externe a réellement été résolu.
Préparer l’extrait de conversation
L’entrée documentée de Respan place les messages précédents dans span.input et le tour évalué dans span.output. Le contenu des messages est une chaîne de caractères. Préservez le contexte nécessaire à la compréhension du tour, notamment les rôles des interlocuteurs, la demande pertinente de l’utilisateur et les éléments textuels utilisés par l’assistant. Pour un contrôle qualité, fournissez le tour réel, plutôt qu’une paraphrase qui supprimerait le comportement évalué.
Une vérification illustrative peut prendre un message utilisateur décrivant des difficultés répétées et une réponse de l’assistant proposant d’enquêter. Définissez la frustration de l’utilisateur et une promesse de l’assistant comme des observations distinctes. Si un résultat d’outil importe pour déterminer si une affirmation était étayée, conservez le texte pertinent de ce résultat dans le contexte. La sortie est une évaluation de ces définitions dans l’extrait fourni ; le modèle n’effectue pas l’enquête promise et ne modifie pas la conversation elle-même.
Présent, absent et non observable
La réponse d’évaluation contient l’id du comportement avec p_present, p_absent et p_not_observable, dont la somme vaut approximativement 1. Non observable signifie que la trace ne permet pas de répondre à la question. Cela se distingue d’absent. Pour une définition telle que l’acceptation d’une solution par le client, un extrait s’arrêtant avant sa réaction constitue des éléments incomplets, même si la réponse de l’assistant semble assurée.
Gardez les trois valeurs lorsque vous préparez un résultat pour vérification. Une catégorie choisie selon la valeur la plus élevée peut être utile pour l’affichage, mais la distribution conserve l’incertitude de l’observation. N’utilisez pas une faible valeur de présence seule pour conclure que le comportement n’a certainement pas eu lieu. Lorsque les éléments manquants dominent, l’action utile peut consister à obtenir le contexte pertinent ou à conserver le résultat comme inconnu, plutôt qu’à inventer une explication.
Plusieurs définitions sur les mêmes éléments
Le processus d’évaluation du producteur évalue plusieurs définitions de comportements ensemble sur une même trace et renvoie un résultat pour chaque identifiant dans l’ordre de la requête. Sa documentation ne spécifie aucun plafond de nombre de comportements par requête. Cela n’établit pas une fenêtre universelle de tokens ou une taille de trace illimitée. Gardez des définitions utiles et des éléments pertinents, et préservez l’association entre chaque résultat renvoyé et la définition qui l’a produit.
Les résultats de comportements sont des observations indépendantes, plutôt qu’une seule réponse à choix exclusif. La frustration, des excuses et un transfert proposé peuvent tous être présents dans un même échange. Leurs distributions individuelles à trois issues ont un sens au sein de chaque définition ; additionner les valeurs de présence de comportements différents ne crée ni une distribution normalisée de catégories ni un score ordonné sur une grille.
Conserver le profil sélectionné avec ses résultats
Le fabricant documente les noms Lite et standard avec une structure commune de requête et de résultat. Ce contrat permet de préparer des traces et d’interpréter les probabilités de comportements pour chacun des profils nommés. Il n’établit pas que Lite possède les mêmes poids, le même nombre de paramètres ou la même qualité que l’autre édition. Gardez le profil sélectionné identifiable lorsque vous examinez ses résultats, plutôt que d’échanger silencieusement des résultats d’éditions différentes.
Utilisez des conversations annotées issues de la tâche visée pour choisir les seuils de journalisation, d’orientation ou de vérification. Conservez les résultats à forte non-observabilité et les observations limites pour examen, et comparez toute erreur apparente au tour d’origine et à la définition du comportement. L’artefact final utile contient l’identifiant de l’extrait textuel, la définition, le profil sélectionné et le résultat probabiliste complet à trois issues. Une étape ultérieure de l’application décide de l’usage de cette observation ; la sortie d’évaluation de Lite n’effectue pas elle-même un transfert, ne bloque pas une réponse et ne génère pas de correction.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-litePremiers pas
Span-01 Lite est le profil d’évaluation des comportements de Respan, nommé séparément, pour les conversations textuelles et les traces d’agents. Il utilise des comportements définis par l’appelant et renvoie pour chacun des probabilités de présence, d’absence et de non-observabilité, selon le même processus d’évaluation documenté que Span-01.
- 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-lite | 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 de 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’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 / 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 / 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-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
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 niveau 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 la facturation définitive.
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 répétez 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é dans la requête. |
Alias
Alias du modèle
Ailoot Ultra respan/span-01-lite
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 Lite
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/systemone·respan/span-01-lite:text→decisions- Quels champs la requête utilise-t-elle ?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user