Respan: Span-01
A Span-01 a Respan szöveges viselkedésosztályozója beszélgetésekhez és ügynöknyomokhoz. Köznyelven határozza meg a viselkedéseket, és a modell mindegyikhez három valószínűséget ad vissza: jelen van, nincs jelen és nem megfigyelhető. Így megőrzi a bizonytalanságot, ha a megadott nyom nem dönti el a kérdést.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Span-01 a Respan viselkedéspontozási modellje beszélgetésekhez és ügynöknyomokhoz. Szöveges interakciót olvas köznyelven megírt viselkedésdefiníciókkal együtt, és minden definícióhoz valószínűségeket ad vissza. A kimenet megkülönbözteti a megadott nyomban jelen lévő, hiányzó vagy nem megfigyelhető viselkedést. Ez számszerű jelzést ad az értékelési munkafolyamatnak, a hiányzó bizonyíték kifejezett ábrázolásával, nem pedig egy feldolgozandó generált magyarázattal.
Határozza meg a megfigyelni kívánt viselkedést
A viselkedéseket a hívó adja meg. A promptinjekció, a megalapozatlan állítások, a titkok felfedése, az ismétlődő ciklusok, az eszközök helytelen használata és a felhasználói frusztráció lehetséges definíciók, nem a modellbe épített rögzített taxonómia. Mondja meg, mi számít az adott viselkedésnek, és mi nem. Egy szűk definíció megkülönböztetheti az embernek történő átadást kérő felhasználót attól, aki csupán csalódottságot fejez ki. Egy másik különbséget tehet aközött, hogy az asszisztens elismer egy problémát, vagy olyan műveletet ígér, amelyet nem tud végrehajtani.
A definíciókhoz használjon stabil azonosítókat, hogy az eredmények az értékelt viselkedéshez kapcsolódjanak. A kritérium arra összpontosítson, amit a nyom meg tud mutatni. Ha a viselkedéshez forrásdokumentum, eszközeredmény vagy későbbi ügyfélválasz szükséges, ezt a bizonyítékot a megfelelő helyen szerepeltesse a szöveges interakcióban. A definíció önmagában nem igazolhat olyan tényt, amely hiányzik a nyomból.
Készítse elő az előzménykontextust és a célfordulót
A dokumentált bemenet elkülöníti a span.input mezőben az előző üzeneteket a span.output célfordulójától. Minden üzenet tartalma karakterlánc. Adja meg a tényleges beszélgetéskontextust és a pontozni kívánt fordulót, megőrizve a beszélői szerepeket és az értelmezéshez szükséges sorrendet. Ez szövegpontozási profil; az előkészített dokumentumszöveg vagy átirat lehet bizonyíték, de a média, amelyből a szöveg származik, önmagában nem a dokumentált bemenet.
Ügyfélszolgálati interakciónál az ügyfél kérését az asszisztens javasolt válaszával együtt őrizze meg. Eszközt használó ügynöknél tartsa meg a releváns eszközmegfigyelést és az arra támaszkodó választ. Egy megalapozottsági példadefiníció rákérdezhet arra, állít-e az asszisztens olyan következtetést, amelyet a megadott megfigyelés nem támaszt alá. A hasznos eredmény az adott szakaszban meghatározott viselkedésre vonatkozik, nem a teljes alkalmazás átfogó diagnózisa.
Minden definícióhoz három valószínűséget olvasson
Minden eredmény tartalmazza a viselkedés azonosítóját, valamint a p_present, p_absent és p_not_observable értékeket. A három valószínűség összege körülbelül 1. A jelen van azt becsüli, hogy a viselkedés előfordult; a nincs jelen azt, hogy nem; a nem megfigyelhető pedig azt, hogy a megadott szakaszból hiányzik a döntéshez szükséges bizonyíték. Ezek eltérő jelentések, amelyeket az eredmények értelmezésekor is külön kell tartani.
Például egy szakasz, amely az asszisztens azon kijelentésével zárul, hogy meg fog oldani egy problémát, megmutathat egy ígéretet. Azt még nem mutathatja meg, hogy az ügyfél elfogadta a későbbi megoldást, ha nincs jelen ügyfélválasz. A hiányzó bizonyítékot jelző eredményt ismeretlenként kezelje, ne alakítsa nincs jelen értékké. Az előfordulás alacsony valószínűsége nem automatikusan erős bizonyíték a hiányra, ha az eloszlás jelentős része a nem megfigyelhető állapothoz tartozik.
A viselkedésdefiníciók pontozása egy menetben
A Respan a Span-01-et olyan következtető osztályozóként írja le, amelyet először RLAIF-fel általános osztályozásra tanítottak, majd viselkedésfelismerésre specializáltak. Minden definíció ugyanazon nyom fölött párhuzamos ágként fut, és a modell egyetlen előrecsatolási menetben adja vissza a viselkedési valószínűségeket. A hibrid figyelmi mechanizmus támogatja a hosszú, összetett nyomok kezelését. Nem generál tokeneket, nem ír elbeszélő értékelést, és nem ad szabad szöveges magyarázatot a besorolásáról.
A fogalmi útmutató és a pontozási referencia nem dokumentál kérésenkénti viselkedésszám-korlátot. Minden definíció továbbra is a megadott értékelés része, ezért mindegyik legyen világos és releváns, ne tekintse a darabszámkorlát hiányát korlátlan bemeneti kapacitás bizonyítékának. Az eredmény viselkedésenként egy bejegyzést tartalmaz a kérés sorrendjében, az id alapján azonosítva. A több definíció több független megfigyelést ír le; nem egymást kizáró kategóriaválasztások, amelyek értékeinek a viselkedések között egyre kell összeadódniuk.
Hasznos értékelési eredmény előkészítése
A visszaadott valószínűségeket a modellen kívül kombinálja feladatspecifikus küszöbökkel és ellenőrzési szabályokkal. A gyártó címkézett beszélgetések használatát ajánlja e küszöbök kiválasztásához, valamint a határesetnek számító jelenléti és a magas nem megfigyelhető eredmények vizsgálatát. Egy ügyfélszolgálati munkafolyamat külön rögzítheti a frusztrációt, a javasolt eszkalációt és a megalapozatlan ígéretet. Egy ügynökminőségi munkafolyamat követheti az ismétlődő műveleteket, vagy azt, hogy egy válasz használta-e a számára elérhetővé tett bizonyítékot.
A szövegszakaszt, a viselkedésdefiníciót, az eredményazonosítót és a teljes háromágú eloszlást együtt őrizze meg. Ha a definíció megváltozik, vegye figyelembe, hogy ezzel az is megváltozik, mit mér a valószínűség. A látszólagos hibákat a tényleges beszélgetés alapján ellenőrizze, ne tekintse a számszerű eredményt nem megfigyelt esemény bizonyítékának. A hasznos eredmény a nyomhoz és a kritériumhoz kötött viselkedésrekord, amely megőrzi a bizonytalanságot későbbi vizsgálatra vagy az alkalmazás következő döntéséhez.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Kezdő lépések
A Span-01 a Respan szöveges viselkedésosztályozója beszélgetésekhez és ügynöknyomokhoz. Köznyelven határozza meg a viselkedéseket, és a modell mindegyikhez három valószínűséget ad vissza: jelen van, nincs jelen és nem megfigyelhető. Így megőrzi a bizonytalanságot, ha a megadott nyom nem dönti el a kérdést.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- decisions
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · System One POST /v1/systemone
- Bemenet
text- Kimenet
decisions- Kimeneti formátum
- json
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok respan/span-01 | Alapértelmezett— |
Mezőprovider | Típusschema | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőquestions | Típusobject | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezősession_id | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőstate | Típusschema | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőtrace | Típusschema | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőuser | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőquestions.<id>.type | Típusstring | KövetelményKötelező | Értékek és korlátok noul, choice, score | Alapértelmezett— |
Mezőquestions.<id>.instructions | Típusstring|object|array | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőquestions.<id>.criteria | Típusobject|array | KövetelményOpcionális | Értékek és korlátok Feltételek: choice/score: kötelező; noul: opcionális. A choice feltételei objektumot alkotnak; a score tömb, minItems1 megkötéssel. | Alapértelmezett— |
Mezőquestions.<id>.criteria.true | Típusstring|object|array | KövetelményKötelező | Értékek és korlátok Akkor alkalmazandó, ha: noul feltételobjektum megadva | Alapértelmezett— |
Mezőquestions.<id>.criteria.false | Típusstring|object|array | KövetelményKötelező | Értékek és korlátok Akkor alkalmazandó, ha: noul feltételobjektum megadva | Alapértelmezett— |
Bemeneti anyagok kombinációi
noul · Kötelező: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Kötelező: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Kötelező: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, state, questions |
Paramétermaterial_types | Szerződéstext |
Paraméteroptional_controls | Szerződésprovider, session_id, trace, user |
Paramétermultimodal_input_binding | Szerződésnull |
Életciklus: synchronous
Küldje el a pontos modellazonosítót, és őrizze meg a teljes natív választ.
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj |
|---|---|---|---|---|
| BeállításTokenenkénti alapárak | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.00004 / 1K token Kimenet · Kimeneti tokenek $0 / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.00004 / 1K token Kimenet · Kimeneti tokenek $0 / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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
Eredmények fogadása és mentése
Ailoot Ultra · System One
json
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Minden megadott kérdésazonosítóhoz tartozó válasz megmarad a pontos típusával, noul/choice/score értékével, megbízhatóságával, valószínűségeivel és jelmagyarázatával együtt. A teljes eredeti JSON tárolásra kerül, és csak az elszámolás után adható vissza.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti műveletet és a teljes vagy részleges választ; ne ismételje meg a POST kérést.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőmodel | Típusstring |
Mezőid | Típusstring |
Mezőprovider | Típusstring |
Mezőanswers.<id>.type | Típusstring |
Mezőanswers.<id>.noul | Típusnumber |
Mezőanswers.<id>.choice | Típusstring |
Mezőanswers.<id>.score | Típusnumber |
Mezőanswers.<id>.confidence | Típusnumber |
Mezőanswers.<id>.probabilities | Típusobject |
Mezőanswers.<id>.legend | Típusobject |
Mezőusage.input_tokens | Típusinteger |
Mezőusage.output_tokens | Típusinteger |
Mezőusage.cost | Típusnumber |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mező, megadási forma vagy érték | Következő lépésJavítsa a kérés megjelölt mezőjét. |
Álnevek
Modell álnevei
Ailoot Ultra respan/span-01
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Respan: Span-01
- Milyen bemenetek és eredmények érhetők el?
POST /v1/systemone·respan/span-01:text→decisions- Mely mezőket használja a kérés?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user