Respan: Span-01
Span-01 je textový klasifikátor chování Respan pro konverzace a stopy agentů. Definujte chování běžným jazykem a pro každé vrátí tři pravděpodobnosti: přítomné, nepřítomné a nepozorovatelné. Zachovává tak nejistotu, když dodaná stopa nemůže otázku rozhodnout.
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 je model Respan pro hodnocení chování v konverzacích a stopách agentů. Čte textovou interakci spolu s definicemi chování napsanými běžným jazykem a pro každou definici vrací pravděpodobnosti. Výstup rozlišuje chování, které je v dodané stopě přítomné, nepřítomné nebo nepozorovatelné. Hodnoticímu postupu tak dává číselný signál s výslovným způsobem vyjádření chybějících podkladů namísto generovaného vysvětlení, které by bylo nutné parsovat.
Definujte chování, které chcete pozorovat
Chování zadává volající. Vkládání škodlivých instrukcí do promptu, nepodložená tvrzení, odhalení tajných údajů, opakující se smyčky, nesprávné použití nástrojů a frustrace uživatele jsou možné definice, nikoli pevná taxonomie zabudovaná do modelu. Uveďte, co se za chování počítá a co ne. Úzká definice může odlišit žádost uživatele o předání člověku od pouhého vyjádření zklamání. Jiná může rozlišit přiznání problému asistentem od slibu akce, kterou nemůže provést.
Používejte stabilní identifikátory s definicemi, aby výsledky zůstaly spojené s hodnoceným chováním. Zaměřte kritérium na něco, co stopa může ukázat. Pokud chování vyžaduje zdrojový dokument, výsledek nástroje nebo pozdější reakci zákazníka, zahrňte tento podklad na příslušné místo textové interakce. Samotná definice nemůže doložit fakt, který ve stopě chybí.
Připravte předchozí kontext a cílovou repliku
Zdokumentovaný vstup odděluje předchozí zprávy v span.input od cílové repliky v span.output. Obsah každé zprávy je řetězec. Zadejte skutečný kontext konverzace a repliku, kterou chcete hodnotit, se zachováním rolí mluvčích a pořadí potřebného k interpretaci. Jde o profil hodnocení textu; připravený text dokumentu nebo přepis mohou být podkladem, zatímco média, z nichž byl text získán, nejsou sama zdokumentovaným vstupem.
U interakce s podporou uchovejte požadavek zákazníka s navrhovanou odpovědí asistenta. U agenta používajícího nástroje zachovejte relevantní pozorování nástroje a odpověď, která z něj vycházela. Ilustrační definice podloženosti se může ptát, zda asistent tvrdí závěr, který dodané pozorování nepodporuje. Užitečný výsledek se týká definovaného chování v tomto úseku, nikoli úplné diagnózy celé aplikace.
Čtěte tři pravděpodobnosti pro každou definici
Každý výsledek zahrnuje identifikátor chování a p_present, p_absent a p_not_observable. Součet tří pravděpodobností je přibližně 1. Přítomné odhaduje, že chování nastalo; nepřítomné odhaduje, že nenastalo; nepozorovatelné odhaduje, že dodaný úsek postrádá podklady potřebné k rozhodnutí. Jde o odlišné významy, které mají při interpretaci výsledků zůstat oddělené.
Úsek končící vyjádřením asistenta, že vyřeší problém, může například ukazovat slib. Nemůže zatím ukázat, že zákazník přijal pozdější řešení, pokud chybí jeho reakce. S výsledkem vycházejícím z chybějících podkladů zacházejte jako s neznámým, místo abyste jej převáděli na nepřítomné. Nízká pravděpodobnost přítomnosti není automaticky silným dokladem nepřítomnosti, pokud významná část rozdělení představuje nepozorovatelnost.
Hodnocení definic chování v jednom průchodu
Respan popisuje Span-01 jako uvažující klasifikátor trénovaný nejprve pro obecnou klasifikaci pomocí RLAIF a poté specializovaný na detekci chování. Každá definice běží jako paralelní větev nad stejnou stopou a model vrací pravděpodobnosti chování v jediném dopředném průchodu. Hybridní mechanismus pozornosti podporuje zpracování dlouhých a složitých stop. Model negeneruje tokeny, nepíše slovní posudek ani nevytváří volné vysvětlení své klasifikace.
Koncepční průvodce ani referenční dokumentace hodnocení neuvádějí limit počtu chování v jednom požadavku. Každá definice je přesto součástí dodaného hodnocení, proto ji udržujte jasnou a relevantní a nepovažujte absenci početního limitu za doklad neomezené vstupní kapacity. Výsledek obsahuje jeden záznam pro každé chování v pořadí požadavku, identifikovaný jeho id. Více definic popisuje více nezávislých pozorování; nejde o vzájemně se vylučující volby kategorií, které se musí napříč chováními sečíst na jednu.
Příprava užitečného hodnoticího artefaktu
Kombinujte vrácené pravděpodobnosti s prahy pro konkrétní úlohu a pravidly kontroly mimo model. Výrobce doporučuje používat označené konverzace k volbě těchto prahů a zkoumat hraniční výsledky přítomnosti nebo výsledky s vysokou nepozorovatelností. Postup podpory může odděleně zaznamenávat frustraci, navrhovanou eskalaci a nepodložený slib. Postup hodnocení kvality agenta může sledovat opakované akce nebo to, zda odpověď využila podklady, které měla k dispozici.
Uchovávejte textový úsek, definici chování, identifikátor výsledku a úplné trojcestné rozdělení společně. Při změně definice počítejte s tím, že se mění to, co pravděpodobnost měří. Zdánlivé chyby posuzujte podle skutečné konverzace, místo abyste číselný výsledek pokládali za důkaz nepozorované události. Užitečným artefaktem je záznam chování spojený se stopou a kritériem, s nejistotou zachovanou pro pozdější zkoumání nebo další rozhodnutí aplikace.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Úvod
Span-01 je textový klasifikátor chování Respan pro konverzace a stopy agentů. Definujte chování běžným jazykem a pro každé vrátí tři pravděpodobnosti: přítomné, nepřítomné a nepozorovatelné. Zachovává tak nejistotu, když dodaná stopa nemůže otázku rozhodnout.
- 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 | 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.00004 / 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.00004 / 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",
"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
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
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Respan: Span-01
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/systemone·respan/span-01:text→decisions- Jaká pole požadavek používá?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user