Inception: Mercury Decide (free)
Mercury Decide vyhodnocuje spoločné podklady v podobe textu alebo JSON vzhľadom na pomenované otázky a vracia typované výbery, pravdepodobnosti áno/nie alebo neceločíselné skóre podľa hodnotiacej stupnice. Inception dokumentuje vyhradený rozhodovací postup s najviac 255 možnosťami pre Choice a najviac desiatimi úrovňami pre Score.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Mercury Decide je model od Inception na štruktúrované rozhodnutia nad dodanými podkladmi. Spája zdieľaný stav s pomenovanými otázkami a vracia typované odpovede s pravdepodobnosťami. Výsledkom môže byť zvolená kategória, odhadnutá pravdepodobnosť áno/nie alebo pozícia na definovanej stupnici. Tento profil slúži na ohraničené rozhodnutie, ktoré dokáže softvér interpretovať; jeho zdokumentované rozhranie negeneruje voľnú odpoveď v chate.
Zdieľaný stav a zmysluplné názvy otázok
Požiadavka výrobcu obsahuje model, stav a neprázdnu mapu otázok. Názvy otázok sa zachovávajú v mape odpovedí. Dodajte informácie potrebné na posúdenie každej otázky a otázky pomenujte podľa výsledkov, ktoré pracovný postup používa, napríklad category, priority alebo needs_follow_up. Viacero otázok vyhodnocuje tie isté podklady nezávisle. To, že sú v jednej požiadavke, neznamená, že neskoršia otázka závisí od skoršej odpovede.
Príklad od Inception používa ako stav objekt JSON. Príručka povoľuje v stave, pokynoch a popisoch kritérií aj reťazce, objekty alebo polia, pričom pokyny sú voliteľné alebo null. Ak podklady už pozostávajú z polí, zachovajte užitočnú štruktúru, a pri dodávaní textu udržujte dokument alebo správu identifikovateľnú. Pri prípade podpory zahrňte skutočnú požiadavku a relevantné fakty, namiesto žiadosti o odvodenie chýbajúceho kontextu.
Noul: odhadovaná kladná odpoveď
Otázka typu noul predstavuje podmienku áno/nie. Jej výstupom je pravdepodobnosť od 0 do 1, že platí kladná odpoveď. Voliteľné popisy true a false môžu špecifikovať, čo sa počíta na jednu a na druhú stranu otázky. Napríklad sa opýtajte, či správa výslovne žiada o výmenu, a odlíšte to od všeobecnej sťažnosti na položku. Pravdepodobnosť poskytuje číselný úsudok; prah a výslednú akciu v pracovnom postupe volí aplikácia.
Podmienku udržujte dostatočne úzku, aby ju podklady dokázali rozhodnúť. Ak jedna otázka mieša, či používateľ chce pomoc, či je položka chybná a či je prípad naliehavý, tieto podmienky oddeľte. Vrátenú pravdepodobnosť uchovajte spolu s definíciou otázky, aby neskorší posudzovateľ vedel, čo číslo v skutočnosti meria.
Choice: výber jednej pomenovanej možnosti
Otázka typu Choice používa mapu jedného až 255 názvov možností a ich popisov; popisy môžu byť null. Vrátený výber je zadaná možnosť s najvyššou pravdepodobnosťou. Výsledok obsahuje aj pravdepodobnosť pre každú možnosť a istotu. Kategóriám definujte odlišné významy a zahrňte záložnú kategóriu, ak budú niektoré vstupy mimo konkrétnych možností. Krátke výstupné kľúče môžu identifikovať kategórie, zatiaľ čo podrobnejšie popisy určujú hranice medzi nimi.
Zadanie na smerovanie môže rozlišovať problém s prístupom, otázku k produktu a nahlásenú chybu. Uveďte význam každej možnosti a dodajte správu, ktorú treba nasmerovať. Výstupom je zvolená kategória s rozdelením, nie pokyn, ktorý už zmenil frontu alebo kontaktoval iný systém. Ak je prípad nejednoznačný, preskúmajte konkurenčné pravdepodobnosti, namiesto toho, aby ste víťazné označenie interpretovali ako dôkaz istoty.
Score: očakávaná pozícia na hodnotiacej stupnici
Otázka typu Score používa usporiadané pole jedného až desiatich popisov úrovní, začínajúc úrovňou 0. Jej skóre je priemer indexov úrovní vážený pravdepodobnosťou a môže padnúť medzi úrovne. Odpoveď obsahuje legendu, pravdepodobnosti pre jednotlivé úrovne a istotu. Definujte poradie a kritériá pre každú úroveň, napríklad žiadny okamžitý dopad, problém s použiteľným alternatívnym riešením a úplne zablokovaná úloha.
Neceločíselné očakávané skóre je užitočné na určovanie priorít alebo agregáciu. Líši sa od výberu jedinej najpravdepodobnejšej úrovne. Legendu uchovávajte spolu s číslom, aby sa skóre neinterpretovalo na nesúvisiacej stupnici. Istota pre Choice a Score sa vykazuje samostatne v rozsahu od 0 do 1; príslušná príručka ju nedefinuje ako totožnú s najväčšou pravdepodobnosťou možnosti ani neuvádza univerzálny vzorec na jej rekonštrukciu.
Príprava užitočného výsledku rozhodnutia
Jeden podklad môže slúžiť pre nezávislé otázky na kategóriu, naliehavosť a podmienku. Úloha kontroly dokumentu sa môže pýtať, či je prítomná požadovaná téma, zvoliť jej kategóriu a ohodnotiť jej relevantnosť na popísaných úrovniach. Používajte iba zdrojový materiál dostupný v stave, s kritériami naviazanými na rozhodnutie, ktoré pracovný postup potrebuje ako ďalšie. Ak akcia vyžaduje skorší výsledok, uveďte ho explicitne v podkladoch pre ďalší krok, namiesto predpokladu, že otázky tvoria skrytú postupnosť.
Odpoveď vracia názov modelu a mapu odpovedí s kľúčmi podľa zadaných názvov otázok. Pravdepodobnosti pre Choice používajú názvy možností; pravdepodobnosti pre Score používajú indexy vo forme reťazcov, ktoré vysvetľuje legenda. Identifikátor stavu, definície otázok a typované odpovede uchovávajte prepojené. Vznikne tak interpretovateľný artefakt klasifikácie alebo hodnotenia, nie číslo odtrhnuté od faktov, ktoré ho vytvorili.
Rozsah rozhrania a limity
Inception dokumentuje Mercury Decide prostredníctvom vyhradeného rozhodovacieho rozhrania. Nepodporuje rozhrania výrobcu na dokončovanie chatu, streamovanie ani volanie nástrojov, preto by sa na tento model nemali prenášať schopnosti z profilov Mercury pre uvažovanie, hlas a generovanie kódu. Rozhodovacia príručka špecifikuje počty možností a úrovní, neuvádza však číselný limit tokenov stavu ani strop počtu otázok; zdieľané podklady udržujte zamerané na hodnotené otázky.
Pravdepodobnosti a hranice kategórií posúďte na reprezentatívnom označenom materiáli zo zamýšľanej úlohy. Hraničné odpovede preverujte voči stavu a chýbajúce informácie ponechajte ako chýbajúce, namiesto ich nahradenia vymyslenými faktami. Užitočný výsledok Mercury Decide poskytuje uzavreté rozhodnutie, jeho pravdepodobnosti a definície potrebné na jeho pochopenie; okolitá aplikácia určuje, ako sa z tohto výsledku stane smerovanie, určenie priority alebo výsledok kontroly.
Ailoot Ultra · System One POST /v1/systemone inception/mercury-decide:free
inception/mercury-decide:freeÚvod
Mercury Decide vyhodnocuje spoločné podklady v podobe textu alebo JSON vzhľadom na pomenované otázky a vracia typované výbery, pravdepodobnosti áno/nie alebo neceločíselné skóre podľa hodnotiacej stupnice. Inception dokumentuje vyhradený rozhodovací postup s najviac 255 možnosťami pre Choice a najviac desiatimi úrovňami pre Score.
- Povolené vstupy
- Text
- Výsledky
- decisions
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · System One POST /v1/systemone
- Vstup
text- Výstup
decisions- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity inception/mercury-decide:free | Predvolené— |
Poleprovider | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions | Typobject | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polestate | Typschema | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poletrace | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.type | Typstring | PožiadavkaPovinné | Hodnoty a limity noul, choice, score | Predvolené— |
Polequestions.<id>.instructions | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.criteria | Typobject|array | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: choice/score: povinné; noul: voliteľné. Kritériá pre choice tvoria objekt; score je pole s minItems1. | Predvolené— |
Polequestions.<id>.criteria.true | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Polequestions.<id>.criteria.false | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Kombinácie vstupných podkladov
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
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, state, questions |
Parametermaterial_types | Špecifikáciatext |
Parameteroptional_controls | Špecifikáciaprovider, session_id, trace, user |
Parametermultimodal_input_binding | Špecifikácianull |
Životný cyklus: synchronous
Odošlite presné ID modelu a zachovajte celú natívnu odpoveď.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Počet tokenov kontextu väčší než | Tokeny kontextu, najviac (vrátane hranice) | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Počet tokenov kontextu väčší než— | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaPásmo dĺžky požiadavky 1 | Sadzobník— | Počet tokenov kontextu väčší než0 | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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
Prijať a uložiť výsledky
Ailoot Ultra · System One
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachováva sa každá poskytnutá odpoveď podľa ID otázky s presným typom, hodnotou noul/choice/score, mierou istoty, pravdepodobnosťami a legendou. Celý pôvodný JSON sa uloží a vráti až po zúčtovaní.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodnú operáciu a úplnú alebo čiastočnú odpoveď; POST znova neodosielajte.
Polia odpovede
| 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 ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné pole, reprezentácia alebo hodnota | Ďalší krokOpravte označené pole požiadavky. |
Aliasy
Aliasy modelov
Ailoot Ultra inception/mercury-decide:free
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Inception: Mercury Decide (free)
- Aké vstupy a výsledky sú dostupné?
POST /v1/systemone·inception/mercury-decide:free:text→decisions- Aké polia používa požiadavka?
POST /v1/systemone·inception/mercury-decide:free:model,provider,questions,session_id,state,trace,user