Respan: Span-01 Lite
Span-01 Lite – atskirai pavadintas Respan elgsenos vertinimo profilis tekstiniams pokalbiams ir agentų pėdsakams. Jis naudoja užklausos siuntėjo apibrėžtas elgsenas ir kiekvienai iš jų grąžina tikimybes „yra“, „nėra“ ir „negalima stebėti“, taikydamas tą pačią dokumentuotą vertinimo darbo eigą kaip ir Span-01.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Span-01 Lite – atskirai pavadintas modelio profilis Respan elgsenos vertinimo šeimoje Span-01. Gamintojo greitos pradžios vadove ir modelių lentelėje Lite nurodomas kaip vienas iš dviejų profilių, naudojančių tą pačią vertinimo darbo eigą. Jis gauna tekstinę sąveiką ir paprasta kalba parašytus elgsenos apibrėžimus, tada kiekvienam apibrėžimui grąžina tris tikimybes: „yra“, „nėra“ ir „negalima stebėti“. Naudinga profilio išvestis yra elgsenos įrašas su aiškiai išreikštu neapibrėžtumu, o ne parašytas atsakymas į pokalbį.
Pasirinkite stebėjimą ir jo ribas
Apibrėžkite elgseną žodžiais, atitinkančiais jūsų užduotį. Tikrindami perdavimą žmogui, nurodykite, ar tai reiškia, kad naudotojas aiškiai prašo žmogaus, kad asistentas sako, jog reikia perdavimo, ar bet kurią iš šių sąlygų. Jei paprastas nusivylimas neturėtų būti įskaitomas, tai ir nurodykite. Tikrindami atsiprašymą, apibrėžkite, kokia formuluotė laikoma atsiprašymu, užuot rėmęsi neaiškia žyme. Kiekvienas apibrėžimas turi identifikatorių, kurį vertintojas grąžina kartu su tikimybėmis.
Elgsenų rinkinį nustato užklausos siuntėjas. Tokie pavyzdžiai kaip susierzinimas, nepagrįsti pažadai, netinkamas įrankių naudojimas ar pasikartojantys agento veiksmai yra apibrėžimai, kuriuos reikia pateikti, o ne fiksuotas modelyje įdiegtų kategorijų sąrašas. Kiekvienas apibrėžimas turi būti stebimas pateiktoje sąveikoje. Trumpa atkarpa gali leisti nustatyti, ar asistentas atsiprašė, tačiau joje gali trūkti įrodymų, kad išorinė problema iš tikrųjų buvo išspręsta.
Paruoškite pokalbio atkarpą
Respan dokumentuotoje įvestyje ankstesni pranešimai pateikiami lauke span.input, o vertinama replika – lauke span.output. Pranešimo turinys yra teksto eilutė. Išsaugokite kontekstą, reikalingą replikai suprasti, įskaitant kalbėtojų vaidmenis, susijusią naudotojo užklausą ir visus tekstinius įrodymus, kuriais rėmėsi asistentas. Tikrindami kokybę, pateikite tikrąją repliką, o ne perfrazę, kurioje vertinamos elgsenos nebelieka.
Pavyzdinėje peržiūroje galima paimti naudotojo pranešimą, kuriame aprašomos pasikartojančios problemos, ir asistento atsakymą, kuriame siūloma tai ištirti. Naudotojo susierzinimą ir asistento pažadą apibrėžkite kaip atskirus stebėjimus. Jei vertinant, ar teiginys buvo pagrįstas, svarbus įrankio rezultatas, išsaugokite atitinkamą to rezultato tekstą kontekste. Išvestis yra šių apibrėžimų įvertinimas pateiktoje atkarpoje; modelis pats neatlieka pažadėto tyrimo ir nekeičia pokalbio.
„Yra“, „nėra“ ir „negalima stebėti“
Vertinimo atsakyme pateikiamas elgsenos id su p_present, p_absent ir p_not_observable, kurių suma apytiksliai lygi 1. „Negalima stebėti“ reiškia, kad pėdsakas neleidžia atsakyti į klausimą. Tai skiriasi nuo „nėra“. Tokiam apibrėžimui kaip kliento sutikimas su sprendimu atkarpa, kuri baigiasi prieš klientui sureaguojant, yra nepakankamas įrodymas, net jei asistento atsakymas skamba užtikrintai.
Ruošdami rezultatą peržiūrai, išsaugokite visas tris reikšmes. Pagal didžiausią reikšmę pasirinkta kategorija gali būti naudinga rodymui, tačiau skirstinys išsaugo informaciją apie tai, koks neapibrėžtas buvo stebėjimas. Vien iš mažos „yra“ reikšmės nedarykite išvados, kad elgsena tikrai nepasireiškė. Kai vyrauja trūkstami įrodymai, naudingas veiksmas gali būti gauti susijusį kontekstą arba palikti rezultatą kaip nežinomą, užuot sugalvojus paaiškinimą.
Keli apibrėžimai tiems patiems įrodymams
Gamintojo vertinimo darbo eiga kartu įvertina kelis elgsenos apibrėžimus viename pėdsake ir grąžina rezultatą kiekvienam identifikatoriui užklausos tvarka. Jos dokumentacijoje nenurodyta jokia vienos užklausos elgsenų skaičiaus riba. Tai nereiškia universalaus žetonų lango ar neriboto pėdsako dydžio. Apibrėžimai turi būti tikslingi, įrodymai – susiję, o kiekvienas grąžintas rezultatas turi likti susietas su jį sukūrusiu apibrėžimu.
Elgsenų rezultatai yra nepriklausomi stebėjimai, o ne vienas išskirtinio pasirinkimo atsakymas. Tame pačiame pokalbio fragmente gali pasireikšti ir susierzinimas, ir atsiprašymas, ir pasiūlytas perdavimas žmogui. Atskiri trijų reikšmių skirstiniai turi prasmę kiekvieno apibrėžimo viduje; sudėjus skirtingų elgsenų „yra“ reikšmes, normalizuoto kategorijų skirstinio ar sutvarkyto vertinimo skalės balo negaunama.
Išsaugokite pasirinktą profilį kartu su rezultatais
Gamintojas dokumentuoja Lite ir standartinį pavadinimus su bendra užklausos ir rezultato forma. Ši sutartis leidžia paruošti pėdsakus ir interpretuoti elgsenos tikimybes bet kuriam iš abiejų pavadintų profilių. Tačiau ji neįrodo, kad Lite turi tuos pačius svorius, parametrų skaičių ar kokybę kaip kitas leidimas. Peržiūrėdami rezultatus, užtikrinkite, kad pasirinktas profilis būtų atpažįstamas, ir nesukeiskite skirtingų leidimų rezultatų nepastebimai.
Registravimo, nukreipimo ar peržiūros slenksčiams parinkti naudokite pažymėtus numatytos užduoties pokalbius. Rezultatus su didele „negalima stebėti“ reikšme ir ribinius stebėjimus palikite patikrinimui, o bet kokią tariamą klaidą palyginkite su pradine replika ir elgsenos apibrėžimu. Naudingame galutiniame rezultate yra teksto atkarpos identifikatorius, apibrėžimas, pasirinktas profilis ir visas trijų reikšmių tikimybių rezultatas. Ką daryti su šiuo stebėjimu, nusprendžia vėlesnis programos žingsnis; Lite vertinimo išvestis pati neatlieka perdavimo žmogui, neblokuoja atsakymo ir negeneruoja pataisymo.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-litePradžia
Span-01 Lite – atskirai pavadintas Respan elgsenos vertinimo profilis tekstiniams pokalbiams ir agentų pėdsakams. Jis naudoja užklausos siuntėjo apibrėžtas elgsenas ir kiekvienai iš jų grąžina tikimybes „yra“, „nėra“ ir „negalima stebėti“, taikydamas tą pačią dokumentuotą vertinimo darbo eigą kaip ir Span-01.
- Leidžiamos įvestys
- Tekstas
- Rezultatai
- decisions
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · System One POST /v1/systemone
- Įvestis
text- Išvestis
decisions- Išvesties formatas
- json
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos respan/span-01-lite | Numatyta— |
Laukasprovider | Tipasschema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquestions | Tipasobject | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasstate | Tipasschema | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukastrace | Tipasschema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquestions.<id>.type | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos noul, choice, score | Numatyta— |
Laukasquestions.<id>.instructions | Tipasstring|object|array | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquestions.<id>.criteria | Tipasobject|array | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: choice/score: privalomi; noul: neprivalomas. choice kriterijai yra objektas; score yra masyvas su minItems1. | Numatyta— |
Laukasquestions.<id>.criteria.true | Tipasstring|object|array | ReikalavimasPrivaloma | Reikšmės ir ribos Taikoma, kai: Pateiktas noul kriterijų objektas | Numatyta— |
Laukasquestions.<id>.criteria.false | Tipasstring|object|array | ReikalavimasPrivaloma | Reikšmės ir ribos Taikoma, kai: Pateiktas noul kriterijų objektas | Numatyta— |
Įvesties medžiagos deriniai
noul · Privaloma: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Privaloma: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Privaloma: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, state, questions |
Parametrasmaterial_types | Specifikacijatext |
Parametrasoptional_controls | Specifikacijaprovider, session_id, trace, user |
Parametrasmultimodal_input_binding | Specifikacijanull |
Gyvavimo ciklas: synchronous
Siųskite tikslų modelio ID ir išsaugokite visą pirminį atsakymą.
Planai
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Ailoot įkainiai
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Konteksto tokenų daugiau nei | Konteksto tokenų iki imtinai | Mokestis |
|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Konteksto tokenų daugiau nei— | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0 / 1K tokenų Išvestis · Išvesties tokenai $0 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
| KonfigūracijaUžklausos ilgio pakopa 1 | Įkainių lentelė— | Konteksto tokenų daugiau nei0 | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0 / 1K tokenų Išvestis · Išvesties tokenai $0 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · System One
json
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.
Išsaugomas kiekvienas pateiktas atsakymas pagal klausimo ID su tiksliu tipu, noul/choice/score reikšme, pasikliovimo lygiu, tikimybėmis ir legenda. Visas pradinis JSON saugomas ir grąžinamas tik atsiskaičius.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite pradinę operaciją ir visą arba dalinį atsakymą; nekartokite POST.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukasmodel | Tipasstring |
Laukasid | Tipasstring |
Laukasprovider | Tipasstring |
Laukasanswers.<id>.type | Tipasstring |
Laukasanswers.<id>.noul | Tipasnumber |
Laukasanswers.<id>.choice | Tipasstring |
Laukasanswers.<id>.score | Tipasnumber |
Laukasanswers.<id>.confidence | Tipasnumber |
Laukasanswers.<id>.probabilities | Tipasobject |
Laukasanswers.<id>.legend | Tipasobject |
Laukasusage.input_tokens | Tipasinteger |
Laukasusage.output_tokens | Tipasinteger |
Laukasusage.cost | Tipasnumber |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNegaliojantis privalomas laukas, pateikimo forma arba reikšmė | Kitas žingsnisPataisykite nurodytą užklausos lauką. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra respan/span-01-lite
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Respan: Span-01 Lite
- Kokios įvestys ir rezultatai prieinami?
POST /v1/systemone·respan/span-01-lite:text→decisions- Kokius laukus naudoja užklausa?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user