Respan: Span-01 Lite
Span-01 Lite je samostatně pojmenovaný profil Respan pro hodnocení chování v textových konverzacích a stopách agentů. Používá chování definovaná volajícím a pro každé vrací pravděpodobnosti přítomnosti, nepřítomnosti a nemožnosti pozorování, se stejným zdokumentovaným postupem hodnocení jako Span-01.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Span-01 Lite je samostatně pojmenovaný profil modelu z rodiny Span-01 společnosti Respan pro hodnocení chování. Rychlý úvod a tabulka modelů výrobce označují Lite za jeden ze dvou profilů používajících stejný postup hodnocení. Přijímá textovou interakci a definice chování v běžném jazyce a poté pro každou definici vrací tři pravděpodobnosti: přítomné, nepřítomné a nepozorovatelné. Užitečným výstupem profilu je záznam chování s výslovnou nejistotou, nikoli písemná odpověď na konverzaci.
Zvolte pozorování a jeho hranice
Definujte chování slovy odpovídajícími vaší úloze. Při kontrole předání člověku určete, zda to znamená výslovnou žádost uživatele o člověka, vyjádření asistenta, že je předání potřeba, nebo kteroukoli z těchto podmínek. Pokud se pouhé zklamání nemá počítat, uveďte to. Při kontrole omluvy definujte, jaká formulace je omluvou, místo spoléhání na nejasný štítek. Každá definice má identifikátor, který hodnoticí model vrací s jejími pravděpodobnostmi.
Sadu chování určuje volající. Příklady jako frustrace, nepodložené sliby, nesprávné použití nástrojů nebo opakující se akce agenta jsou definice k zadání, nikoli pevný seznam nativních kategorií. Každá definice má být pozorovatelná v dodané interakci. Krátký úsek může rozhodnout, zda se asistent omluvil, a přitom postrádat podklady o tom, zda byl vnější problém skutečně vyřešen.
Připravte úsek konverzace
Zdokumentovaný vstup Respan umisťuje předchozí zprávy do span.input a hodnocenou repliku do span.output. Obsah zprávy je řetězec. Zachovejte kontext potřebný k pochopení repliky, včetně rolí mluvčích, relevantního požadavku uživatele a textových podkladů, které asistent použil. Pro kontrolu kvality zadejte skutečnou repliku namísto parafráze, která odstraní hodnocené chování.
Ilustrační kontrola může použít zprávu uživatele popisující opakované potíže a odpověď asistenta nabízející prošetření. Frustraci uživatele a slib asistenta definujte jako samostatná pozorování. Pokud je výsledek nástroje důležitý pro posouzení podloženosti tvrzení, zachovejte jeho relevantní text v kontextu. Výstup je hodnocením těchto definic v dodaném úseku; model neprovádí slíbené šetření ani nemění samotnou konverzaci.
Přítomné, nepřítomné a nepozorovatelné
Odpověď hodnocení obsahuje id chování a p_present, p_absent a p_not_observable, jejichž součet je přibližně 1. Nepozorovatelné znamená, že stopa nemůže odpovědět na otázku. Je to odlišné od nepřítomnosti. Pro definici, jako je přijetí řešení zákazníkem, je úsek končící před reakcí zákazníka neúplným podkladem, i když odpověď asistenta působí sebejistě.
Při přípravě výsledku ke kontrole zachovejte všechny tři hodnoty. Kategorie vybraná podle nejvyšší hodnoty může být užitečná pro zobrazení, ale rozdělení uchovává míru nejistoty pozorování. Samotnou nízkou hodnotu přítomnosti nepoužívejte k závěru, že chování rozhodně nenastalo. Pokud převládají chybějící podklady, může být užitečnou akcí získání relevantního kontextu nebo uchování výsledku jako neznámého namísto vymýšlení vysvětlení.
Několik definic nad stejnými podklady
Postup hodnocení výrobce společně vyhodnocuje více definic chování nad jednou stopou a vrací výsledek pro každý identifikátor v pořadí požadavku. Dokumentace neuvádí limit počtu chování v jednom požadavku. To nedokládá univerzální tokenové okno ani neomezenou velikost stopy. Udržujte definice účelné a podklady relevantní a zachovávejte spojení každého vráceného výsledku s definicí, která jej vytvořila.
Výsledky chování jsou nezávislá pozorování, nikoli jediná odpověď s výlučnou volbou. Frustrace, omluva i navrhované předání mohou být přítomny v téže výměně. Jejich jednotlivá trojcestná rozdělení mají význam v rámci každé definice; sčítání hodnot přítomnosti napříč různými chováními nevytváří normalizované rozdělení kategorií ani skóre podle uspořádané hodnoticí rubriky.
Uchovejte vybraný profil s jeho výsledky
Výrobce dokumentuje názvy Lite a standardního profilu se společným tvarem požadavku i výsledku. Tento kontrakt umožňuje připravovat stopy a interpretovat pravděpodobnosti chování pro kterýkoli pojmenovaný profil. Nedokládá však, že Lite má stejné váhy, počet parametrů nebo kvalitu jako druhé vydání. Při kontrole výsledků zachovejte identifikovatelnost vybraného profilu, místo abyste potichu zaměňovali výsledky různých vydání.
K volbě prahů pro zaznamenávání, směrování nebo kontrolu používejte označené konverzace ze zamýšlené úlohy. Uchovávejte výsledky s vysokou nepozorovatelností a hraniční pozorování k prozkoumání a porovnávejte každou zdánlivou chybu s původní replikou a definicí chování. Užitečný konečný artefakt obsahuje identifikátor textového úseku, definici, zvolený profil a úplný trojcestný pravděpodobnostní výsledek. Následující krok aplikace rozhoduje, co s tímto pozorováním udělat; hodnoticí výstup Lite sám neprovádí předání, neblokuje odpověď ani negeneruje opravu.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteÚvod
Span-01 Lite je samostatně pojmenovaný profil Respan pro hodnocení chování v textových konverzacích a stopách agentů. Používá chování definovaná volajícím a pro každé vrací pravděpodobnosti přítomnosti, nepřítomnosti a nemožnosti pozorování, se stejným zdokumentovaným postupem hodnocení jako Span-01.
- Přijímané vstupy
- Text
- Výsledky
- decisions
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · System One POST /v1/systemone
- Vstup
text- Výstup
decisions- Výstupní formát
- json
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity respan/span-01-lite | Výchozí— |
Poleprovider | Typschema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polequestions | Typobject | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polestate | Typschema | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Poletrace | Typschema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polequestions.<id>.type | Typstring | PožadavekPovinné | Hodnoty a limity noul, choice, score | Výchozí— |
Polequestions.<id>.instructions | Typstring|object|array | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polequestions.<id>.criteria | Typobject|array | PožadavekVolitelné | Hodnoty a limity Podmínky: choice/score: povinné; noul: volitelné. Kritéria choice tvoří objekt; score je pole s minItems1. | Výchozí— |
Polequestions.<id>.criteria.true | Typstring|object|array | PožadavekPovinné | Hodnoty a limity Platí, když: Je zadán objekt kritérií noul | Výchozí— |
Polequestions.<id>.criteria.false | Typstring|object|array | PožadavekPovinné | Hodnoty a limity Platí, když: Je zadán objekt kritérií noul | Výchozí— |
Kombinace vstupních materiálů
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
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, state, questions |
Parametrmaterial_types | Kontrakttext |
Parametroptional_controls | Kontraktprovider, session_id, trace, user |
Parametrmultimodal_input_binding | Kontraktnull |
Životní cyklus: synchronous
Odešlete přesné ID modelu a uchovejte celou nativní odpověď.
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Sazby Ailoot
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Tokeny kontextu, více než | Tokeny kontextu, do uvedené hodnoty včetně | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Tokeny kontextu, více než— | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| KonfiguracePásmo délky požadavku 1 | Tabulka sazeb— | Tokeny kontextu, více než0 | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0 / 1K tokenů Výstup · Výstupní tokeny $0 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
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
Přijímání a ukládání výsledků
Ailoot Ultra · System One
json
Uchovejte všechny dokončené výsledky
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Zachovává se každá poskytnutá odpověď přiřazená k ID otázky, její přesný typ, hodnota noul/choice/score, míra jistoty, pravděpodobnosti a legenda. Celý původní JSON se uloží a vrátí až po vyúčtování.
Pokud je nutné ověřit původní odpověď
Zachovejte původní operaci a úplnou či částečnou odpověď; požadavek POST neopakujte.
Pole odpovědi
| 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 další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatné povinné pole, způsob zadání nebo hodnota | Další krokOpravte označené pole požadavku. |
Aliasy
Aliasy modelu
Ailoot Ultra respan/span-01-lite
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Respan: Span-01 Lite
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/systemone·respan/span-01-lite:text→decisions- Jaká pole požadavek používá?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user