Respan: Span-01
Span-01 ialah pengelas tingkah laku berasaskan teks Respan untuk perbualan dan jejak ejen. Takrifkan tingkah laku dalam bahasa biasa, dan ia mengembalikan tiga kebarangkalian bagi setiap satunya: hadir, tiada dan tidak dapat diperhatikan, sambil mengekalkan ketidakpastian apabila jejak yang diberikan tidak dapat menjawab soalan.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Span-01 ialah model penskoran tingkah laku Respan untuk perbualan dan jejak ejen. Ia membaca interaksi teks bersama takrif tingkah laku yang ditulis dalam bahasa biasa dan mengembalikan kebarangkalian bagi setiap takrif. Output membezakan tingkah laku yang hadir, tiada atau tidak dapat diperhatikan dalam jejak yang diberikan. Ini memberikan isyarat berangka kepada aliran kerja penilaian, dengan cara jelas untuk mewakili bukti yang tiada, bukannya penjelasan terjana yang perlu dihuraikan.
Takrifkan tingkah laku yang mahu diperhatikan
Tingkah laku dibekalkan oleh pemanggil. Suntikan prompt, dakwaan tanpa sokongan, pendedahan rahsia, gelung berulang, penyalahgunaan alat dan kekecewaan pengguna ialah takrif yang mungkin digunakan, bukan taksonomi tetap yang terbina dalam model. Nyatakan apa yang dikira sebagai tingkah laku itu dan apa yang tidak. Takrif khusus boleh membezakan pengguna yang meminta penyerahan kepada manusia daripada sekadar meluahkan kekecewaan. Takrif lain boleh membezakan pembantu yang mengakui masalah daripada yang menjanjikan tindakan yang tidak dapat dilakukannya.
Gunakan pengecam stabil bersama takrif supaya hasil kekal dikaitkan dengan tingkah laku yang dinilai. Fokuskan kriteria pada sesuatu yang boleh ditunjukkan oleh jejak. Jika tingkah laku memerlukan dokumen sumber, hasil alat atau respons pelanggan kemudian, sertakan bukti itu di tempat yang sesuai dalam interaksi teks. Takrif sahaja tidak dapat membuktikan fakta yang tiada dalam jejak.
Sediakan konteks terdahulu dan giliran sasaran
Input yang didokumenkan memisahkan mesej terdahulu dalam span.input daripada giliran sasaran dalam span.output. Kandungan setiap mesej ialah rentetan. Berikan konteks perbualan sebenar dan giliran yang mahu diskor, sambil mengekalkan peranan penutur dan urutan yang diperlukan untuk mentafsirkannya. Ini ialah profil penskoran teks; teks dokumen yang disediakan atau transkrip boleh menjadi bukti, manakala media asal yang digunakan untuk memperoleh teks itu bukan input yang didokumenkan.
Bagi interaksi sokongan, simpan permintaan pelanggan bersama cadangan balasan pembantu. Bagi ejen yang menggunakan alat, kekalkan pemerhatian alat yang berkaitan dan jawapan yang bergantung padanya. Contoh takrif keberasasan boleh menanyakan sama ada pembantu menyatakan kesimpulan yang tidak disokong oleh pemerhatian yang diberikan. Hasil berguna berkaitan dengan tingkah laku yang ditakrifkan dalam petikan itu, bukan diagnosis lengkap seluruh aplikasi.
Baca tiga kebarangkalian bagi setiap takrif
Setiap hasil merangkumi pengecam tingkah laku serta p_present, p_absent dan p_not_observable. Jumlah ketiga-tiga kebarangkalian ialah kira-kira 1. Hadir menganggarkan tingkah laku berlaku; tiada menganggarkan ia tidak berlaku; tidak dapat diperhatikan menganggarkan petikan yang diberikan kekurangan bukti untuk membuat keputusan. Maknanya berasingan dan perlu kekal berasingan ketika hasil ditafsirkan.
Contohnya, petikan yang berakhir dengan pembantu mengatakan ia akan menyelesaikan masalah mungkin menunjukkan satu janji. Petikan itu belum dapat menunjukkan bahawa pelanggan menerima penyelesaian akhirnya jika tiada balasan pelanggan. Anggap hasil dengan bukti yang tiada itu sebagai tidak diketahui, bukannya menukarnya kepada tiada. Kebarangkalian kehadiran rendah tidak secara automatik menjadi bukti kukuh ketiadaan apabila sebahagian besar taburan ialah tidak dapat diperhatikan.
Penskoran sekali lalu merentas takrif tingkah laku
Respan menerangkan Span-01 sebagai pengelas penaakulan yang mula-mula dilatih untuk pengelasan umum dengan RLAIF, kemudian dikhususkan untuk pengesanan tingkah laku. Setiap takrif berjalan sebagai cabang selari pada jejak yang sama dan model mengembalikan kebarangkalian tingkah laku dalam satu laluan hadapan. Perhatian hibrid menyokong pemprosesan jejak panjang dan kompleks. Ia tidak menjana token, menulis pertimbangan berbentuk naratif atau menghasilkan penjelasan bentuk bebas tentang pengelasannya.
Panduan konsep dan rujukan penskoran tidak mendokumenkan had bilangan tingkah laku bagi setiap permintaan. Namun, setiap takrif tetap menjadi sebahagian daripada penilaian yang diberikan, maka pastikan setiap satunya jelas dan berkaitan, bukannya menganggap ketiadaan had bilangan sebagai bukti kapasiti input tanpa had. Hasil mengandungi satu entri bagi setiap tingkah laku mengikut urutan permintaan, dikenal pasti melalui id. Beberapa takrif menerangkan beberapa pemerhatian bebas; ia bukan pilihan kategori yang saling eksklusif dengan jumlah merentas tingkah laku yang mesti menjadi satu.
Menyediakan artifak penilaian yang berguna
Gabungkan kebarangkalian yang dikembalikan dengan ambang khusus tugas dan peraturan semakan di luar model. Pengeluar mengesyorkan penggunaan perbualan berlabel untuk memilih ambang tersebut serta pemeriksaan hasil kehadiran berhampiran ambang atau nilai tidak dapat diperhatikan yang tinggi. Aliran kerja sokongan boleh merekodkan kekecewaan, cadangan eskalasi dan janji tanpa sokongan secara berasingan. Aliran kerja kualiti ejen boleh menjejak tindakan berulang atau sama ada respons menggunakan bukti yang disediakan kepadanya.
Simpan petikan teks, takrif tingkah laku, pengecam hasil dan taburan tiga hala penuh bersama-sama. Apabila takrif berubah, sedari bahawa perkara yang diukur oleh kebarangkalian turut berubah. Semak kesilapan yang kelihatan berdasarkan perbualan sebenar dan jangan menganggap hasil berangka sebagai bukti peristiwa yang tidak diperhatikan. Artifak berguna ialah rekod tingkah laku yang terikat pada jejak dan kriteria, dengan ketidakpastian dikekalkan untuk pemeriksaan kemudian atau keputusan aplikasi seterusnya.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Pengenalan
Span-01 ialah pengelas tingkah laku berasaskan teks Respan untuk perbualan dan jejak ejen. Takrifkan tingkah laku dalam bahasa biasa, dan ia mengembalikan tiga kebarangkalian bagi setiap satunya: hadir, tiada dan tidak dapat diperhatikan, sambil mengekalkan ketidakpastian apabila jejak yang diberikan tidak dapat menjawab soalan.
- 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 | 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.00004 / 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.00004 / 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",
"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'
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
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Respan: Span-01
- Apakah input dan hasil yang tersedia?
POST /v1/systemone·respan/span-01:text→decisions- Apakah medan yang digunakan oleh permintaan?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user