Inception: Mercury Decide (free)
Mercury Decide arvioi yhteistä teksti- tai JSON-evidenssiä nimettyjen kysymysten perusteella ja palauttaa tyypitettyjä valintoja, kyllä/ei-todennäköisyyksiä tai arviointiasteikon desimaalisia pistemääriä. Inception dokumentoi erillisen päätöstyönkulun, jossa on enintään 255 Choice-vaihtoehtoa ja kymmenen Score-tasoa.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Mercury Decide on Inceptionin malli rakenteisiin päätöksiin annetusta evidenssistä. Se yhdistää yhteisen tilan nimettyihin kysymyksiin ja palauttaa tyypitetyt vastaukset todennäköisyyksineen. Tulos voi olla valittu luokka, arvioitu kyllä/ei-todennäköisyys tai sijainti määritellyllä asteikolla. Tämä profiili antaa rajatun päätöksen, jota ohjelmisto voi tulkita; sen dokumentoitu rajapinta ei tuota vapaamuotoista keskusteluvastausta.
Yhteinen tila ja merkitykselliset kysymysnimet
Valmistajan pyyntö sisältää mallin, tilan ja ei-tyhjän kysymysten avain–arvo-rakenteen. Kysymysten nimet säilyvät vastausten avain–arvo-rakenteessa. Anna kunkin kysymyksen arviointiin tarvittavat tiedot ja nimeä kysymykset työnkulun käyttämien tulosten mukaan, esimerkiksi category, priority tai needs_follow_up. Useat kysymykset arvioivat samaa evidenssiä riippumattomasti. Niiden sijoittaminen samaan pyyntöön ei tee myöhemmästä kysymyksestä riippuvaista aiemmasta vastauksesta.
Inceptionin esimerkki käyttää tilana JSON-objektia. Opas sallii tilassa, ohjeissa ja kriteerikuvauksissa myös merkkijonot, objektit tai taulukot, ja ohjeet ovat valinnaisia tai voivat olla null. Säilytä hyödyllinen rakenne, kun evidenssi koostuu jo kentistä, ja pidä asiakirja tai viesti tunnistettavana tekstiä annettaessa. Sisällytä tukitapaukseen todellinen pyyntö ja olennaiset tosiseikat sen sijaan, että pyytäisit päättelemään puuttuvan kontekstin.
Noul: arvioitu myönteinen vastaus
noul-kysymys esittää kyllä/ei-ehdon. Sen tulos on todennäköisyys väliltä 0–1 sille, että myönteinen vastaus soveltuu. Valinnaiset true- ja false-kuvaukset voivat täsmentää, mikä lasketaan kysymyksen kummallekin puolelle. Kysy esimerkiksi, pyytääkö viesti nimenomaisesti korvaavaa tuotetta, ja erota se yleisestä tuotetta koskevasta valituksesta. Todennäköisyys antaa numeerisen arvion; sovellus valitsee kynnysarvon ja siitä seuraavan työnkulun toimenpiteen.
Pidä ehto riittävän tarkkana, jotta evidenssi voi ratkaista sen. Jos yksi kysymys yhdistää sen, haluaako käyttäjä apua, onko tuote viallinen ja onko tapaus kiireellinen, erota nämä ehdot toisistaan. Säilytä palautettu todennäköisyys kysymysmääritelmän yhteydessä, jotta myöhempi tarkastaja voi nähdä, mitä luku todella mittaa.
Choice: yhden nimetyn vaihtoehdon valinta
Choice-kysymys käyttää 1–255 vaihtoehtonimen ja kuvauksen avain–arvo-rakennetta; kuvaukset voivat olla null. Palautettu valinta on annetuista vaihtoehdoista todennäköisin. Tulos sisältää myös jokaisen vaihtoehdon todennäköisyyden ja luottamusarvon. Määrittele luokille erilliset merkitykset ja sisällytä varaluokka, kun osa syötteistä jää täsmällisten vaihtoehtojen ulkopuolelle. Lyhyet tulosavaimet voivat yksilöidä luokat, ja täydemmät kuvaukset määrittävät niiden väliset rajat.
Reitityksen tehtävänanto voi erottaa pääsyongelman, tuotekysymyksen ja ilmoitetun vian. Ilmoita kunkin vaihtoehdon merkitys ja anna reititettävä viesti. Tulos on valittu luokka jakaumineen, ei ohje, joka olisi jo muuttanut jonoa tai ottanut yhteyttä toiseen järjestelmään. Tutki kilpailevia todennäköisyyksiä monitulkintaisissa tapauksissa sen sijaan, että tulkitsisit voittavan tunnuksen osoitukseksi varmuudesta.
Score: odotettu sijainti arviointiasteikolla
Score-kysymys käyttää järjestettyä 1–10 tasokuvauksen taulukkoa, joka alkaa tasosta 0. Sen pistemäärä on tasoindeksien todennäköisyyksillä painotettu keskiarvo ja voi jäädä tasojen väliin. Vastaus sisältää selitteen, tasokohtaiset todennäköisyydet ja luottamusarvon. Määrittele järjestys ja kunkin tason kriteerit, kuten ei välitöntä vaikutusta, ongelma toimivalla vaihtoehtoisella ratkaisulla ja täysin estynyt tehtävä.
Desimaalinen odotettu pistemäärä on hyödyllinen priorisoinnissa tai aggregoinnissa. Se eroaa yhden todennäköisimmän tason valitsemisesta. Säilytä selite luvun yhteydessä, jotta pistemäärää ei tulkita toisen asteikon mukaan. Choice- ja Score-luottamusarvo ilmoitetaan erikseen väliltä 0–1; kyseinen opas ei määrittele sitä samaksi kuin suurin vaihtoehtotodennäköisyys eikä anna yleispätevää kaavaa sen muodostamiseen uudelleen.
Hyödyllisen päätöstuloksen valmistelu
Yksi evidenssiaineisto voi tukea riippumattomia luokka-, kiireellisyys- ja ehtokysymyksiä. Asiakirjan tarkastelutehtävä voi kysyä, esiintyykö vaadittu aihe, valita sen luokan ja arvioida sen relevanssia kuvatuilla tasoilla. Käytä vain tilassa saatavilla olevaa lähdemateriaalia ja sido kriteerit työnkulun seuraavaksi tarvitsemaan päätökseen. Jos toimenpide tarvitsee aiemman tuloksen, ilmaise tulos seuraavan vaiheen evidenssissä sen sijaan, että olettaisit kysymysten muodostavan piilossa olevan ketjun.
Vastaus palauttaa mallin nimen ja answers-rakenteen, jonka avaimina ovat annetut kysymysnimet. Choice-todennäköisyydet käyttävät vaihtoehtojen nimiä; Score-todennäköisyydet käyttävät merkkijonomuotoisia indeksejä, jotka selite selittää. Säilytä tilatunniste, kysymysmääritelmät ja tyypitetyt vastaukset yhteydessä toisiinsa. Näin syntyy tulkittava luokittelu- tai arviointituotos eikä luku, joka on irrallaan sen tuottaneista tosiseikoista.
Rajapinnan soveltamisala ja rajat
Inception dokumentoi Mercury Deciden erillisen päätösrajapintansa kautta. Se ei tue valmistajan chat-completion-, suoratoisto- tai työkalukutsurajapintoja, joten Mercuryn päättely-, ääni- ja koodintuottoprofiilien kykyjä ei pidä siirtää tähän malliin. Päätösopas määrittelee vaihtoehtojen ja tasojen määrät mutta ei anna tilan numeerista tokenrajaa tai kysymysmäärän ylärajaa; kohdista yhteinen evidenssi arvioitaviin kysymyksiin.
Arvioi todennäköisyyksiä ja luokkarajoja tarkoitetun tehtävän edustavalla merkityllä materiaalilla. Tarkastele rajatapauksia tilan perusteella ja säilytä puuttuva tieto puuttuvana sen sijaan, että korvaisit sen keksityillä tosiseikoilla. Hyödyllinen Mercury Decide -tulos antaa suljetun päätöksen, sen todennäköisyydet ja sen ymmärtämiseen tarvittavat määritelmät; ympäröivä sovellus määrittää, miten tuloksesta tulee reititystä, priorisointia tai tarkastelun lopputulos.
Ailoot Ultra · System One POST /v1/systemone inception/mercury-decide:free
inception/mercury-decide:freeAloitus
Mercury Decide arvioi yhteistä teksti- tai JSON-evidenssiä nimettyjen kysymysten perusteella ja palauttaa tyypitettyjä valintoja, kyllä/ei-todennäköisyyksiä tai arviointiasteikon desimaalisia pistemääriä. Inception dokumentoi erillisen päätöstyönkulun, jossa on enintään 255 Choice-vaihtoehtoa ja kymmenen Score-tasoa.
- 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 inception/mercury-decide:free | 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 / 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 / 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": "inception/mercury-decide:free",
"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']='inception/mercury-decide:free'
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 inception/mercury-decide:free
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · Inception: Mercury Decide (free)
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/systemone·inception/mercury-decide:free:text→decisions- Mitä kenttiä pyyntö käyttää?
POST /v1/systemone·inception/mercury-decide:free:model,provider,questions,session_id,state,trace,user