Respan: Span-01 Lite
Span-01 Lite is het afzonderlijk benoemde gedragsscoringsprofiel van Respan voor tekstgesprekken en agent-traces. Het werkt met door de aanroeper gedefinieerde gedragingen en geeft voor elk daarvan kansen terug voor aanwezig, afwezig en niet waarneembaar, met dezelfde gedocumenteerde scoringsworkflow als Span-01.
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 Lite is een afzonderlijk benoemd modelprofiel binnen de Span-01-familie voor gedragsscoring van Respan. De quickstart en de modeltabel van de producent noemen Lite als een van de twee profielen die dezelfde scoringsworkflow gebruiken. Het ontvangt een tekstinteractie en gedragsdefinities in gewone taal, en geeft vervolgens voor elke definitie drie kansen terug: aanwezig, afwezig en niet waarneembaar. De bruikbare uitvoer van het profiel is een gedragsrecord met expliciete onzekerheid, geen geschreven antwoord op het gesprek.
Kies de observatie en de afbakening ervan
Definieer het gedrag in de woorden die bij je taak passen. Geef bij een controle op overdracht aan of dit betekent dat de gebruiker uitdrukkelijk om een persoon vraagt, dat de assistent zegt dat een overdracht nodig is, of dat een van beide voorwaarden geldt. Als louter teleurstelling niet moet meetellen, vermeld dat dan. Definieer bij een controle op excuses welke formulering als excuus geldt, in plaats van te vertrouwen op een onduidelijk label. Elke definitie heeft een identifier die de scorer samen met de kansen teruggeeft.
De set gedragingen is van de aanroeper. Voorbeelden zoals frustratie, ononderbouwde beloften, verkeerd gebruik van tools of repetitieve agentacties zijn definities die je zelf aanlevert, geen vaste lijst met native categorieën. Houd elke definitie waarneembaar binnen de aangeleverde interactie. Een korte span kan uitsluitsel geven over de vraag of de assistent zich verontschuldigde, terwijl bewijs ontbreekt dat een extern probleem daadwerkelijk is opgelost.
Bereid de gespreksspan voor
In de gedocumenteerde invoer van Respan staan voorafgaande berichten in span.input en de te beoordelen beurt in span.output. De berichtinhoud is een string. Behoud de context die nodig is om de beurt te begrijpen, inclusief de rollen van de sprekers, het relevante verzoek van de gebruiker en eventueel tekstueel bewijsmateriaal dat de assistent heeft gebruikt. Lever voor een kwaliteitscontrole de werkelijke beurt aan, niet een parafrase waaruit het te beoordelen gedrag is verdwenen.
Een illustratieve review kan uitgaan van een gebruikersbericht dat herhaalde problemen beschrijft en een antwoord van de assistent dat aanbiedt het uit te zoeken. Definieer frustratie van de gebruiker en een belofte van de assistent als afzonderlijke observaties. Als een toolresultaat ertoe doet om te beoordelen of een bewering onderbouwd was, behoud dan de relevante tekst van dat resultaat in de context. De uitvoer is een evaluatie van die definities binnen de aangeleverde span; het model voert het beloofde onderzoek niet uit en past het gesprek zelf niet aan.
Aanwezig, afwezig en niet waarneembaar
De scoringsrespons bevat de id van het gedrag met p_present, p_absent en p_not_observable, die samen ongeveer 1 zijn. Niet waarneembaar betekent dat de trace de vraag niet kan beantwoorden. Dat is iets anders dan afwezig. Bij een definitie zoals acceptatie van een oplossing door de klant is een span die eindigt voordat de klant reageert onvolledig bewijs, ook als het antwoord van de assistent zelfverzekerd klinkt.
Bewaar alle drie de waarden wanneer je een resultaat voorbereidt voor review. Een categorie die op basis van de hoogste waarde wordt gekozen, kan nuttig zijn voor weergave, maar de verdeling laat zien hoe onzeker de observatie was. Gebruik een lage aanwezigheidswaarde niet als enige grond om te concluderen dat het gedrag zeker niet heeft plaatsgevonden. Wanneer ontbrekend bewijs de overhand heeft, kan de nuttige actie zijn om de relevante context te verkrijgen of het resultaat als onbekend te bewaren, in plaats van een verklaring te verzinnen.
Meerdere definities over hetzelfde bewijsmateriaal
De scoringsworkflow van de producent evalueert meerdere gedragsdefinities samen over één trace en geeft voor elke identifier een resultaat terug in de volgorde van het verzoek. De documentatie noemt geen maximum aantal gedragingen per verzoek. Dat betekent niet dat er een universeel tokenvenster of een onbeperkte tracegrootte is. Houd definities doelgericht en het bewijsmateriaal relevant, en bewaar de koppeling tussen elk teruggegeven resultaat en de definitie die het heeft opgeleverd.
De gedragsresultaten zijn onafhankelijke observaties en geen antwoord met één exclusieve keuze. Frustratie, een excuus en een voorgestelde overdracht kunnen allemaal in dezelfde uitwisseling aanwezig zijn. Hun afzonderlijke driedelige verdelingen hebben betekenis binnen elke definitie; het optellen van aanwezigheidswaarden over verschillende gedragingen levert geen genormaliseerde categorieverdeling en geen geordende rubricscore op.
Bewaar het gekozen profiel bij de resultaten
De maker documenteert de namen van Lite en de standaardeditie met een gedeelde vorm voor verzoek en resultaat. Dat contract ondersteunt het voorbereiden van traces en het interpreteren van gedragskansen voor beide benoemde profielen. Het toont niet aan dat Lite dezelfde gewichten, hetzelfde aantal parameters of dezelfde kwaliteit heeft als de andere editie. Houd het gekozen profiel herkenbaar bij het beoordelen van de resultaten, in plaats van stilzwijgend resultaten van verschillende edities uit te wisselen.
Gebruik gelabelde gesprekken uit de beoogde taak om drempels te kiezen voor logging, routering of review. Bewaar resultaten met een hoge waarde voor niet waarneembaar en grensgevallen voor inspectie, en vergelijk elke schijnbare fout met de oorspronkelijke beurt en de gedragsdefinitie. Het bruikbare eindartefact bevat de identifier van de tekstspan, de definitie, het gekozen profiel en het volledige driedelige kansresultaat. Een latere stap in de applicatie beslist wat er met die observatie gebeurt; de scoringsuitvoer van Lite voert zelf geen overdracht uit, blokkeert geen antwoord en genereert geen herstel.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteAan de slag
Span-01 Lite is het afzonderlijk benoemde gedragsscoringsprofiel van Respan voor tekstgesprekken en agent-traces. Het werkt met door de aanroeper gedefinieerde gedragingen en geeft voor elk daarvan kansen terug voor aanwezig, afwezig en niet waarneembaar, met dezelfde gedocumenteerde scoringsworkflow als Span-01.
- 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-lite | 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 / 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 / 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-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
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-lite
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Respan: Span-01 Lite
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/systemone·respan/span-01-lite:text→decisions- Welke velden gebruikt het verzoek?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user