Respan: Span-01
Span-01 is de tekstclassifier voor gedrag van Respan, bedoeld voor gesprekken en agent-traces. Definieer de gedragingen in gewone taal, en het model geeft voor elk daarvan drie kansen terug: aanwezig, afwezig en niet waarneembaar, waarbij de onzekerheid behouden blijft wanneer de aangeleverde trace de vraag niet kan beslechten.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Span-01 is het gedragsscoringsmodel van Respan voor gesprekken en agent-traces. Het leest een tekstinteractie samen met gedragsdefinities in gewone taal en geeft voor elke definitie kansen terug. De uitvoer maakt onderscheid tussen gedrag dat aanwezig, afwezig of niet waarneembaar is in de aangeleverde trace. Zo krijgt een evaluatieworkflow een numeriek signaal met een expliciete manier om ontbrekend bewijs weer te geven, in plaats van een gegenereerde uitleg die nog geparseerd moet worden.
Definieer het gedrag dat je wilt observeren
Gedragingen worden door de aanroeper aangeleverd. Prompt-injectie, ononderbouwde beweringen, blootstelling van geheimen, repetitieve lussen, verkeerd gebruik van tools en frustratie van de gebruiker zijn mogelijke definities, geen vaste taxonomie die in het model is ingebouwd. Geef aan wat wel en wat niet als het gedrag telt. Een smalle definitie kan onderscheid maken tussen een gebruiker die om overdracht naar een mens vraagt en een gebruiker die alleen teleurstelling uit. Een andere definitie kan onderscheid maken tussen een assistent die een probleem erkent en een assistent die een actie belooft die hij niet kan uitvoeren.
Gebruik stabiele identifiers bij de definities, zodat resultaten gekoppeld blijven aan het gedrag dat wordt geëvalueerd. Richt het criterium op iets wat de trace kan laten zien. Als het gedrag een brondocument, een toolresultaat of een latere reactie van de klant vereist, neem dat bewijs dan op in de tekstinteractie, op de plek waar het hoort. Een definitie alleen kan geen feit vaststellen dat in de trace ontbreekt.
Bereid de voorafgaande context en de doelbeurt voor
De gedocumenteerde invoer scheidt voorafgaande berichten in span.input van de doelbeurt in span.output. De inhoud van elk bericht is een string. Lever de werkelijke gesprekscontext en de beurt die je wilt laten scoren aan, met behoud van de rollen van de sprekers en de volgorde die nodig is om de beurt te interpreteren. Dit is een profiel voor tekstscoring; voorbereide documenttekst of een transcript kan als bewijs dienen, terwijl de media waaruit die tekst is verkregen zelf niet de gedocumenteerde invoer vormen.
Houd bij een supportinteractie het verzoek van de klant bij het voorgestelde antwoord van de assistent. Bewaar bij een agent die tools gebruikt de relevante toolobservatie en het antwoord dat daarop steunde. Een illustratieve definitie voor onderbouwing kan vragen of de assistent een conclusie trekt die niet door de aangeleverde observatie wordt ondersteund. Het bruikbare resultaat betreft het gedefinieerde gedrag in die span, geen volledige diagnose van de hele applicatie.
Lees drie kansen voor elke definitie
Elk resultaat bevat de identifier van het gedrag en p_present, p_absent en p_not_observable. De drie kansen zijn samen ongeveer 1. Aanwezig schat in dat het gedrag heeft plaatsgevonden; afwezig schat in dat dit niet zo is; niet waarneembaar schat in dat de aangeleverde span het bewijs mist dat nodig is om te beslissen. Dit zijn afzonderlijke betekenissen, die bij het interpreteren van resultaten gescheiden moeten blijven.
Een span die eindigt met een assistent die zegt een probleem op te lossen, kan bijvoorbeeld een belofte laten zien. Zonder reactie van de klant kan die span nog niet laten zien dat de klant de uiteindelijke oplossing heeft geaccepteerd. Behandel zo'n resultaat met ontbrekend bewijs als onbekend in plaats van het om te zetten naar afwezig. Een lage kans op aanwezigheid is niet automatisch sterk bewijs van afwezigheid wanneer een aanzienlijk deel van de verdeling niet waarneembaar is.
Scoring in één doorgang over alle gedragsdefinities
Respan beschrijft Span-01 als een redenerende classifier die eerst met RLAIF is getraind voor algemene classificatie en daarna is gespecialiseerd in gedragsdetectie. Elke definitie draait als een parallelle tak over dezelfde trace, en het model geeft de gedragskansen terug in één forward pass. Hybride attention ondersteunt de verwerking van lange, complexe traces. Het model genereert geen tokens, schrijft geen verhalend oordeel en produceert geen vrije uitleg van de classificatie.
De conceptgids en de scoringsreferentie noemen geen maximum aantal gedragingen per verzoek. Elke definitie maakt nog steeds deel uit van de aangeleverde evaluatie, dus houd elke definitie helder en relevant, in plaats van het ontbreken van een maximum op te vatten als bewijs van onbeperkte invoercapaciteit. Het resultaat bevat één item per gedrag in de volgorde van het verzoek, aangeduid met de id. Meerdere definities beschrijven meerdere onafhankelijke observaties; het zijn geen elkaar uitsluitende categoriekeuzes die over alle gedragingen samen op één moeten uitkomen.
Een bruikbaar evaluatieartefact voorbereiden
Combineer de teruggegeven kansen buiten het model met taakspecifieke drempels en reviewregels. De producent raadt aan gelabelde gesprekken te gebruiken om die drempels te kiezen en grensgevallen van aanwezigheid of hoge waarden voor niet waarneembaar te inspecteren. Een supportworkflow kan frustratie, een voorgestelde escalatie en een ononderbouwde belofte afzonderlijk vastleggen. Een workflow voor agentkwaliteit kan herhaalde acties bijhouden of nagaan of een antwoord het beschikbaar gestelde bewijs heeft gebruikt.
Houd de tekstspan, de gedragsdefinitie, de identifier van het resultaat en de volledige driedelige verdeling bij elkaar. Wanneer de definitie verandert, verandert ook wat de kans meet. Beoordeel schijnbare fouten aan de hand van het werkelijke gesprek, in plaats van een numeriek resultaat te behandelen als bewijs van een niet-waargenomen gebeurtenis. Een bruikbaar artefact is een gedragsrecord dat gekoppeld is aan de trace en het criterium, waarbij de onzekerheid bewaard blijft voor latere inspectie of voor de volgende beslissing van een applicatie.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Aan de slag
Span-01 is de tekstclassifier voor gedrag van Respan, bedoeld voor gesprekken en agent-traces. Definieer de gedragingen in gewone taal, en het model geeft voor elk daarvan drie kansen terug: aanwezig, afwezig en niet waarneembaar, waarbij de onzekerheid behouden blijft wanneer de aangeleverde trace de vraag niet kan beslechten.
- Toegestane invoer
- Tekst
- Resultaten
- decisions
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · System One POST /v1/systemone
- Invoertypen
text- Uitvoertypen
decisions- Uitvoerformaat
- json
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten respan/span-01 | Standaard— |
Veldprovider | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquestions | Typeobject | VereisteVereist | Waarden en limieten | Standaard— |
Veldsession_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldstate | Typeschema | VereisteVereist | Waarden en limieten | Standaard— |
Veldtrace | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Velduser | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquestions.<id>.type | Typestring | VereisteVereist | Waarden en limieten noul, choice, score | Standaard— |
Veldquestions.<id>.instructions | Typestring|object|array | VereisteVereist | Waarden en limieten | Standaard— |
Veldquestions.<id>.criteria | Typeobject|array | VereisteOptioneel | Waarden en limieten Voorwaarden: choice/score: vereist; noul: optioneel. De criteria voor choice zijn een object; score is een array met minItems1. | Standaard— |
Veldquestions.<id>.criteria.true | Typestring|object|array | VereisteVereist | Waarden en limieten Geldt wanneer: Object met noul-criteria opgegeven | Standaard— |
Veldquestions.<id>.criteria.false | Typestring|object|array | VereisteVereist | Waarden en limieten Geldt wanneer: Object met noul-criteria opgegeven | Standaard— |
Combinaties van invoermaterialen
noul · Vereist: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Vereist: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Vereist: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, state, questions |
Parametermaterial_types | Contracttext |
Parameteroptional_controls | Contractprovider, session_id, trace, user |
Parametermultimodal_input_binding | Contractnull |
Levenscyclus: synchronous
Verstuur de exacte model-ID en bewaar het volledige native antwoord.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Contexttokens, meer dan | Contexttokens, tot en met | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Contexttokens, meer dan— | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.00004 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratieNiveau 1 voor aanvraaglengte | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.00004 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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
Resultaten ophalen en opslaan
Ailoot Ultra · System One
json
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Elk aangeleverd antwoord op een vraag-ID blijft behouden met het exacte type, de noul/choice/score-waarde, zekerheid, waarschijnlijkheden en legenda. De volledige oorspronkelijke JSON wordt opgeslagen en pas na afrekening geretourneerd.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operatie en het volledige of gedeeltelijke antwoord; herhaal POST niet.
Antwoordvelden
| Veld | Type |
|---|---|
Veldmodel | Typestring |
Veldid | Typestring |
Veldprovider | Typestring |
Veldanswers.<id>.type | Typestring |
Veldanswers.<id>.noul | Typenumber |
Veldanswers.<id>.choice | Typestring |
Veldanswers.<id>.score | Typenumber |
Veldanswers.<id>.confidence | Typenumber |
Veldanswers.<id>.probabilities | Typeobject |
Veldanswers.<id>.legend | Typeobject |
Veldusage.input_tokens | Typeinteger |
Veldusage.output_tokens | Typeinteger |
Veldusage.cost | Typenumber |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeOngeldig vereist veld, ongeldige weergave of waarde | Volgende stapCorrigeer het aangegeven verzoekveld. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra respan/span-01
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Respan: Span-01
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/systemone·respan/span-01:text→decisions- Welke velden gebruikt het verzoek?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user