Respan: Span-01 Lite
Span-01 Lite เป็นโปรไฟล์ให้คะแนนพฤติกรรมที่มีชื่อแยกของ Respan สำหรับบทสนทนาข้อความและบันทึกการทำงานของเอเจนต์ ใช้พฤติกรรมที่ผู้เรียกกำหนด และคืนค่าความน่าจะเป็นของการปรากฏ ไม่ปรากฏ และสังเกตไม่ได้สำหรับแต่ละพฤติกรรม โดยใช้เวิร์กโฟลว์ให้คะแนนเดียวกับ Span-01 ตามเอกสาร
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
Span-01 Lite เป็นโปรไฟล์โมเดลที่มีชื่อแยกในตระกูลให้คะแนนพฤติกรรม Span-01 ของ Respan คู่มือเริ่มต้นและตารางโมเดลของผู้ผลิตระบุว่า Lite เป็นหนึ่งในสองโปรไฟล์ที่ใช้เวิร์กโฟลว์ให้คะแนนเดียวกัน โมเดลรับปฏิสัมพันธ์แบบข้อความและนิยามพฤติกรรมด้วยภาษาทั่วไป แล้วคืนค่าความน่าจะเป็นสามค่าต่อทุกนิยาม ได้แก่ ปรากฏ ไม่ปรากฏ และสังเกตไม่ได้ เอาต์พุตที่มีประโยชน์คือระเบียนพฤติกรรมพร้อมความไม่แน่นอนที่ชัดเจน ไม่ใช่คำตอบเป็นลายลักษณ์อักษรต่อบทสนทนา
เลือกสิ่งที่จะสังเกตและขอบเขตของมัน
นิยามพฤติกรรมด้วยถ้อยคำที่ตรงกับงาน สำหรับการตรวจการส่งต่อให้บุคคล ให้ระบุว่าหมายถึงผู้ใช้ขอคุยกับคนอย่างชัดเจน ผู้ช่วยบอกว่าจำเป็นต้องส่งต่อ หรือเงื่อนไขใดเงื่อนไขหนึ่ง หากเพียงการแสดงความผิดหวังไม่ควรนับ ให้ระบุไว้ สำหรับการตรวจคำขอโทษ ให้นิยามว่าถ้อยคำใดถือเป็นคำขอโทษ แทนการพึ่งป้ายชื่อที่ไม่ชัด แต่ละนิยามมีตัวระบุที่ตัวให้คะแนนจะส่งกลับพร้อมความน่าจะเป็น
ชุดพฤติกรรมเป็นสิ่งที่ผู้เรียกกำหนด ตัวอย่างอย่างความหงุดหงิด คำสัญญาที่ไม่มีหลักฐานรองรับ การใช้เครื่องมือผิด หรือการกระทำซ้ำของเอเจนต์ เป็นนิยามที่ต้องให้มา ไม่ใช่รายการหมวดหมู่ตายตัวในโมเดล ให้แต่ละนิยามเป็นสิ่งที่สังเกตได้จากปฏิสัมพันธ์ที่ส่งมา ช่วงข้อความสั้นอาจบอกได้ว่าผู้ช่วยขอโทษหรือไม่ แต่ไม่มีหลักฐานว่าปัญหาภายนอกได้รับการแก้จริง
เตรียมช่วงบทสนทนา
อินพุตตามเอกสารของ Respan วางข้อความก่อนหน้าไว้ใน span.input และเทิร์นที่ประเมินไว้ใน span.output เนื้อหาข้อความเป็นสตริง รักษาบริบทที่จำเป็นต่อการเข้าใจเทิร์นนั้น รวมบทบาทผู้พูด คำขอผู้ใช้ที่เกี่ยวข้อง และหลักฐานข้อความที่ผู้ช่วยใช้ สำหรับการตรวจคุณภาพ ให้เทิร์นจริงแทนการเรียบเรียงใหม่จนพฤติกรรมที่ประเมินหายไป
ตัวอย่างการตรวจทานอาจใช้ข้อความผู้ใช้ที่อธิบายปัญหาซ้ำ ๆ กับคำตอบผู้ช่วยที่เสนอจะตรวจสอบ กำหนดความหงุดหงิดของผู้ใช้และคำสัญญาของผู้ช่วยเป็นข้อสังเกตแยกกัน หากผลเครื่องมือสำคัญต่อการตัดสินว่าข้ออ้างมีหลักฐานรองรับหรือไม่ ให้เก็บข้อความที่เกี่ยวข้องของผลนั้นในบริบท เอาต์พุตคือการประเมินนิยามเหล่านั้นในช่วงข้อความที่ให้มา โมเดลไม่ได้ทำการตรวจสอบที่สัญญาหรือเปลี่ยนบทสนทนาด้วยตัวเอง
ปรากฏ ไม่ปรากฏ และสังเกตไม่ได้
คำตอบการให้คะแนนมี id พฤติกรรม พร้อม p_present, p_absent และ p_not_observable ซึ่งรวมกันได้ประมาณ 1 สังเกตไม่ได้หมายถึงบันทึกไม่สามารถตอบคำถามได้ และต่างจากไม่ปรากฏ สำหรับนิยามอย่างการยอมรับวิธีแก้ของลูกค้า ช่วงข้อความที่จบก่อนลูกค้าตอบสนองเป็นหลักฐานไม่ครบ แม้คำตอบผู้ช่วยจะฟังมั่นใจก็ตาม
เก็บทั้งสามค่าเมื่อเตรียมผลสำหรับตรวจทาน หมวดที่เลือกจากค่าสูงสุดอาจมีประโยชน์ในการแสดงผล แต่การแจกแจงคงข้อมูลว่าข้อสังเกตไม่แน่นอนเพียงใด อย่าใช้ค่าการปรากฏต่ำเพียงค่าเดียวเพื่อสรุปว่าพฤติกรรมไม่เกิดขึ้นแน่นอน เมื่อการขาดหลักฐานมีน้ำหนักมาก การกระทำที่มีประโยชน์อาจเป็นการหาบริบทที่เกี่ยวข้องหรือคงผลเป็นไม่ทราบ แทนการแต่งคำอธิบาย
หลายนิยามบนหลักฐานเดียวกัน
เวิร์กโฟลว์ให้คะแนนของผู้ผลิตประเมินนิยามพฤติกรรมหลายข้อร่วมกันบนบันทึกเดียว และคืนผลของแต่ละตัวระบุตามลำดับในคำขอ เอกสารไม่ได้กำหนดเพดานจำนวนพฤติกรรมต่อคำขอ สิ่งนี้ไม่ได้ยืนยันว่ามีหน้าต่างโทเคนสากลหรือขนาดบันทึกไม่จำกัด ให้นิยามมีจุดประสงค์และหลักฐานเกี่ยวข้อง และรักษาความเชื่อมโยงระหว่างผลที่คืนมาแต่ละรายการกับนิยามที่ทำให้เกิดผลนั้น
ผลพฤติกรรมเป็นข้อสังเกตอิสระ แทนคำตอบเลือกหนึ่งตัวแบบไม่ทับซ้อน ความหงุดหงิด คำขอโทษ และข้อเสนอส่งต่อสามารถปรากฏในการโต้ตอบเดียวกันได้ การแจกแจงสามทางของแต่ละข้อมีความหมายภายในนิยามนั้น การบวกค่าการปรากฏข้ามพฤติกรรมไม่ทำให้ได้การแจกแจงหมวดหมู่ที่ปรับผลรวมเป็นหนึ่งหรือคะแนนตามเกณฑ์แบบมีลำดับ
เก็บโปรไฟล์ที่เลือกไว้กับผลลัพธ์
ผู้ผลิตระบุชื่อ Lite และชื่อมาตรฐานพร้อมรูปแบบคำขอและผลลัพธ์ที่ใช้ร่วมกัน สัญญานี้รองรับการเตรียมบันทึกและตีความความน่าจะเป็นพฤติกรรมสำหรับทั้งสองโปรไฟล์ แต่ไม่ได้ยืนยันว่า Lite มีน้ำหนัก จำนวนพารามิเตอร์ หรือคุณภาพเท่ากับอีกรุ่น ระบุโปรไฟล์ที่เลือกให้ตรวจสอบได้เมื่อตรวจทานผล แทนการสลับผลจากคนละรุ่นโดยไม่แจ้ง
ใช้บทสนทนาติดป้ายกำกับจากงานเป้าหมายเพื่อเลือกเกณฑ์สำหรับบันทึก ส่งต่องาน หรือตรวจทาน เก็บผลที่มีค่าสังเกตไม่ได้สูงและข้อสังเกตก้ำกึ่งไว้ตรวจ และเปรียบเทียบข้อผิดพลาดที่ดูเหมือนเกิดขึ้นกับเทิร์นจริงและนิยามพฤติกรรม สิ่งส่งมอบสุดท้ายที่มีประโยชน์ประกอบด้วยตัวระบุช่วงข้อความ นิยาม โปรไฟล์ที่เลือก และผลความน่าจะเป็นสามทางครบถ้วน ขั้นตอนแอปพลิเคชันภายหลังจะตัดสินใจว่าจะทำอะไรกับข้อสังเกตนั้น เอาต์พุตให้คะแนนของ Lite ไม่ได้ส่งต่อให้คน บล็อกคำตอบ หรือสร้างการแก้ไขด้วยตัวเอง
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteเริ่มต้น
Span-01 Lite เป็นโปรไฟล์ให้คะแนนพฤติกรรมที่มีชื่อแยกของ Respan สำหรับบทสนทนาข้อความและบันทึกการทำงานของเอเจนต์ ใช้พฤติกรรมที่ผู้เรียกกำหนด และคืนค่าความน่าจะเป็นของการปรากฏ ไม่ปรากฏ และสังเกตไม่ได้สำหรับแต่ละพฤติกรรม โดยใช้เวิร์กโฟลว์ให้คะแนนเดียวกับ Span-01 ตามเอกสาร
- อินพุตที่รองรับ
- ข้อความ
- ผลลัพธ์
- decisions
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · System One POST /v1/systemone
- ขาเข้า
text- ขาออก
decisions- รูปแบบเอาต์พุต
- json
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด respan/span-01-lite | ค่าเริ่มต้น— |
ฟิลด์provider | ประเภทschema | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์questions | ประเภทobject | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์session_id | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์state | ประเภทschema | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์trace | ประเภทschema | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์user | ประเภทstring | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์questions.<id>.type | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด noul, choice, score | ค่าเริ่มต้น— |
ฟิลด์questions.<id>.instructions | ประเภทstring|object|array | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
ฟิลด์questions.<id>.criteria | ประเภทobject|array | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด เงื่อนไข: choice/score: จำเป็น; noul: ไม่จำเป็น เกณฑ์ choice เป็นออบเจ็กต์ ส่วน score เป็นอาร์เรย์ที่มี minItems1 | ค่าเริ่มต้น— |
ฟิลด์questions.<id>.criteria.true | ประเภทstring|object|array | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ใช้เมื่อ: มีการส่งออบเจ็กต์เกณฑ์ noul มาแล้ว | ค่าเริ่มต้น— |
ฟิลด์questions.<id>.criteria.false | ประเภทstring|object|array | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ใช้เมื่อ: มีการส่งออบเจ็กต์เกณฑ์ noul มาแล้ว | ค่าเริ่มต้น— |
ชุดผสมของสื่ออินพุต
noul · จำเป็น: state, questions.<id>.type=noul, questions.<id>.instructions
choice · จำเป็น: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · จำเป็น: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
พารามิเตอร์และวงจรการทำงานของเมธอด
| พารามิเตอร์ | ข้อกำหนด |
|---|---|
พารามิเตอร์content_type | ข้อกำหนดapplication/json |
พารามิเตอร์required | ข้อกำหนดmodel, state, questions |
พารามิเตอร์material_types | ข้อกำหนดtext |
พารามิเตอร์optional_controls | ข้อกำหนดprovider, session_id, trace, user |
พารามิเตอร์multimodal_input_binding | ข้อกำหนดnull |
วงจรการทำงาน: synchronous
ส่ง ID โมเดลที่ตรงตามที่กำหนดและเก็บการตอบกลับรูปแบบดั้งเดิมทั้งหมด
ราคา
ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก
- โหมดรวดเร็ว
- ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
- โหมดยืดหยุ่น
- ไม่ได้ระบุ เมื่อเลือกโหมด flex
- ระดับการใช้เหตุผลสูงสุด
- ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด
อัตราค่าบริการ Ailoot
ราคาตามการตั้งค่า
เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน
| การตั้งค่า | ตารางอัตราค่าบริการ | โทเค็นบริบท มากกว่า | โทเค็นบริบท ไม่เกินและรวมค่า | ค่าบริการ |
|---|---|---|---|---|
| การตั้งค่าอัตราราคาพื้นฐานของโทเคน | ตารางอัตราค่าบริการอัตราพื้นฐาน | โทเค็นบริบท มากกว่า— | โทเค็นบริบท ไม่เกินและรวมค่าไม่มีขีดจำกัดสูงสุด | ค่าบริการ ขาเข้า · โทเค็นอินพุต $0 / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต $0 / 1K โทเค็น ขาเข้า · การอ่านแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง — / 1K โทเค็น |
| การตั้งค่าระดับความยาวคำขอ 1 | ตารางอัตราค่าบริการ— | โทเค็นบริบท มากกว่า0 | โทเค็นบริบท ไม่เกินและรวมค่าไม่มีขีดจำกัดสูงสุด | ค่าบริการ ขาเข้า · โทเค็นอินพุต $0 / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต $0 / 1K โทเค็น ขาเข้า · การอ่านแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง — / 1K โทเค็น |
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
ตัวอย่างคำขอ
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
รับและบันทึกผลลัพธ์
Ailoot Ultra · System One
json
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด
เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน
เก็บคำตอบของทุก ID คำถามที่ให้มา พร้อมชนิดที่ตรงกัน ค่า noul/choice/score ความเชื่อมั่น ความน่าจะเป็น และคำอธิบายสัญลักษณ์ JSON ต้นฉบับทั้งหมดจะถูกจัดเก็บและส่งกลับหลังชำระบัญชีแล้วเท่านั้น
เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ
เก็บการดำเนินการเดิมและการตอบกลับทั้งหมด/บางส่วน อย่าส่ง POST ซ้ำ
ฟิลด์การตอบกลับ
| ฟิลด์ | ประเภท |
|---|---|
ฟิลด์model | ประเภทstring |
ฟิลด์id | ประเภทstring |
ฟิลด์provider | ประเภทstring |
ฟิลด์answers.<id>.type | ประเภทstring |
ฟิลด์answers.<id>.noul | ประเภทnumber |
ฟิลด์answers.<id>.choice | ประเภทstring |
ฟิลด์answers.<id>.score | ประเภทnumber |
ฟิลด์answers.<id>.confidence | ประเภทnumber |
ฟิลด์answers.<id>.probabilities | ประเภทobject |
ฟิลด์answers.<id>.legend | ประเภทobject |
ฟิลด์usage.input_tokens | ประเภทinteger |
ฟิลด์usage.output_tokens | ประเภทinteger |
ฟิลด์usage.cost | ประเภทnumber |
ข้อผิดพลาดและขั้นตอนถัดไป
| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
|---|---|---|
การตอบกลับ400 · invalid_request_error | เงื่อนไขฟิลด์ที่จำเป็น รูปแบบข้อมูล หรือค่าไม่ถูกต้อง | ขั้นตอนถัดไปแก้ไขฟิลด์คำขอที่ระบุ |
ชื่ออื่น
ชื่ออื่นของโมเดล
Ailoot Ultra respan/span-01-lite
ชื่อพาธเมธอดอื่น
ใช้พาธเมธอดที่แสดงด้านบน
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Respan: Span-01 Lite
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/systemone·respan/span-01-lite:text→decisions- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user