Respan: Span-01
Span-01 – Respan elgsenos klasifikatorius tekstiniams pokalbiams ir agentų pėdsakams. Apibrėžkite elgsenas paprasta kalba, ir jis kiekvienai grąžins tris tikimybes: „yra“, „nėra“ ir „negalima stebėti“, išsaugodamas neapibrėžtumą, kai pateiktas pėdsakas neleidžia atsakyti į klausimą.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Span-01 – Respan elgsenos vertinimo modelis pokalbiams ir agentų pėdsakams. Jis skaito tekstinę sąveiką kartu su paprasta kalba parašytais elgsenos apibrėžimais ir grąžina tikimybes kiekvienam apibrėžimui. Išvestis atskiria, ar elgsena pateiktame pėdsake yra, jos nėra, ar jos negalima stebėti. Tai suteikia vertinimo darbo eigai skaitinį signalą su aiškiu būdu nurodyti trūkstamus įrodymus, o ne sugeneruotą paaiškinimą, kurį reikėtų analizuoti.
Apibrėžkite elgseną, kurią norite stebėti
Elgsenas pateikia užklausos siuntėjas. Raginimų injekcija, nepagrįsti teiginiai, slaptų duomenų atskleidimas, pasikartojantys ciklai, netinkamas įrankių naudojimas ir naudotojo susierzinimas yra galimi apibrėžimai, o ne fiksuota į modelį įdiegta taksonomija. Nurodykite, kas laikoma ta elgsena, o kas – ne. Siauras apibrėžimas gali atskirti naudotoją, prašantį perduoti pokalbį žmogui, nuo naudotojo, kuris tik reiškia nusivylimą. Kitas apibrėžimas gali atskirti asistentą, pripažįstantį problemą, nuo asistento, žadančio veiksmą, kurio jis negali atlikti.
Apibrėžimams naudokite stabilius identifikatorius, kad rezultatai liktų susieti su vertinama elgsena. Kriterijų sutelkite į tai, ką pėdsakas gali parodyti. Jei elgsenai nustatyti reikia šaltinio dokumento, įrankio rezultato ar vėlesnio kliento atsakymo, įtraukite šiuos įrodymus į tekstinę sąveiką tinkamoje vietoje. Vien apibrėžimas negali nustatyti fakto, kurio pėdsake nėra.
Paruoškite ankstesnį kontekstą ir vertinamą repliką
Dokumentuotoje įvestyje ankstesni pranešimai lauke span.input atskiriami nuo vertinamos replikos lauke span.output. Kiekvieno pranešimo turinys yra teksto eilutė. Pateikite tikrąjį pokalbio kontekstą ir repliką, kurią norite įvertinti, išlaikydami kalbėtojų vaidmenis ir tvarką, reikalingą jai interpretuoti. Tai teksto vertinimo profilis; paruoštas dokumento tekstas ar transkripcija gali būti įrodymas, tačiau medija, iš kurios tas tekstas gautas, pati nėra dokumentuota įvestis.
Pagalbos sąveikos atveju kliento užklausą laikykite kartu su asistento siūlomu atsakymu. Įrankius naudojančio agento atveju išsaugokite susijusį įrankio stebėjimą ir atsakymą, kuris juo rėmėsi. Pavyzdinis pagrįstumo apibrėžimas galėtų klausti, ar asistentas teigia išvadą, kurios pateiktas stebėjimas nepagrindžia. Naudingas rezultatas susijęs su apibrėžta elgsena toje atkarpoje, o ne su išsamia visos programos diagnoze.
Kiekvienam apibrėžimui skaitykite tris tikimybes
Kiekviename rezultate yra elgsenos identifikatorius ir p_present, p_absent bei p_not_observable. Šių trijų tikimybių suma apytiksliai lygi 1. „Yra“ išreiškia įvertinimą, kad elgsena pasireiškė; „nėra“ – kad nepasireiškė; „negalima stebėti“ – kad pateiktoje atkarpoje trūksta sprendimui reikalingų įrodymų. Tai atskiros reikšmės, ir interpretuojant rezultatus jos turi likti atskiros.
Pavyzdžiui, atkarpa, kuri baigiasi asistento žodžiais, kad jis išspręs problemą, gali parodyti pažadą. Tačiau ji dar negali parodyti, kad klientas priėmė galutinį sprendimą, jei kliento atsakymo nėra. Tokį trūkstamų įrodymų rezultatą laikykite nežinomu, o ne paverskite „nėra“. Maža „yra“ tikimybė nėra savaime stiprus nebuvimo įrodymas, kai didelė skirstinio dalis tenka „negalima stebėti“.
Vieno praėjimo vertinimas visiems elgsenos apibrėžimams
Respan apibūdina Span-01 kaip samprotaujantį klasifikatorių, iš pradžių RLAIF metodu apmokytą bendrajam klasifikavimui, o vėliau specializuotą elgsenai aptikti. Kiekvienas apibrėžimas vykdomas kaip lygiagreti šaka tame pačiame pėdsake, o modelis elgsenos tikimybes grąžina per vieną tiesioginį praėjimą. Hibridinis dėmesio mechanizmas padeda jam apdoroti ilgus, sudėtingus pėdsakus. Jis negeneruoja žetonų, nerašo pasakojamojo vertinimo ir nepateikia laisvos formos savo klasifikacijos paaiškinimo.
Koncepcijų vadove ir vertinimo žinyne nenurodyta jokia vienos užklausos elgsenų skaičiaus riba. Vis dėlto kiekvienas apibrėžimas yra pateikto vertinimo dalis, todėl kiekvienas jų turi būti aiškus ir susijęs; skaičiaus ribos nebuvimas nėra neribotos įvesties talpos įrodymas. Rezultate kiekvienai elgsenai tenka vienas įrašas užklausos tvarka, identifikuojamas pagal jos id. Keli apibrėžimai aprašo kelis nepriklausomus stebėjimus; tai nėra vienas kitą paneigiantys kategorijų pasirinkimai, kurių suma visoms elgsenoms turi būti lygi vienetui.
Naudingo vertinimo rezultato paruošimas
Grąžintas tikimybes derinkite su konkrečiai užduočiai skirtais slenksčiais ir peržiūros taisyklėmis už modelio ribų. Gamintojas rekomenduoja šiuos slenksčius parinkti naudojant pažymėtus pokalbius ir patikrinti ribinius „yra“ rezultatus arba rezultatus su didele „negalima stebėti“ reikšme. Pagalbos tarnybos darbo eiga gali atskirai registruoti susierzinimą, pasiūlytą eskalavimą ir nepagrįstą pažadą. Agentų kokybės darbo eiga gali sekti pasikartojančius veiksmus arba tai, ar atsakyme panaudoti jam pateikti įrodymai.
Teksto atkarpą, elgsenos apibrėžimą, rezultato identifikatorių ir visą trijų reikšmių skirstinį laikykite kartu. Pasikeitus apibrėžimui, atminkite, kad keičiasi ir tai, ką tikimybė matuoja. Tariamas klaidas tikrinkite pagal tikrąjį pokalbį, o ne laikykite skaitinį rezultatą nestebėto įvykio įrodymu. Naudingas rezultatas – su pėdsaku ir kriterijumi susietas elgsenos įrašas, kuriame neapibrėžtumas išsaugotas vėlesniam patikrinimui arba kitam programos sprendimui.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Pradžia
Span-01 – Respan elgsenos klasifikatorius tekstiniams pokalbiams ir agentų pėdsakams. Apibrėžkite elgsenas paprasta kalba, ir jis kiekvienai grąžins tris tikimybes: „yra“, „nėra“ ir „negalima stebėti“, išsaugodamas neapibrėžtumą, kai pateiktas pėdsakas neleidžia atsakyti į klausimą.
- 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 | 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.00004 / 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.00004 / 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",
"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
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
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Respan: Span-01
- Kokios įvestys ir rezultatai prieinami?
POST /v1/systemone·respan/span-01:text→decisions- Kokius laukus naudoja užklausa?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user