Respan: Span-01 Lite
Span-01 Lite ialah profil penskoran tingkah laku Respan yang diberi nama berasingan untuk perbualan teks dan jejak ejen. Ia menggunakan tingkah laku yang ditakrifkan pemanggil dan mengembalikan kebarangkalian hadir, tiada dan tidak dapat diperhatikan bagi setiap satunya, dengan aliran kerja penskoran yang sama seperti Span-01 dalam dokumentasi.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Span-01 Lite ialah profil model yang diberi nama berasingan dalam keluarga penskoran tingkah laku Span-01 Respan. Panduan mula pantas dan jadual model pengeluar mengenal pasti Lite sebagai salah satu daripada dua profil yang menggunakan aliran kerja penskoran yang sama. Ia menerima interaksi teks dan takrif tingkah laku dalam bahasa biasa, kemudian mengembalikan tiga kebarangkalian untuk setiap takrif: hadir, tiada dan tidak dapat diperhatikan. Output berguna profil ini ialah rekod tingkah laku yang menyatakan ketidakpastian secara jelas, bukan jawapan bertulis kepada perbualan.
Pilih pemerhatian dan sempadannya
Takrifkan tingkah laku dengan kata-kata yang sesuai dengan tugas anda. Untuk semakan penyerahan kepada manusia, nyatakan sama ada maksudnya pengguna meminta seseorang secara jelas, pembantu mengatakan penyerahan diperlukan, atau salah satu keadaan itu. Jika kekecewaan semata-mata tidak patut dikira, nyatakan demikian. Untuk semakan permohonan maaf, takrifkan ungkapan yang dianggap sebagai permohonan maaf dan jangan bergantung pada label kabur. Setiap takrif mempunyai pengecam yang dikembalikan penskor bersama kebarangkaliannya.
Set tingkah laku ditentukan oleh pemanggil. Contoh seperti rasa kecewa, janji tanpa sokongan, penyalahgunaan alat atau tindakan ejen berulang ialah takrif untuk diberikan, bukan senarai tetap kategori natif. Pastikan setiap takrif boleh diperhatikan dalam interaksi yang diberikan. Petikan pendek mungkin dapat memastikan sama ada pembantu meminta maaf tetapi tidak mempunyai bukti bahawa masalah luaran benar-benar telah diselesaikan.
Sediakan petikan perbualan
Input yang didokumenkan Respan meletakkan mesej terdahulu dalam span.input dan giliran yang dinilai dalam span.output. Kandungan mesej ialah rentetan. Kekalkan konteks yang diperlukan untuk memahami giliran itu, termasuk peranan penutur, permintaan pengguna yang berkaitan dan sebarang bukti teks yang digunakan pembantu. Untuk semakan kualiti, berikan giliran sebenar, bukan parafrasa yang menghilangkan tingkah laku yang sedang dinilai.
Contoh semakan boleh menggunakan mesej pengguna yang menerangkan masalah berulang dan balasan pembantu yang menawarkan penyiasatan. Takrifkan kekecewaan pengguna dan janji pembantu sebagai pemerhatian berasingan. Jika hasil alat penting untuk menilai sama ada dakwaan berasas, kekalkan teks hasil yang berkaitan dalam konteks. Output menilai takrif tersebut dalam petikan yang diberikan; model tidak menjalankan penyiasatan yang dijanjikan atau mengubah perbualan itu sendiri.
Hadir, tiada dan tidak dapat diperhatikan
Respons penskoran mengandungi id tingkah laku bersama p_present, p_absent dan p_not_observable, dengan jumlah kira-kira 1. Tidak dapat diperhatikan bermaksud jejak itu tidak dapat menjawab soalan. Ini berbeza daripada tiada. Untuk takrif seperti penerimaan penyelesaian oleh pelanggan, petikan yang berakhir sebelum pelanggan memberi reaksi ialah bukti tidak lengkap walaupun balasan pembantu kedengaran yakin.
Kekalkan ketiga-tiga nilai apabila menyediakan hasil untuk semakan. Kategori yang dipilih mengikut nilai tertinggi boleh berguna untuk paparan, tetapi taburan mengekalkan tahap ketidakpastian pemerhatian tersebut. Jangan menggunakan nilai kehadiran rendah sahaja untuk menyimpulkan bahawa tingkah laku itu pasti tidak berlaku. Apabila kekurangan bukti mendominasi, tindakan berguna boleh berupa mendapatkan konteks berkaitan atau mengekalkan hasil sebagai tidak diketahui, bukannya mereka penjelasan.
Beberapa takrif berdasarkan bukti yang sama
Aliran kerja penskoran pengeluar menilai beberapa takrif tingkah laku bersama-sama pada satu jejak dan mengembalikan hasil untuk setiap pengecam mengikut urutan permintaan. Dokumentasinya tidak menetapkan had bilangan tingkah laku bagi setiap permintaan. Ini tidak membuktikan adanya tetingkap token sejagat atau saiz jejak tanpa had. Pastikan takrif mempunyai tujuan dan bukti berkaitan, serta kekalkan kaitan antara setiap hasil yang dikembalikan dengan takrif yang menghasilkannya.
Hasil tingkah laku ialah pemerhatian bebas, bukan satu jawapan pilihan eksklusif. Kekecewaan, permohonan maaf dan cadangan penyerahan kepada manusia semuanya boleh hadir dalam pertukaran yang sama. Taburan tiga hala setiap satunya bermakna dalam takrif masing-masing; menambah nilai kehadiran daripada tingkah laku berbeza tidak menghasilkan taburan kategori ternormal atau skor rubrik bertertib.
Simpan profil terpilih bersama hasilnya
Pembuat mendokumenkan nama Lite dan standard dengan bentuk permintaan dan hasil yang dikongsi. Kontrak itu menyokong penyediaan jejak dan pentafsiran kebarangkalian tingkah laku untuk kedua-dua profil bernama. Ia tidak membuktikan bahawa Lite mempunyai pemberat, bilangan parameter atau kualiti yang sama dengan edisi lain. Pastikan profil terpilih dapat dikenal pasti ketika menyemak hasilnya, bukannya menukar hasil daripada edisi berbeza secara senyap.
Gunakan perbualan berlabel daripada tugas sasaran untuk memilih ambang pencatatan, penghalaan atau semakan. Kekalkan hasil dengan nilai tidak dapat diperhatikan yang tinggi dan pemerhatian berhampiran ambang untuk diperiksa, serta bandingkan sebarang kesilapan yang kelihatan dengan giliran asal dan takrif tingkah laku. Artifak akhir yang berguna mengandungi pengecam petikan teks, takrif, profil terpilih dan hasil kebarangkalian tiga hala yang lengkap. Langkah aplikasi kemudian memutuskan tindakan susulan terhadap pemerhatian itu; output penskoran Lite tidak dengan sendirinya melaksanakan penyerahan kepada manusia, menyekat balasan atau menghasilkan pembetulan.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-litePengenalan
Span-01 Lite ialah profil penskoran tingkah laku Respan yang diberi nama berasingan untuk perbualan teks dan jejak ejen. Ia menggunakan tingkah laku yang ditakrifkan pemanggil dan mengembalikan kebarangkalian hadir, tiada dan tidak dapat diperhatikan bagi setiap satunya, dengan aliran kerja penskoran yang sama seperti Span-01 dalam dokumentasi.
- 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 respan/span-01-lite | 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 / 1K token Output · Token output $0 / 1K token Input · Bacaan cache — / 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 / 1K token Output · Token output $0 / 1K token Input · Bacaan cache — / 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": "respan/span-01-lite",
"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']='respan/span-01-lite'
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 respan/span-01-lite
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Respan: Span-01 Lite
- Apakah input dan hasil yang tersedia?
POST /v1/systemone·respan/span-01-lite:text→decisions- Apakah medan yang digunakan oleh permintaan?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user