Respan: Span-01 Lite (free)
Span-01 Lite je samostatne pomenovaný profil od Respan na hodnotenie správania v textových konverzáciách a záznamoch priebehu agentov. Pracuje so správaniami, ktoré definuje volajúci, a pre každé vracia pravdepodobnosti, že je prítomné, neprítomné alebo nepozorovateľné, pričom používa rovnaký zdokumentovaný postup hodnotenia ako Span-01.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Span-01 Lite je samostatne pomenovaný profil modelu v rodine Span-01 od Respan, ktorá je určená na hodnotenie správania. Rýchly úvod a tabuľka modelov od výrobcu uvádzajú Lite ako jeden z dvoch profilov, ktoré používajú rovnaký postup hodnotenia. Prijíma textovú interakciu a definície správania napísané bežným jazykom a pre každú definíciu vracia tri pravdepodobnosti: prítomné, neprítomné a nepozorovateľné. Užitočným výstupom profilu je záznam o správaní s explicitne vyjadrenou neistotou, nie písomná odpoveď do konverzácie.
Vyberte pozorovanie a jeho hranice
Správanie definujte slovami, ktoré zodpovedajú vašej úlohe. Pri kontrole odovzdania človeku určte, či ide o situáciu, keď používateľ výslovne žiada o človeka, keď asistent uvedie, že je potrebné odovzdanie, alebo o ktorúkoľvek z týchto podmienok. Ak sa samotné sklamanie nemá počítať, uveďte to. Pri kontrole ospravedlnenia definujte, aké formulácie predstavujú ospravedlnenie, namiesto toho, aby ste sa spoliehali na nejasné označenie. Každá definícia má identifikátor, ktorý hodnotiaci model vráti spolu s jej pravdepodobnosťami.
Množinu správaní určuje volajúci. Príklady ako frustrácia, nepodložené sľuby, nesprávne použitie nástrojov alebo opakujúce sa akcie agenta sú definície, ktoré treba dodať, nie pevný zoznam natívnych kategórií. Každú definíciu formulujte tak, aby bola pozorovateľná v dodanej interakcii. Krátky úsek môže rozhodnúť, či sa asistent ospravedlnil, a pritom nemusí obsahovať dôkaz, že externý problém bol skutočne vyriešený.
Pripravte úsek konverzácie
V zdokumentovanom vstupe od Respan sú predchádzajúce správy v span.input a hodnotená replika v span.output. Obsah správy je reťazec. Zachovajte kontext potrebný na pochopenie repliky vrátane rolí hovoriacich, relevantnej požiadavky používateľa a všetkých textových podkladov, ktoré asistent použil. Pri kontrole kvality dodajte skutočnú repliku, nie parafrázu, z ktorej zmizne hodnotené správanie.
Ilustračná kontrola môže použiť správu používateľa, ktorý opisuje opakované problémy, a odpoveď asistenta, ktorý ponúka, že vec preverí. Frustráciu používateľa a sľub asistenta definujte ako samostatné pozorovania. Ak je výsledok nástroja dôležitý na posúdenie, či bolo tvrdenie podložené, ponechajte jeho relevantný text v kontexte. Výstupom je hodnotenie týchto definícií v dodanom úseku; model sľúbené preverenie nevykonáva ani samotnú konverzáciu nemení.
Prítomné, neprítomné a nepozorovateľné
Odpoveď s hodnotením obsahuje id správania spolu s p_present, p_absent a p_not_observable, ktorých súčet je približne 1. Nepozorovateľné znamená, že záznam nedokáže na otázku odpovedať. Líši sa to od neprítomného. Pri definícii, ako je prijatie riešenia zákazníkom, je úsek končiaci pred reakciou zákazníka neúplným dôkazom, aj keď odpoveď asistenta znie sebaisto.
Pri príprave výsledku na kontrolu uchovajte všetky tri hodnoty. Kategória zvolená podľa najvyššej hodnoty môže byť užitočná na zobrazenie, ale rozdelenie zachováva informáciu o tom, aké neisté bolo pozorovanie. Nízku hodnotu prítomnosti samu osebe nepoužívajte na záver, že správanie určite nenastalo. Keď prevažuje chýbajúci dôkaz, užitočným krokom môže byť získanie relevantného kontextu alebo ponechanie výsledku ako neznámeho, namiesto vymýšľania vysvetlenia.
Niekoľko definícií nad tými istými podkladmi
Postup hodnotenia od výrobcu vyhodnocuje viacero definícií správania spoločne nad jedným záznamom a vracia výsledok pre každý identifikátor v poradí požiadavky. Dokumentácia neuvádza limit počtu správaní na požiadavku. Neznamená to univerzálne tokenové okno ani neobmedzenú veľkosť záznamu. Definície udržujte účelné a podklady relevantné a zachovajte väzbu medzi každým vráteným výsledkom a definíciou, ktorá ho vytvorila.
Výsledky pre jednotlivé správania sú nezávislé pozorovania, nie jedna odpoveď s výlučným výberom. Frustrácia, ospravedlnenie aj navrhnuté odovzdanie môžu byť v tej istej výmene prítomné súčasne. Ich jednotlivé trojcestné rozdelenia majú význam v rámci každej definície; sčítaním hodnôt prítomnosti naprieč rôznymi správaniami nevznikne normalizované rozdelenie kategórií ani usporiadané skóre podľa hodnotiacej stupnice.
Uchovávajte zvolený profil spolu s výsledkami
Výrobca dokumentuje názov Lite aj názov štandardnej edície so spoločným tvarom požiadavky a výsledku. Tento kontrakt umožňuje pripravovať záznamy a interpretovať pravdepodobnosti správania pre ktorýkoľvek z pomenovaných profilov. Nepreukazuje však, že Lite má rovnaké váhy, počet parametrov alebo kvalitu ako druhá edícia. Pri kontrole výsledkov udržujte zvolený profil identifikovateľný, namiesto toho, aby ste potichu zamieňali výsledky z rôznych edícií.
Na voľbu prahov pre zaznamenávanie, smerovanie alebo kontrolu použite označené konverzácie zo zamýšľanej úlohy. Výsledky s vysokou hodnotou nepozorovateľnosti a hraničné pozorovania si ponechajte na preskúmanie a každú zdanlivú chybu porovnajte s pôvodnou replikou a definíciou správania. Užitočný výsledný artefakt obsahuje identifikátor textového úseku, definíciu, zvolený profil a úplný trojcestný výsledok pravdepodobností. O tom, čo s týmto pozorovaním urobiť, rozhoduje neskorší krok aplikácie; výstup hodnotenia Lite sám osebe nevykonáva odovzdanie, neblokuje odpoveď ani negeneruje opravu.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite:free
respan/span-01-lite:freeÚvod
Span-01 Lite je samostatne pomenovaný profil od Respan na hodnotenie správania v textových konverzáciách a záznamoch priebehu agentov. Pracuje so správaniami, ktoré definuje volajúci, a pre každé vracia pravdepodobnosti, že je prítomné, neprítomné alebo nepozorovateľné, pričom používa rovnaký zdokumentovaný postup hodnotenia ako Span-01.
- Povolené vstupy
- Text
- Výsledky
- decisions
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · System One POST /v1/systemone
- Vstup
text- Výstup
decisions- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity respan/span-01-lite:free | Predvolené— |
Poleprovider | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions | Typobject | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polestate | Typschema | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poletrace | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.type | Typstring | PožiadavkaPovinné | Hodnoty a limity noul, choice, score | Predvolené— |
Polequestions.<id>.instructions | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.criteria | Typobject|array | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: choice/score: povinné; noul: voliteľné. Kritériá pre choice tvoria objekt; score je pole s minItems1. | Predvolené— |
Polequestions.<id>.criteria.true | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Polequestions.<id>.criteria.false | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Kombinácie vstupných podkladov
noul · Povinné: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Povinné: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Povinné: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, state, questions |
Parametermaterial_types | Špecifikáciatext |
Parameteroptional_controls | Špecifikáciaprovider, session_id, trace, user |
Parametermultimodal_input_binding | Špecifikácianull |
Životný cyklus: synchronous
Odošlite presné ID modelu a zachovajte celú natívnu odpoveď.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Počet tokenov kontextu väčší než | Tokeny kontextu, najviac (vrátane hranice) | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Počet tokenov kontextu väčší než— | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaPásmo dĺžky požiadavky 1 | Sadzobník— | Počet tokenov kontextu väčší než0 | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · System One
{
"model": "respan/span-01-lite:free",
"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:free'
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
Prijať a uložiť výsledky
Ailoot Ultra · System One
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachováva sa každá poskytnutá odpoveď podľa ID otázky s presným typom, hodnotou noul/choice/score, mierou istoty, pravdepodobnosťami a legendou. Celý pôvodný JSON sa uloží a vráti až po zúčtovaní.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodnú operáciu a úplnú alebo čiastočnú odpoveď; POST znova neodosielajte.
Polia odpovede
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleid | Typstring |
Poleprovider | Typstring |
Poleanswers.<id>.type | Typstring |
Poleanswers.<id>.noul | Typnumber |
Poleanswers.<id>.choice | Typstring |
Poleanswers.<id>.score | Typnumber |
Poleanswers.<id>.confidence | Typnumber |
Poleanswers.<id>.probabilities | Typobject |
Poleanswers.<id>.legend | Typobject |
Poleusage.input_tokens | Typinteger |
Poleusage.output_tokens | Typinteger |
Poleusage.cost | Typnumber |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné pole, reprezentácia alebo hodnota | Ďalší krokOpravte označené pole požiadavky. |
Aliasy
Aliasy modelov
Ailoot Ultra respan/span-01-lite:free
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Respan: Span-01 Lite (free)
- Aké vstupy a výsledky sú dostupné?
POST /v1/systemone·respan/span-01-lite:free:text→decisions- Aké polia používa požiadavka?
POST /v1/systemone·respan/span-01-lite:free:model,provider,questions,session_id,state,trace,user