Inception: Mercury Decide
Mercury Decide menilai bukti teks atau JSON bersama berdasarkan soalan bernama dan mengembalikan pilihan berjenis, kebarangkalian ya/tidak atau skor rubrik pecahan. Inception mendokumenkan aliran kerja keputusan khusus dengan sehingga 255 pilihan Choice dan sepuluh tahap Score.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Mercury Decide ialah model Inception untuk keputusan berstruktur berdasarkan bukti yang diberikan. Ia menggabungkan keadaan bersama dengan soalan bernama dan mengembalikan jawapan berjenis bersama kebarangkalian. Hasil boleh berupa kategori terpilih, anggaran kebarangkalian ya/tidak atau kedudukan pada skala yang ditakrifkan. Profil ini menyediakan keputusan terhad yang boleh ditafsirkan perisian; antara muka yang didokumenkan tidak menjana jawapan sembang bentuk bebas.
Keadaan bersama dan nama soalan bermakna
Permintaan pengeluar mengandungi model, state dan peta questions yang tidak kosong. Nama soalan dikekalkan dalam peta jawapan. Bekalkan maklumat yang diperlukan untuk menilai setiap soalan dan namakan soalan berdasarkan hasil yang digunakan aliran kerja, seperti category, priority atau needs_follow_up. Beberapa soalan menilai bukti yang sama secara bebas. Kedudukannya dalam satu permintaan tidak menjadikan soalan kemudian bergantung pada jawapan terdahulu.
Contoh Inception menggunakan objek JSON untuk state. Panduan turut membenarkan rentetan, objek atau tatasusunan dalam keadaan, arahan dan penerangan kriteria, dengan arahan bersifat pilihan atau null. Kekalkan struktur berguna apabila bukti sudah terdiri daripada medan, dan pastikan dokumen atau mesej dapat dikenal pasti ketika membekalkan teks. Untuk kes sokongan, sertakan permintaan sebenar dan fakta berkaitan, bukannya permintaan untuk menyimpulkan konteks yang tiada.
Noul: anggaran jawapan positif
Soalan noul mewakili syarat ya/tidak. Outputnya ialah kebarangkalian dari 0 hingga 1 bahawa jawapan positif terpakai. Penerangan true dan false yang bersifat pilihan boleh menetapkan perkara yang dikira pada setiap sisi soalan. Contohnya, tanya sama ada mesej secara jelas meminta penggantian dan bezakannya daripada aduan umum tentang item. Kebarangkalian memberikan pertimbangan berangka; aplikasi memilih ambang dan tindakan aliran kerja hasilnya.
Pastikan syarat cukup khusus untuk diputuskan oleh bukti. Jika satu soalan mencampurkan sama ada pengguna mahu bantuan, sama ada item rosak dan sama ada kes mendesak, pisahkan syarat tersebut. Simpan kebarangkalian yang dikembalikan bersama takrif soalan supaya penyemak kemudian dapat mengetahui perkara yang sebenarnya diukur nombor itu.
Choice: memilih satu pilihan bernama
Soalan Choice menggunakan peta satu hingga 255 nama pilihan dan penerangan; penerangan boleh bernilai null. Pilihan yang dikembalikan ialah pilihan yang diberikan dengan kebarangkalian tertinggi. Hasil turut mengandungi kebarangkalian bagi setiap pilihan dan confidence. Takrifkan makna berbeza bagi kategori dan sertakan kategori sandaran apabila sesetengah input berada di luar pilihan khusus. Kunci output pendek boleh mengenal pasti kategori, manakala penerangan lebih lengkap menetapkan sempadan antaranya.
Taklimat penghalaan boleh membezakan masalah akses, soalan produk dan kecacatan yang dilaporkan. Nyatakan makna setiap pilihan dan berikan mesej yang perlu dihalakan. Output ialah kategori terpilih bersama taburan, bukan arahan yang telah mengubah barisan atau menghubungi sistem lain. Periksa kebarangkalian yang bersaing apabila kes kabur, bukannya mentafsir label pemenang sebagai bukti kepastian.
Score: kedudukan jangkaan pada rubrik
Soalan Score menggunakan tatasusunan bertertib dengan satu hingga sepuluh penerangan tahap, bermula pada tahap 0. Skornya ialah purata indeks tahap berwajaran kebarangkalian dan boleh berada di antara tahap. Jawapan mengandungi petunjuk, kebarangkalian setiap tahap dan confidence. Takrifkan tertib dan kriteria setiap tahap, seperti tiada kesan segera, masalah dengan alternatif yang boleh digunakan dan tugas yang tersekat sepenuhnya.
Skor jangkaan pecahan berguna untuk penentuan keutamaan atau pengagregatan. Ia berbeza daripada memilih satu tahap paling berkemungkinan. Simpan petunjuk bersama nombor supaya skor tidak ditafsirkan pada skala yang tidak berkaitan. Confidence bagi Choice dan Score dilaporkan secara berasingan antara 0 dan 1; panduan berkaitan tidak mentakrifkannya sebagai sama dengan kebarangkalian pilihan terbesar atau memberikan formula sejagat untuk membinanya semula.
Menyediakan hasil keputusan yang berguna
Satu bukti boleh menyokong soalan kategori, kesegeraan dan syarat yang bebas. Tugas semakan dokumen boleh bertanya sama ada topik wajib ada, memilih kategorinya dan menilai kerelevanannya pada tahap yang diterangkan. Gunakan hanya bahan sumber yang tersedia dalam keadaan, dengan kriteria terikat pada keputusan seterusnya yang diperlukan aliran kerja. Jika tindakan memerlukan hasil terdahulu, nyatakan hasil itu dengan jelas dalam bukti untuk langkah berikutnya, bukannya menganggap soalan membentuk urutan tersembunyi.
Respons mengembalikan nama model dan peta answers dengan kunci nama soalan yang diberikan. Kebarangkalian Choice menggunakan nama pilihan; kebarangkalian Score menggunakan indeks rentetan dengan petunjuk yang menerangkan indeks tersebut. Simpan perkaitan antara pengecam keadaan, takrif soalan dan jawapan berjenis. Ini menghasilkan artifak pengelasan atau penarafan yang boleh ditafsirkan, bukannya nombor yang terpisah daripada fakta yang menghasilkannya.
Skop dan had antara muka
Inception mendokumenkan Mercury Decide melalui antara muka keputusan khususnya. Ia tidak menyokong antara muka chat-completion, penstriman atau panggilan alat pembuat, maka keupayaan profil penaakulan, suara dan penjanaan kod Mercury tidak patut dipindahkan kepada model ini. Panduan keputusan menetapkan bilangan pilihan dan tahap tetapi tidak memberikan had berangka token keadaan atau bilangan soalan; fokuskan bukti bersama pada soalan yang dinilai.
Nilai kebarangkalian dan sempadan kategori menggunakan bahan berlabel yang mewakili tugas sasaran. Semak jawapan berhampiran ambang berdasarkan keadaan dan kekalkan maklumat yang tiada sebagai tidak diketahui, bukannya menggantikannya dengan fakta rekaan. Hasil Mercury Decide yang berguna memberikan keputusan tertutup, kebarangkaliannya dan takrif yang diperlukan untuk memahaminya; aplikasi di sekelilingnya menentukan bagaimana hasil itu menjadi penghalaan, penentuan keutamaan atau hasil semakan.
Ailoot Ultra · System One POST /v1/systemone inception/mercury-decide
inception/mercury-decidePengenalan
Mercury Decide menilai bukti teks atau JSON bersama berdasarkan soalan bernama dan mengembalikan pilihan berjenis, kebarangkalian ya/tidak atau skor rubrik pecahan. Inception mendokumenkan aliran kerja keputusan khusus dengan sehingga 255 pilihan Choice dan sepuluh tahap Score.
- Input yang diterima
- Teks
- Hasil
- decisions
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · System One POST /v1/systemone
- Input
text- Output
decisions- Format output
- json
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had inception/mercury-decide | Lalai— |
Medanprovider | Jenisschema | KeperluanPilihan | Nilai & had | Lalai— |
Medanquestions | Jenisobject | KeperluanDiperlukan | Nilai & had | Lalai— |
Medansession_id | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medanstate | Jenisschema | KeperluanDiperlukan | Nilai & had | Lalai— |
Medantrace | Jenisschema | KeperluanPilihan | Nilai & had | Lalai— |
Medanuser | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medanquestions.<id>.type | Jenisstring | KeperluanDiperlukan | Nilai & had noul, choice, score | Lalai— |
Medanquestions.<id>.instructions | Jenisstring|object|array | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanquestions.<id>.criteria | Jenisobject|array | KeperluanPilihan | Nilai & had Syarat: choice/score: wajib; noul: pilihan. Kriteria choice ialah objek; score ialah tatasusunan dengan minItems1. | Lalai— |
Medanquestions.<id>.criteria.true | Jenisstring|object|array | KeperluanDiperlukan | Nilai & had Terpakai apabila: Objek kriteria noul dibekalkan | Lalai— |
Medanquestions.<id>.criteria.false | Jenisstring|object|array | KeperluanDiperlukan | Nilai & had Terpakai apabila: Objek kriteria noul dibekalkan | Lalai— |
Gabungan bahan input
noul · Diperlukan: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Diperlukan: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Diperlukan: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, state, questions |
Parametermaterial_types | Kontraktext |
Parameteroptional_controls | Kontrakprovider, session_id, trace, user |
Parametermultimodal_input_binding | Kontraknull |
Kitar hayat: synchronous
Hantar ID model yang tepat dan simpan respons natif yang lengkap.
Pelan harga
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Kadar Ailoot
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Token konteks, melebihi | Token konteks, sehingga dan termasuk | Caj |
|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Token konteks, melebihi— | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.00008 / 1K token Output · Token output $0 / 1K token Input · Bacaan cache $0 / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiTahap panjang permintaan 1 | Jadual kadar— | Token konteks, melebihi0 | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input $0.00008 / 1K token Output · Token output $0 / 1K token Input · Bacaan cache $0 / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · System One
{
"model": "inception/mercury-decide",
"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'
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
Terima dan simpan hasil
Ailoot Ultra · System One
json
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Setiap jawapan bagi ID soalan yang diberikan dikekalkan berserta jenis tepatnya, nilai noul/choice/score, keyakinan, kebarangkalian dan petunjuk. Keseluruhan JSON asal disimpan dan hanya dikembalikan selepas penyelesaian caj.
Jika respons asal perlu disemak
Simpan operasi asal dan balasan penuh/separa; jangan ulang POST.
Medan respons
| Medan | Jenis |
|---|---|
Medanmodel | Jenisstring |
Medanid | Jenisstring |
Medanprovider | Jenisstring |
Medananswers.<id>.type | Jenisstring |
Medananswers.<id>.noul | Jenisnumber |
Medananswers.<id>.choice | Jenisstring |
Medananswers.<id>.score | Jenisnumber |
Medananswers.<id>.confidence | Jenisnumber |
Medananswers.<id>.probabilities | Jenisobject |
Medananswers.<id>.legend | Jenisobject |
Medanusage.input_tokens | Jenisinteger |
Medanusage.output_tokens | Jenisinteger |
Medanusage.cost | Jenisnumber |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, bentuk perwakilan atau nilai tidak sah | Langkah seterusnyaBetulkan medan permintaan yang dinyatakan. |
Alias
Alias model
Ailoot Ultra inception/mercury-decide
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Inception: Mercury Decide
- Apakah input dan hasil yang tersedia?
POST /v1/systemone·inception/mercury-decide:text→decisions- Apakah medan yang digunakan oleh permintaan?
POST /v1/systemone·inception/mercury-decide:model,provider,questions,session_id,state,trace,user