modèles

Respan: Span-01

Markdown · JSON

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-01

Respan /respan/span-01

Premiers 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
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
respan/span-01
Par défaut—
ChampproviderTypeschemaExigenceFacultatifValeurs et limitesPar défaut—
ChampquestionsTypeobjectExigenceObligatoireValeurs et limitesPar défaut—
Champsession_idTypestringExigenceFacultatifValeurs et limitesPar défaut—
ChampstateTypeschemaExigenceObligatoireValeurs et limitesPar défaut—
ChamptraceTypeschemaExigenceFacultatifValeurs et limitesPar défaut—
ChampuserTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champquestions.<id>.typeTypestringExigenceObligatoireValeurs et limites
noul, choice, score
Par défaut—
Champquestions.<id>.instructionsTypestring|object|arrayExigenceObligatoireValeurs et limitesPar défaut—
Champquestions.<id>.criteriaTypeobject|arrayExigenceFacultatifValeurs 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.trueTypestring|object|arrayExigenceObligatoireValeurs et limites
S’applique lorsque: objet de critères noul fourni
Par défaut—
Champquestions.<id>.criteria.falseTypestring|object|arrayExigenceObligatoireValeurs 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ètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, state, questions
Paramètrematerial_typesContrattext
Paramètreoptional_controlsContratprovider, session_id, trace, user
Paramètremultimodal_input_bindingContratnull

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.

ConfigurationBarème tarifaireTokens de contexte, plus deTokens de contexte, jusqu’à la limite incluseCoût
ConfigurationTarifs de base des tokensBarème tarifaireTarif de baseTokens de contexte, plus de—Tokens de contexte, jusqu’à la limite incluseSans borne supérieureCoû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êteBarème tarifaire—Tokens de contexte, plus de0Tokens de contexte, jusqu’à la limite incluseSans borne supérieureCoû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

Structure officielle de requête conservée ; exemple de documentationUtilisez les données réelles de votre requête et conservez le résultat complet
{
  "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
ChampType
ChampmodelTypestring
ChampidTypestring
ChampproviderTypestring
Champanswers.<id>.typeTypestring
Champanswers.<id>.noulTypenumber
Champanswers.<id>.choiceTypestring
Champanswers.<id>.scoreTypenumber
Champanswers.<id>.confidenceTypenumber
Champanswers.<id>.probabilitiesTypeobject
Champanswers.<id>.legendTypeobject
Champusage.input_tokensTypeinteger
Champusage.output_tokensTypeinteger
Champusage.costTypenumber
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionChamp 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

respan/span-01

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

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence