Respan: Span-01
Span-01 je textový klasifikátor správania od Respan pre konverzácie a záznamy priebehu agentov. Správania definujete bežným jazykom a model pre každé vráti tri pravdepodobnosti: prítomné, neprítomné a nepozorovateľné, čím zachová neistotu v prípadoch, keď dodaný záznam nedokáže otázku rozhodnúť.
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 je model od Respan na hodnotenie správania v konverzáciách a záznamoch priebehu agentov. Číta textovú interakciu spolu s definíciami správania napísanými bežným jazykom a pre každú definíciu vracia pravdepodobnosti. Výstup rozlišuje, či je správanie v dodanom zázname prítomné, neprítomné alebo nepozorovateľné. Hodnotiaci pracovný postup tak získa číselný signál s explicitným spôsobom vyjadrenia chýbajúcich dôkazov, namiesto vygenerovaného vysvetlenia, ktoré by bolo treba parsovať.
Definujte správanie, ktoré chcete pozorovať
Správania dodáva volajúci. Vkladanie škodlivých pokynov (prompt injection), nepodložené tvrdenia, odhalenie tajných údajov, opakujúce sa slučky, nesprávne použitie nástrojov a frustrácia používateľa sú možné definície, nie pevná taxonómia zabudovaná do modelu. Uveďte, čo sa za dané správanie považuje a čo nie. Úzka definícia dokáže odlíšiť používateľa, ktorý žiada o odovzdanie človeku, od používateľa, ktorý iba vyjadruje sklamanie. Iná dokáže odlíšiť asistenta, ktorý uznáva problém, od asistenta, ktorý sľubuje akciu, ktorú nedokáže vykonať.
K definíciám používajte stabilné identifikátory, aby výsledky zostali priradené k hodnotenému správaniu. Kritérium zamerajte na niečo, čo záznam dokáže ukázať. Ak si správanie vyžaduje zdrojový dokument, výsledok nástroja alebo neskoršiu odpoveď zákazníka, zahrňte tieto podklady do textovej interakcie na miesto, kam patria. Samotná definícia nedokáže preukázať skutočnosť, ktorá v zázname chýba.
Pripravte predchádzajúci kontext a cieľovú repliku
Zdokumentovaný vstup oddeľuje predchádzajúce správy v span.input od cieľovej repliky v span.output. Obsah každej správy je reťazec. Dodajte skutočný kontext konverzácie a repliku, ktorú chcete ohodnotiť, so zachovaním rolí hovoriacich a poradia potrebného na jej interpretáciu. Ide o profil na hodnotenie textu; podkladom môže byť pripravený text dokumentu alebo prepis, zatiaľ čo médiá, z ktorých bol tento text získaný, samy osebe zdokumentovaným vstupom nie sú.
Pri interakcii s podporou ponechajte požiadavku zákazníka spolu s navrhovanou odpoveďou asistenta. Pri agentovi, ktorý používa nástroje, zachovajte relevantné pozorovanie z nástroja a odpoveď, ktorá sa o neho opierala. Ilustračná definícia podloženosti sa môže pýtať, či asistent tvrdí záver, ktorý dodané pozorovanie nepodporuje. Užitočný výsledok sa týka definovaného správania v danom úseku, nie úplnej diagnostiky celej aplikácie.
Čítajte tri pravdepodobnosti pre každú definíciu
Každý výsledok obsahuje identifikátor správania a p_present, p_absent a p_not_observable. Súčet týchto troch pravdepodobností je približne 1. Prítomné odhaduje, že správanie nastalo; neprítomné odhaduje, že nenastalo; nepozorovateľné odhaduje, že dodanému úseku chýbajú podklady potrebné na rozhodnutie. Ide o samostatné významy, ktoré by mali zostať oddelené aj pri interpretácii výsledkov.
Napríklad úsek, ktorý končí tým, že asistent povie, že problém vyrieši, môže ukazovať sľub. Ak však chýba odpoveď zákazníka, ešte nemôže ukázať, že zákazník konečné riešenie prijal. Takýto výsledok s chýbajúcim dôkazom považujte za neznámy, namiesto toho, aby ste ho prevádzali na neprítomný. Nízka pravdepodobnosť prítomnosti nie je automaticky silným dôkazom neprítomnosti, ak významný podiel rozdelenia pripadá na nepozorovateľné.
Hodnotenie všetkých definícií správania v jednom prechode
Respan opisuje Span-01 ako klasifikátor s uvažovaním, ktorý bol najprv natrénovaný na všeobecnú klasifikáciu pomocou RLAIF a potom špecializovaný na detekciu správania. Každá definícia beží ako paralelná vetva nad tým istým záznamom a model vracia pravdepodobnosti správania v jednom doprednom prechode. Hybridný mechanizmus pozornosti podporuje jeho spracovanie dlhých a zložitých záznamov. Negeneruje tokeny, nepíše naratívny posudok ani nevytvára voľné vysvetlenie svojej klasifikácie.
Koncepčná príručka ani referencia k hodnoteniu neuvádzajú limit počtu správaní na požiadavku. Každá definícia je napriek tomu súčasťou dodaného hodnotenia, preto ju udržujte jasnú a relevantnú a absenciu limitu počtu nepovažujte za dôkaz neobmedzenej kapacity vstupu. Výsledok obsahuje jednu položku pre každé správanie v poradí požiadavky, identifikovanú jeho id. Viacero definícií opisuje viacero nezávislých pozorovaní; nie sú to vzájomne sa vylučujúce kategórie, ktorých súčet naprieč správaniami musí byť jedna.
Príprava užitočného hodnotiaceho artefaktu
Vrátené pravdepodobnosti kombinujte mimo modelu s prahmi a pravidlami kontroly pre konkrétnu úlohu. Výrobca odporúča zvoliť tieto prahy na základe označených konverzácií a preskúmať hraničné hodnoty prítomnosti alebo vysoké hodnoty nepozorovateľnosti. Pracovný postup podpory môže samostatne zaznamenávať frustráciu, navrhnutú eskaláciu a nepodložený sľub. Postup na hodnotenie kvality agenta môže sledovať opakované akcie alebo to, či odpoveď využila podklady, ktoré mal k dispozícii.
Textový úsek, definíciu správania, identifikátor výsledku a úplné trojcestné rozdelenie uchovávajte spolu. Pri zmene definície majte na pamäti, že sa tým mení aj to, čo pravdepodobnosť meria. Zdanlivé chyby preverujte voči skutočnej konverzácii, namiesto toho, aby ste číselný výsledok považovali za dôkaz nepozorovanej udalosti. Užitočným artefaktom je záznam o správaní naviazaný na záznam priebehu a kritérium, so zachovanou neistotou na neskoršiu kontrolu alebo pre ďalšie rozhodnutie aplikácie.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Úvod
Span-01 je textový klasifikátor správania od Respan pre konverzácie a záznamy priebehu agentov. Správania definujete bežným jazykom a model pre každé vráti tri pravdepodobnosti: prítomné, neprítomné a nepozorovateľné, čím zachová neistotu v prípadoch, keď dodaný záznam nedokáže otázku rozhodnúť.
- 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 | 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.00004 / 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.00004 / 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",
"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
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
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Respan: Span-01
- Aké vstupy a výsledky sú dostupné?
POST /v1/systemone·respan/span-01:text→decisions- Aké polia používa požiadavka?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user