Nace.AI: Drex v1.5
Drex 1.5 įvertina pateiktą tekstą ar JSON pagal tipizuotus klausimus ir grąžina tikimybes, pasirinktą žymę arba trupmeninį vertinimo skalės balą. Nace.AI dokumentuoja tik tekstinius sprendimus klasifikavimui, nukreipimui ir prioritetų nustatymui, su konkrečiai versijai būdingais būsenos ir užklausos limitais.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Drex 1.5 – Nace.AI tekstinių sprendimų modelis. Jis įvertina pateiktus faktus pagal uždarus klausimus ir grąžina skaitinius, tipizuotus atsakymus, o ne atvirą rašytinį atsakymą. Užklausoje viena būsena derinama su pavadintais klausimais, o rezultate kiekvienas atsakymas identifikuojamas tuo pačiu klausimo pavadinimu. Taip darbo eiga gauna konkrečią kategoriją, tikimybę ar padėtį vertinimo skalėje, o veiksmą pagal tą rezultatą palieka spręsti programai.
Būsenos paruošimas
Būsena – tai informacija, su kuria susiję visi klausimai. Drex priima JSON eilutę, objektą, masyvą, skaičių, loginę reikšmę arba null, o būsenos laukas yra privalomas. Pateikite prasmingus įrodymus, nors null ir praeina gamintojo patikrą. Eilutė tinka pranešimui, dokumentui ar transkripcijai; objektas tinka faktams, jau sutvarkytiems į laukus. Išsaugokite informaciją, kuri turi įtakos sprendimui, o kai medžiaga ilga, praleiskite nesusijusius laukus. Interpretuodami tikimybių slenksčius, išlaikykite stabilų įvesties formatą, nes pakeitus pateikimo būdą gali pasikeisti ir atsakymas.
Drex 1.5 skaito tik tekstą. Dokumentuota sąsaja atmeta vaizdus, garsą, vaizdo įrašus ir PDF turinį tiek būsenoje, tiek klausimuose, įskaitant užkoduotą mediją ir medijos turinio objektus. Prieš naudodami tokią medžiagą kaip įrodymą, paruoškite aprašą, atpažintą dokumento tekstą arba transkripciją. Tekstinis adresas nėra atsiųstas dokumentas ar vaizdas: modelis negali jo atidaryti. Pagalbos užklausos atveju naudinga būsena yra tikrasis pranešimas ir susijęs kontekstas, o ne nuoroda į medžiagą, kurios modelis negavo.
„Taip / ne“ tikimybė, pasirinkimas arba balas
Tipo noul klausimu klausiama, ar sąlyga tenkinama, ir grąžinamas skaičius nuo 0 iki 1, išreiškiantis įvertintą atsakymo „taip“ tikimybę. Klausimą apibrėžkite netuščiomis instrukcijomis arba bent vienu netuščiu „tiesa / netiesa“ kriterijumi. Pavyzdžiui, paklauskite, ar pranešime nurodoma neveikianti funkcija, ir apibrėžkite, ar lėtas veikimas laikomas gedimu. Drex netaiko įdiegtos „taip / ne“ ribos; rezultatą naudojanti darbo eiga pati pasirenka, kaip interpretuoti tikimybę.
Pasirinkimo klausimas iš nesurikiuoto rinkinio parenka vieną pateiktą žymę ir grąžina kiekvienos žymės tikimybę. Kriterijai yra objektas, kurio raktai yra grąžinamos žymės, o kiekvienas aprašymas yra eilutė arba null. Naudokite trumpus, stabilius raktus ir aiškiai aprašykite kategorijų ribas. Pavyzdinėje nukreipimo užduotyje galima atskirti prieigos problemą, produkto defektą ir bendrą klausimą, pridedant kategoriją „kita“ netinkantiems pranešimams. Pasirinkta žymė naudinga nukreipimui; skirstinys padeda nustatyti atvejus, kai dvi parinktis sunku atskirti.
Balo klausimas naudoja surikiuotą lygių žymių masyvą. Indeksai prasideda nuo 0, o grąžinamas balas yra kiekvieno lygio indekso ir jo tikimybės sandaugų suma. Todėl jis gali patekti tarp pavadintų lygių. Rimtumo skalėje apibrėžkite, kuo skiriasi kosmetinė problema, problema, kurią galima apeiti, ir visiškai užblokuota užduotis. Rezultate pateikiama lygių legenda ir tikimybės, taip pat tikėtinas balas. Trupmeninį balą naudokite vidurkiams ar tendencijoms; labiausiai tikėtino lygio pasirinkimas ir tikėtino balo apvalinimas atsako į skirtingus klausimus.
Bendri įrodymai ir rezultato skaitymas
Gamintojas leidžia pateikti nuo vieno iki 512 klausimų apie tą pačią būseną. Kiekvienam suteikite netuščią, prasmingą identifikatorių, pavyzdžiui, category ar severity, kad atitinkamą atsakymą būtų galima suprasti neieškant sunumeruoto klausimo. Nepriklausomus aspektus pateikite atskirais klausimais, užuot sujungę kelis reikalavimus į vieną neaiškų kriterijų. Vienas pranešimas gali būti pagrindas kategorijos pasirinkimui, rimtumo balui ir sąlygos patikrai, kurių kiekvienas išlaiko savo reikšmę.
Pasirinkimo ir balo atsakymuose pasitikėjimas pateikiamas atskirai nuo tikimybių skirstinių. Gamintojas aiškiai atskiria pasitikėjimą nuo didžiausios parinkties tikimybės; neapskaičiuokite vieno iš kito. „Taip / ne“ sprendimui išsaugokite neapdorotą tikimybę kartu su pasirinkta baigtimi. Esant neužtikrintam pasirinkimui, išnagrinėkite konkuruojančias tikimybes, užuot laikę vien laiminčią žymę tikrumo įrodymu. Peržiūros slenksčius nustatykite atsižvelgdami į klaidingai teigiamo ar klaidingai neigiamo rezultato pasekmes ir įvertinkite juos reprezentatyviais pažymėtais atvejais.
Versijos ir dydžio limitai
Drex 1.5 dokumentuoja 131 072 žetonų būsenos limitą ir 139 264 žetonų eilutės limitą. Eilutės limitas apima būseną ir ilgiausią atskirą klausimą su jo instrukcijomis ir parinktimis; tai nėra visų užklausos klausimų suma. Be to, serializuota būsena ir klausimai kartu turi tilpti į 1 048 576 UTF-8 baitus. Užklausa gali atitikti baitų limitą, bet vis tiek viršyti žetonų limitą. Senesniame 1.0 leidime atskirai nurodyta 32 768 žetonai ir būsenai, ir eilutei, todėl jo limitų nereikėtų perkelti į 1.5.
Nace dokumentuoja drex-v1.5 kaip versijuotą gamintojo identifikatorių, o drex-latest yra kintantis pseudonimas. Kai darbo eiga priklauso nuo leidimo limitų, numatytą leidimą nurodykite aiškiai. Netaisyklingai suformuotas klausimas, trūkstama būsena ar per didelė įvestis yra patikros problema, kuriai reikia pataisytos įvesties, o ne pakeistos kategorijos ar spėjamo atsakymo. Kriterijus ruoškite remdamiesi stebimais įrodymais, o tipizuotą rezultatą, pradinius faktus ir klausimo apibrėžimą laikykite kartu. Tada sprendimą galima naudoti nukreipimui, prioritetų nustatymui ar peržiūrai, nepainiojant tikimybės su garantuotu verdiktu.
Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5
nace-ai/drex-v1.5Pradžia
Drex 1.5 įvertina pateiktą tekstą ar JSON pagal tipizuotus klausimus ir grąžina tikimybes, pasirinktą žymę arba trupmeninį vertinimo skalės balą. Nace.AI dokumentuoja tik tekstinius sprendimus klasifikavimui, nukreipimui ir prioritetų nustatymui, su konkrečiai versijai būdingais būsenos ir užklausos limitais.
- Leidžiamos įvestys
- Tekstas
- Rezultatai
- decisions
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · System One POST /v1/systemone
- Įvestis
text- Išvestis
decisions- Išvesties formatas
- json
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos nace-ai/drex-v1.5 | Numatyta— |
Laukasprovider | Tipasschema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquestions | Tipasobject | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasstate | Tipasschema | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukastrace | Tipasschema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquestions.<id>.type | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos noul, choice, score | Numatyta— |
Laukasquestions.<id>.instructions | Tipasstring|object|array | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquestions.<id>.criteria | Tipasobject|array | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: choice/score: privalomi; noul: neprivalomas. choice kriterijai yra objektas; score yra masyvas su minItems1. | Numatyta— |
Laukasquestions.<id>.criteria.true | Tipasstring|object|array | ReikalavimasPrivaloma | Reikšmės ir ribos Taikoma, kai: Pateiktas noul kriterijų objektas | Numatyta— |
Laukasquestions.<id>.criteria.false | Tipasstring|object|array | ReikalavimasPrivaloma | Reikšmės ir ribos Taikoma, kai: Pateiktas noul kriterijų objektas | Numatyta— |
Įvesties medžiagos deriniai
noul · Privaloma: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Privaloma: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Privaloma: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, state, questions |
Parametrasmaterial_types | Specifikacijatext |
Parametrasoptional_controls | Specifikacijaprovider, session_id, trace, user |
Parametrasmultimodal_input_binding | Specifikacijanull |
Gyvavimo ciklas: synchronous
Siųskite tikslų modelio ID ir išsaugokite visą pirminį atsakymą.
Planai
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Ailoot įkainiai
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Konteksto tokenų daugiau nei | Konteksto tokenų iki imtinai | Mokestis |
|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Konteksto tokenų daugiau nei— | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0.00008 / 1K tokenų Išvestis · Išvesties tokenai $0 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
| KonfigūracijaUžklausos ilgio pakopa 1 | Įkainių lentelė— | Konteksto tokenų daugiau nei0 | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0.00008 / 1K tokenų Išvestis · Išvesties tokenai $0 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
Ailoot Ultra · System One
{
"model": "nace-ai/drex-v1.5",
"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']='nace-ai/drex-v1.5'
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · System One
json
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.
Išsaugomas kiekvienas pateiktas atsakymas pagal klausimo ID su tiksliu tipu, noul/choice/score reikšme, pasikliovimo lygiu, tikimybėmis ir legenda. Visas pradinis JSON saugomas ir grąžinamas tik atsiskaičius.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite pradinę operaciją ir visą arba dalinį atsakymą; nekartokite POST.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukasmodel | Tipasstring |
Laukasid | Tipasstring |
Laukasprovider | Tipasstring |
Laukasanswers.<id>.type | Tipasstring |
Laukasanswers.<id>.noul | Tipasnumber |
Laukasanswers.<id>.choice | Tipasstring |
Laukasanswers.<id>.score | Tipasnumber |
Laukasanswers.<id>.confidence | Tipasnumber |
Laukasanswers.<id>.probabilities | Tipasobject |
Laukasanswers.<id>.legend | Tipasobject |
Laukasusage.input_tokens | Tipasinteger |
Laukasusage.output_tokens | Tipasinteger |
Laukasusage.cost | Tipasnumber |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNegaliojantis privalomas laukas, pateikimo forma arba reikšmė | Kitas žingsnisPataisykite nurodytą užklausos lauką. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra nace-ai/drex-v1.5
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Nace.AI: Drex v1.5
- Kokios įvestys ir rezultatai prieinami?
POST /v1/systemone·nace-ai/drex-v1.5:text→decisions- Kokius laukus naudoja užklausa?
POST /v1/systemone·nace-ai/drex-v1.5:model,provider,questions,session_id,state,trace,user