Nace.AI: Drex v1.5
Drex 1.5 arvioi annettua tekstiä tai JSON-dataa tyypitettyjen kysymysten perusteella ja palauttaa todennäköisyyksiä, valitun luokkatunnuksen tai arviointiasteikon desimaalisen pistemäärän. Nace.AI dokumentoi vain tekstiin perustuvat päätökset luokitteluun, reititykseen ja priorisointiin sekä versiokohtaiset tila- ja pyyntörajat.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Drex 1.5 on Nace.AI:n tekstipohjainen päätösmalli. Se arvioi annettuja tosiseikkoja suljettujen kysymysten perusteella ja palauttaa numeerisia, tyypitettyjä vastauksia avoimen kirjallisen vastauksen sijaan. Pyyntö yhdistää yhden tilan nimettyihin kysymyksiin, ja tulos yksilöi jokaisen vastauksen samalla kysymysnimellä. Näin työnkulku saa käytettäväkseen konkreettisen luokan, todennäköisyyden tai sijainnin arviointiasteikolla, mutta tuloksen perusteella tehtävä toimenpide jää sovellukselle.
Tilan valmistelu
Tila on tieto, jota kaikki kysymykset koskevat. Drex hyväksyy JSON-merkkijonon, objektin, taulukon, luvun, totuusarvon tai null-arvon, ja state-kenttä on pakollinen. Anna merkityksellistä evidenssiä, vaikka null läpäiseekin valmistajan validoinnin. Merkkijono sopii viestille, asiakirjalle tai litteroinnille; objekti sopii jo kenttiin järjestetyille tosiseikoille. Säilytä päätökseen vaikuttavat tiedot ja jätä epäolennaiset kentät pois, kun materiaali on pitkä. Pidä syötemuoto vakaana todennäköisyyskynnyksiä tulkittaessa, koska esitysmuodon muuttaminen voi muuttaa vastausta.
Drex 1.5 lukee vain tekstiä. Dokumentoitu rajapinta hylkää kuvat, äänen, videon ja PDF-sisällön sekä tilassa että kysymyksissä, mukaan lukien koodatun median ja mediasisältöobjektit. Valmistele kuvateksti, tunnistettu asiakirjateksti tai litterointi ennen kyseisen materiaalin käyttöä evidenssinä. Tekstimuotoinen osoite ei ole noudettu asiakirja tai kuva: malli ei voi avata sitä. Tukipyynnön hyödyllinen tila on todellinen viesti ja olennainen konteksti, ei viittaus materiaaliin, jota malli ei ole vastaanottanut.
Kyllä/ei-todennäköisyys, valinta tai pistemäärä
noul-kysymys kysyy, täyttyykö ehto, ja palauttaa luvun väliltä 0–1 kuvaamaan arvioitua kyllä-vastauksen todennäköisyyttä. Määrittele kysymys ei-tyhjillä ohjeilla tai vähintään yhdellä ei-tyhjällä tosi/epätosi-kriteerillä. Kysy esimerkiksi, ilmoittaako viesti rikkoutuneesta toiminnosta, ja määrittele, lasketaanko hitaus rikkoutumiseksi. Drex ei aseta sisäänrakennettua kyllä/ei-kynnystä; tulosta käyttävä työnkulku valitsee todennäköisyyden tulkinnan.
choice-kysymys valitsee yhden annetun luokkatunnuksen järjestämättömästä joukosta ja palauttaa todennäköisyyden jokaiselle tunnukselle. Kriteerit ovat objekti, jonka avaimet ovat palautettavia tunnuksia ja jonka kuvaukset ovat merkkijonoja tai null-arvoja. Käytä lyhyitä, vakaita avaimia ja kuvaa luokkarajat selkeästi. Esimerkkireititystehtävä voi erottaa pääsyongelman, tuotevian ja yleisen kysymyksen sekä sisältää other-luokan viesteille, jotka eivät sovellu niihin. Valittu tunnus on hyödyllinen reitityksessä; jakauma auttaa tunnistamaan tapaukset, joissa kahta vaihtoehtoa on edelleen vaikea erottaa.
score-kysymys käyttää järjestettyä tasotunnusten taulukkoa. Indeksit alkavat nollasta, ja palautettu pistemäärä on kunkin tasoindeksin ja sen todennäköisyyden tulojen summa. Se voi siis jäädä nimettyjen tasojen väliin. Määrittele vakavuusasteikolle, mikä erottaa kosmeettisen ongelman, kiertotavalla ratkaistavan ongelman ja täysin estyneen tehtävän. Tulos sisältää tasoselitteen ja todennäköisyydet odotetun pistemäärän lisäksi. Säilytä desimaalinen pistemäärä keskiarvoja tai trendejä varten; todennäköisimmän tason valitseminen ja odotetun pistemäärän pyöristäminen vastaavat eri kysymyksiin.
Yhteinen evidenssi ja tuloksen lukeminen
Valmistaja sallii 1–512 kysymystä samasta tilasta. Anna jokaiselle ei-tyhjä, merkityksellinen tunniste, kuten category tai severity, jotta vastaus on ymmärrettävä ilman numeroidun kysymyksen hakemista. Erota riippumattomat asiat omiksi kysymyksikseen sen sijaan, että yhdistäisit useita vaatimuksia yhdeksi epäselväksi kriteeriksi. Yksi viesti voi tukea luokkavalintaa, vakavuuspistemäärää ja ehdon tarkistusta niin, että kukin säilyttää oman merkityksensä.
choice- ja score-vastaukset sisältävät luottamusarvon erillään todennäköisyysjakaumistaan. Valmistaja erottaa luottamusarvon nimenomaisesti suurimmasta vaihtoehtotodennäköisyydestä; älä laske toista toisesta. Säilytä kyllä/ei-päätöksessä raakamuotoinen todennäköisyys valitun lopputuloksen yhteydessä. Tarkastele epävarmassa valinnassa kilpailevia todennäköisyyksiä sen sijaan, että pitäisit pelkkää voittavaa tunnusta osoituksena varmuudesta. Määrittele tarkastelukynnykset väärän positiivisen tai negatiivisen tuloksen seurausten perusteella ja arvioi niitä edustavilla merkityillä tapauksilla.
Versio ja kokorajat
Drex 1.5 dokumentoi tilalle 131 072 tokenin rajan ja riville 139 264 tokenin rajan. Riviraja koskee tilaa sekä pisintä yksittäistä kysymystä ohjeineen ja vaihtoehtoineen; se ei ole pyynnön kaikkien kysymysten summa. Sarjallistettujen tilan ja kysymysten on yhdessä mahduttava myös 1 048 576 UTF-8-tavuun. Pyyntö voi täyttää tavurajan ja silti ylittää tokenrajan. Vanhempi 1.0-versio ilmoittaa erikseen sekä tilalle että riville 32 768 tokenin rajan, joten sen rajoja ei pidä siirtää versioon 1.5.
Nace dokumentoi drex-v1.5:n versioituna valmistajatunnisteena, kun taas drex-latest on muuttuva alias. Ilmaise tarkoitettu versio selvästi, kun työnkulku riippuu sen rajoista. Virheellisesti muodostettu kysymys, puuttuva tila tai liian suuri syöte on validointiongelma, joka tarvitsee korjatun syötteen luokan muuttamisen tai vastauksen arvaamisen sijaan. Valmistele kriteerit havaittavan evidenssin perusteella ja säilytä tyypitetty tulos, alkuperäiset tosiseikat ja kysymysmääritelmä yhdessä. Näin päätöstä voi käyttää reititykseen, priorisointiin tai tarkasteluun sekoittamatta todennäköisyyttä taattuun ratkaisuun.
Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5
nace-ai/drex-v1.5Aloitus
Drex 1.5 arvioi annettua tekstiä tai JSON-dataa tyypitettyjen kysymysten perusteella ja palauttaa todennäköisyyksiä, valitun luokkatunnuksen tai arviointiasteikon desimaalisen pistemäärän. Nace.AI dokumentoi vain tekstiin perustuvat päätökset luokitteluun, reititykseen ja priorisointiin sekä versiokohtaiset tila- ja pyyntörajat.
- Hyväksytyt syötteet
- Teksti
- Tulokset
- decisions
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · System One POST /v1/systemone
- Syötetyypit
text- Tulostyypit
decisions- Tulosteen muoto
- json
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat nace-ai/drex-v1.5 | Oletus— |
Kenttäprovider | Tyyppischema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäquestions | Tyyppiobject | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäsession_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttästate | Tyyppischema | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttätrace | Tyyppischema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäuser | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäquestions.<id>.type | Tyyppistring | VaatimusPakollinen | Arvot & rajat noul, choice, score | Oletus— |
Kenttäquestions.<id>.instructions | Tyyppistring|object|array | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäquestions.<id>.criteria | Tyyppiobject|array | VaatimusValinnainen | Arvot & rajat Ehdot: choice/score: pakollinen; noul: valinnainen. choice-kriteerit ovat olio; score on taulukko, jossa minItems on 1. | Oletus— |
Kenttäquestions.<id>.criteria.true | Tyyppistring|object|array | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: noul-kriteeriolio annettu | Oletus— |
Kenttäquestions.<id>.criteria.false | Tyyppistring|object|array | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: noul-kriteeriolio annettu | Oletus— |
Syöteaineistojen yhdistelmät
noul · Pakollinen: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Pakollinen: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Pakollinen: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, state, questions |
Parametrimaterial_types | Sopimustext |
Parametrioptional_controls | Sopimusprovider, session_id, trace, user |
Parametrimultimodal_input_binding | Sopimusnull |
Elinkaari: synchronous
Lähetä täsmällinen mallin tunniste ja säilytä koko natiivivastaus.
Hinnoittelu
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Ailoot-hinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.00008 / 1K tokenia Tuloste · Tulostokenit $0 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.00008 / 1K tokenia Tuloste · Tulostokenit $0 / 1K tokenia Syöte · Välimuistin luku — / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Esimerkkipyynnöt
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
Vastaanota ja tallenna tulokset
Ailoot Ultra · System One
json
Säilytä kaikki valmistuneet tulokset
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Jokainen annettu kysymystunnisteeseen sidottu vastaus säilytetään täsmällisine tyyppeineen, noul/choice/score-arvoineen, luottamusarvoineen, todennäköisyyksineen ja selitteineen. Koko alkuperäinen JSON tallennetaan ja palautetaan vasta veloituksen lopullisen kirjauksen jälkeen.
Jos alkuperäinen vastaus on tarkistettava
Säilytä alkuperäinen operaatio ja kokonainen tai osittainen vastaus; älä toista POST-pyyntöä.
Vastauksen kentät
| Kenttä | Tyyppi |
|---|---|
Kenttämodel | Tyyppistring |
Kenttäid | Tyyppistring |
Kenttäprovider | Tyyppistring |
Kenttäanswers.<id>.type | Tyyppistring |
Kenttäanswers.<id>.noul | Tyyppinumber |
Kenttäanswers.<id>.choice | Tyyppistring |
Kenttäanswers.<id>.score | Tyyppinumber |
Kenttäanswers.<id>.confidence | Tyyppinumber |
Kenttäanswers.<id>.probabilities | Tyyppiobject |
Kenttäanswers.<id>.legend | Tyyppiobject |
Kenttäusage.input_tokens | Tyyppiinteger |
Kenttäusage.output_tokens | Tyyppiinteger |
Kenttäusage.cost | Tyyppinumber |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheellinen pakollinen kenttä, esitysmuoto tai arvo | Seuraava vaiheKorjaa ilmoitettu pyyntökenttä. |
Aliakset
Mallin aliakset
Ailoot Ultra nace-ai/drex-v1.5
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · Nace.AI: Drex v1.5
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/systemone·nace-ai/drex-v1.5:text→decisions- Mitä kenttiä pyyntö käyttää?
POST /v1/systemone·nace-ai/drex-v1.5:model,provider,questions,session_id,state,trace,user