Respan: Span-01
Span-01 je besedilni razvrščevalnik vedenja Respan za pogovore in sledi agentov. Vedenja opredelite v običajnem jeziku, model pa za vsako vrne tri verjetnosti: prisotno, odsotno in ni mogoče ugotoviti iz zapisa, pri čemer ohrani negotovost, kadar podana sled ne more razrešiti vprašanja.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Span-01 je model Respan za ocenjevanje vedenja v pogovorih in sledeh agentov. Bere besedilno interakcijo skupaj z opredelitvami vedenja v običajnem jeziku in za vsako opredelitev vrne verjetnosti. Izhod ločuje vedenje, ki je v podani sledi prisotno, odsotno ali ga ni mogoče ugotoviti iz zapisa. To poteku ocenjevanja daje številčni signal z izrecnim načinom predstavljanja manjkajočih dokazov, ne ustvarjene razlage, ki jo je treba razčleniti.
Opredelite vedenje, ki ga želite opazovati
Vedenja poda klicatelj. Vbrizgavanje pozivov, nepodprte trditve, razkritje skrivnosti, ponavljajoče se zanke, napačna uporaba orodij in frustracija uporabnika so možne opredelitve, ne določena taksonomija, vgrajena v model. Navedite, kaj šteje kot vedenje in kaj ne. Ozka opredelitev lahko uporabnikovo zahtevo po predaji človeku loči od zgolj izraženega razočaranja. Druga lahko loči asistentovo priznanje problema od obljube dejanja, ki ga ne more izvesti.
Z opredelitvami uporabite stabilne identifikatorje, da rezultati ostanejo povezani z ocenjenim vedenjem. Merilo osredotočite na nekaj, kar sled lahko pokaže. Če vedenje zahteva izvorni dokument, rezultat orodja ali poznejši odziv stranke, te dokaze vključite v besedilno interakcijo na ustrezno mesto. Sama opredelitev ne more dokazati dejstva, ki ga v sledi ni.
Pripravite predhodni kontekst in ciljno repliko
Dokumentirani vhod loči predhodna sporočila v span.input od ciljne replike v span.output. Vsebina vsakega sporočila je niz. Podajte dejanski kontekst pogovora in repliko, ki jo želite oceniti, ter ohranite vloge govorcev in vrstni red, potreben za interpretacijo. To je profil ocenjevanja besedila; pripravljeno besedilo dokumenta ali prepis je lahko dokaz, mediji, iz katerih je bilo to besedilo pridobljeno, pa sami niso dokumentirani vhod.
Pri interakciji s podporo strankino zahtevo ohranite skupaj s predlaganim asistentovim odgovorom. Pri agentu, ki uporablja orodja, ohranite relevantno opažanje orodja in odgovor, ki se je nanj opiral. Ponazoritvena opredelitev utemeljenosti lahko sprašuje, ali asistent trdi zaključek, ki ga podano opažanje ne podpira. Koristni rezultat se nanaša na opredeljeno vedenje v tem odseku, ne na popolno diagnozo celotne aplikacije.
Preberite tri verjetnosti za vsako opredelitev
Vsak rezultat vključuje identifikator vedenja ter p_present, p_absent in p_not_observable. Vsota treh verjetnosti je približno 1. Prisotno ocenjuje, da se je vedenje pojavilo; odsotno, da se ni; ni mogoče ugotoviti iz zapisa pa ocenjuje, da podanemu odseku manjkajo dokazi, potrebni za odločitev. Ti pomeni so ločeni in morajo pri interpretaciji rezultatov ostati ločeni.
Odsek, ki se konča z asistentovo izjavo, da bo rešil problem, lahko na primer pokaže obljubo. Ne more pa še pokazati, da je stranka sprejela poznejšo rešitev problema, če ni njenega odgovora. Tak rezultat z manjkajočimi dokazi obravnavajte kot neznan, namesto da ga pretvorite v odsotnost. Nizka verjetnost prisotnosti ni samodejno močan dokaz odsotnosti, kadar pomemben delež porazdelitve pripada nezmožnosti ugotovitve iz zapisa.
Ocenjevanje opredelitev vedenja v enem prehodu
Respan opisuje Span-01 kot razvrščevalnik, ki uporablja sklepanje, najprej učen za splošno razvrščanje z RLAIF, nato pa specializiran za zaznavanje vedenja. Vsaka opredelitev teče kot vzporedna veja nad isto sledjo, model pa verjetnosti vedenja vrne v enem prehodu naprej. Hibridna pozornost podpira obravnavo dolgih, kompleksnih sledi. Model ne generira žetonov, ne piše pripovedne presoje in ne ustvarja razlage svoje razvrstitve v prosti obliki.
Konceptualni vodnik in referenca za ocenjevanje ne dokumentirata omejitve števila vedenj na zahtevo. Vsaka opredelitev je še vedno del podanega ocenjevanja, zato naj bo jasna in relevantna; odsotnosti številčne omejitve ne obravnavajte kot dokaz neomejene vhodne zmogljivosti. Rezultat vsebuje po en vnos za vsako vedenje v vrstnem redu zahteve, označen z njegovim id. Več opredelitev opisuje več neodvisnih opažanj; to niso medsebojno izključujoče izbire kategorij, katerih verjetnosti bi se morale po vseh vedenjih sešteti v 1.
Priprava uporabnega artefakta ocenjevanja
Vrnjene verjetnosti združite s pragovi in pravili pregleda, prilagojenimi nalogi, zunaj modela. Proizvajalec priporoča uporabo označenih pogovorov za izbiro teh pragov in pregled mejnih rezultatov prisotnosti ali visokih rezultatov nezmožnosti ugotovitve iz zapisa. Delovni tok podpore lahko frustracijo, predlagano eskalacijo in nepodprto obljubo beleži ločeno. Potek preverjanja kakovosti agenta lahko spremlja ponavljajoča se dejanja ali preverja, ali je odgovor uporabil dokaze, ki so mu bili na voljo.
Besedilni odsek, opredelitev vedenja, identifikator rezultata in celotno tridelno porazdelitev ohranite skupaj. Ko se opredelitev spremeni, upoštevajte, da se spremeni to, kar verjetnost meri. Navidezne napake preverjajte glede na dejanski pogovor, namesto da bi številčni rezultat šteli za dokaz neopaženega dogodka. Koristni artefakt je zapis vedenja, povezan s sledjo in merilom, z ohranjeno negotovostjo za poznejši pregled ali naslednjo odločitev aplikacije.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Začetek
Span-01 je besedilni razvrščevalnik vedenja Respan za pogovore in sledi agentov. Vedenja opredelite v običajnem jeziku, model pa za vsako vrne tri verjetnosti: prisotno, odsotno in ni mogoče ugotoviti iz zapisa, pri čemer ohrani negotovost, kadar podana sled ne more razrešiti vprašanja.
- Dovoljeni vhodi
- Besedilo
- Rezultati
- decisions
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · System One POST /v1/systemone
- Vhod
text- Izhod
decisions- Izhodni format
- json
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve respan/span-01 | Privzeto— |
Poljeprovider | Vrstaschema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljequestions | Vrstaobject | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljesession_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljestate | Vrstaschema | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljetrace | Vrstaschema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljeuser | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljequestions.<id>.type | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve noul, choice, score | Privzeto— |
Poljequestions.<id>.instructions | Vrstastring|object|array | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljequestions.<id>.criteria | Vrstaobject|array | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: choice/score: obvezno; noul: neobvezno. Merila choice so objekt; score je polje z minItems1. | Privzeto— |
Poljequestions.<id>.criteria.true | Vrstastring|object|array | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: Posredovan je objekt meril noul | Privzeto— |
Poljequestions.<id>.criteria.false | Vrstastring|object|array | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: Posredovan je objekt meril noul | Privzeto— |
Kombinacije vhodnih gradiv
noul · Obvezno: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Obvezno: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Obvezno: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, state, questions |
Parametermaterial_types | Specifikacijatext |
Parameteroptional_controls | Specifikacijaprovider, session_id, trace, user |
Parametermultimodal_input_binding | Specifikacijanull |
Življenjski cikel: synchronous
Pošljite natančni ID modela in ohranite celoten izvorni odgovor.
Cenik
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Cene Ailoot
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.00004 / 1K žetonov Izhod · Izhodni žetoni $0 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
| NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.00004 / 1K žetonov Izhod · Izhodni žetoni $0 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
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
Prejmi in shrani rezultate
Ailoot Ultra · System One
json
Ohrani vse dokončane rezultate
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohrani se vsak podani odgovor z ID-jem vprašanja, njegovo natančno vrsto, vrednostjo noul/choice/score, zaupanjem, verjetnostmi in legendo. Celoten izvirni JSON se shrani in vrne šele po obračunu.
Če je treba preveriti izvirni odgovor
Ohranite prvotno operacijo in celoten/delni odgovor; ne ponovite POST.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljemodel | Vrstastring |
Poljeid | Vrstastring |
Poljeprovider | Vrstastring |
Poljeanswers.<id>.type | Vrstastring |
Poljeanswers.<id>.noul | Vrstanumber |
Poljeanswers.<id>.choice | Vrstastring |
Poljeanswers.<id>.score | Vrstanumber |
Poljeanswers.<id>.confidence | Vrstanumber |
Poljeanswers.<id>.probabilities | Vrstaobject |
Poljeanswers.<id>.legend | Vrstaobject |
Poljeusage.input_tokens | Vrstainteger |
Poljeusage.output_tokens | Vrstainteger |
Poljeusage.cost | Vrstanumber |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavno obvezno polje, predstavitev ali vrednost | Naslednji korakPopravite navedeno polje zahteve. |
Druga imena
Druga imena modelov
Ailoot Ultra respan/span-01
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · Respan: Span-01
- Kateri vhodi in rezultati so na voljo?
POST /v1/systemone·respan/span-01:text→decisions- Katera polja uporablja zahteva?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user