models

Respan: Span-01

Markdown · JSON

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

Respan /respan/span-01

Pour commencer

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
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 : requis; noul : facultatif. Les critères de choice forment un objet; score est un tableau avec minItems1.
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 tarifaireJetons de contexte, plus deJetons de contexte, jusqu’à la limite incluseCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseJetons de contexte, plus de—Jetons de contexte, jusqu’à la limite incluseSans borne supérieureCoût
Entrée · Jetons en entrée $0.00004 / 1K jetons
Sortie · Jetons en sortie $0 / 1K jetons
Entrée · Lecture du cache — / 1K jetons
Entrée · Écriture dans le cache — / 1K jetons
Entrée · Écriture dans le cache, 1 h — / 1K jetons
ConfigurationPalier 1 de longueur de requêteBarème tarifaire—Jetons de contexte, plus de0Jetons de contexte, jusqu’à la limite incluseSans borne supérieureCoût
Entrée · Jetons en entrée $0.00004 / 1K jetons
Sortie · Jetons en sortie $0 / 1K jetons
Entrée · Lecture du cache — / 1K jetons
Entrée · Écriture dans le cache — / 1K jetons
Entrée · Écriture dans le cache, 1 h — / 1K jetons

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 la requête conservée ; exemple de documentationUtilisez les éléments réels 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, sa confiance, ses probabilités et sa légende. Le JSON d’origine complet est stocké et retourné 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 la demande 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 requis, représentation ou valeur invalideÉtape suivanteCorrigez le champ de demande 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