VoyageAI by MongoDB: rerank-2.5

rerank-2.5 จัดชุดข้อความตัวเลือกที่ส่งให้ใหม่ตามความเกี่ยวข้องกับคำค้นและคำสั่งภาษาธรรมชาติแบบเลือกใช้ เป็นตัวจัดอันดับใหม่หลายภาษาที่เน้นคุณภาพ มีบริบทคำค้นกับเอกสาร 32,000 โทเคน และคะแนนตามอันดับที่เชื่อมกับดัชนีตัวเลือกเดิม

Ailoot Ultra · จัดอันดับใหม่ POST /v1/rerank voyageai/rerank-2.5

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

rerank-2.5 เป็นตัวจัดอันดับใหม่ตามคำสั่งของ Voyage AI ที่ออกแบบเพื่อปรับชุดตัวเลือกการค้นหา พิจารณาคำค้นและเอกสารแต่ละฉบับร่วมกันแบบ cross-encoder แล้วส่งลำดับความเกี่ยวข้อง รุ่นที่ผู้ผลิตเผยแพร่เน้นการควบคุมความหมายของความเกี่ยวข้องด้วยภาษาธรรมชาติ การค้นคืนหลายภาษา และบริบทคำค้นกับเอกสารที่ยาวกว่ารุ่น rerank-2 ก่อนหน้า

ส่งตัวเลือกให้โมเดลเปรียบเทียบ

อินพุตเป็นคำค้นและรายการเอกสารข้อความตัวเลือก อาจเป็นข้อความที่ค้นหา embedding หรือค้นคำศัพท์ขั้นแรกเลือกมา ตัวจัดอันดับใหม่ประเมินข้อความที่ส่ง ไม่ได้สร้าง embedding ของคลังข้อมูล หน้าที่จริงจึงคือปรับตัวเลือกที่การค้นหาแรกพบแล้ว

เก็บลำดับตัวเลือกเดิมและตัวระบุแหล่งข้อมูลเมื่อเตรียมรายการ ดัชนีที่ส่งกลับอ้างถึงตำแหน่งอินพุตเหล่านั้น สำหรับงาน RAG ให้ส่งข้อความที่ขั้นตอบอาจใช้จริง รวมชื่อเรื่องหรือเงื่อนไขประกอบที่ต้องใช้ตีความ เอกสารเกี่ยวข้องที่ไม่มีในชุดตัวเลือกที่ส่งไม่สามารถปรากฏเป็นผลที่ค้นพบใหม่จากการจัดอันดับใหม่

ระบุแนวคิดความเกี่ยวข้องที่ต้องการ

สามารถเติมคำสั่งก่อนหรือหลังคำค้น รุ่นนี้อธิบายบทบาทมีประโยชน์สามแบบ ได้แก่ เน้นส่วนเฉพาะของเอกสาร เลือกชนิดแหล่งที่ต้องการ และลดความกำกวมคำค้นด้วยบริบทแอปพลิเคชัน สิ่งเหล่านี้เปลี่ยนโจทย์ความเกี่ยวข้องที่เสนอให้โมเดล

สำหรับการค้นเทคนิค คำสั่งตัวอย่างคือ “ให้ความสำคัญกับข้อความที่อธิบายพฤติกรรมเมื่อเกิดข้อผิดพลาดและการกู้คืน ภาพรวมเบื้องต้นเป็นเรื่องรอง” สำหรับชุดวิจัย ให้ระบุว่าชื่อเรื่อง วิธี หรือผลสำคัญที่สุด สำหรับคำกำกวม ให้บอกสาขาที่ค้น รักษาคำถามและคำสั่งให้เข้ากัน เพื่อไม่ให้ข้อหนึ่งถามหัวข้อกว้างขณะที่อีกข้อแอบเปลี่ยนงาน

ความต้องการเหล่านี้กำกับคะแนนความเกี่ยวข้อง หากแอปพลิเคชันมีข้อกำหนดคุณสมบัติเคร่งครัด เช่น เวอร์ชันแหล่ง วันที่ หรือขอบเขตเข้าถึง ให้เตรียมชุดตัวเลือกที่มีคุณสมบัติแยกต่างหาก คำสั่งความเกี่ยวข้องของโมเดลและข้อจำกัดชุดข้อมูลแบบกำหนดแน่นอนมีหน้าที่ต่างกัน

ผลตามอันดับและการใช้ภายหลัง

ผลเรียงตามความเกี่ยวข้องจากมากไปน้อย มีคะแนนความเกี่ยวข้องทศนิยมและดัชนีอินพุตเดิมของตัวเลือก ตัวเลือก top-k เลือกจำนวนผลอันดับต้นที่จะส่งกลับ หากไม่มี ข้อกำหนดผู้ผลิตส่งผลของทุกตัวเลือกที่ส่งให้ ตัวเลือก return-documents รวมข้อความต้นทางที่ตรงกัน มิฉะนั้นคำตอบมีดัชนีและคะแนน

ใช้ลำดับเลือกข้อความสำหรับแสดงหรือขั้นตอบภายหลัง โดยคงตัวตนแหล่งข้อมูลครบ ตรวจข้อความจริงเมื่อประเมินอันดับ คะแนนวัดความเกี่ยวข้องกับคำค้นที่ส่ง ไม่ใช่คำตอบที่สร้างหรือการยืนยันว่าข้อกล่าวอ้างในเอกสารถูกต้อง จึงมีประโยชน์ต่อการปรับเนื้อหาค้นหาเทคนิค กฎหมาย การเงิน การแพทย์ บทสนทนา และหลายภาษา โดยไม่เปลี่ยนการจัดอันดับเป็นข้อสรุปของโดเมน

บริบท งบโทเคนรวม และการตัดทอน

ขีดจำกัดคำค้นตามเอกสารคือ 8,000 โทเคน รวมคำสั่งที่อยู่ในคำค้น คำค้นรวมเอกสารตัวเลือกหนึ่งฉบับต้องไม่เกิน 32,000 โทเคน และรายการเอกสารมีได้สูงสุด 1,000 รายการ งบรวมคือ 600,000 โทเคน นับจากโทเคนคำค้นคูณจำนวนเอกสาร บวกโทเคนเอกสารทั้งหมด คำสั่งยาวจึงถูกนับซ้ำในตัวเลือกแต่ละคู่

จำนวน top-k ของผลลัพธ์ไม่เปลี่ยนจำนวนตัวเลือกในการคำนวณโทเคนอินพุต การตัดทอนเริ่มต้นย่อคำค้นหรือเอกสารที่เกินให้ตรงขีดจำกัดบริบท หากปิด คำค้นหรือคู่ที่ยาวเกินจะคืนข้อผิดพลาด เตรียมข้อความที่มีคำตอบอย่างตั้งใจและเก็บเงื่อนไขประกอบที่เกี่ยวข้องไว้ในเนื้อหาที่โมเดลจะเห็น ประเมินลำดับที่ปรับแล้วกับคำถามและคำสั่งที่เป็นตัวแทน จากนั้นส่งข้อความต้นฉบับที่เลือกไปขั้นต่อไป

Ailoot Ultra · จัดอันดับใหม่ POST /v1/rerank voyageai/rerank-2.5

voyageai/rerank-2.5

VoyageAI by MongoDB /voyageai/rerank-2.5

เริ่มต้น

อินพุตที่รองรับ: ข้อความ
ผลลัพธ์: ผลลัพธ์ที่จัดอันดับแล้ว

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · จัดอันดับใหม่ POST /v1/rerank

ขาเข้า: text
ขาออก: rerank
รูปแบบเอาต์พุต: json

ฟิลด์	ประเภท	ข้อกำหนด	ค่าและข้อจำกัด	ค่าเริ่มต้น
ฟิลด์`documents`	ประเภท`array`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด voyageai/rerank-2.5	ค่าเริ่มต้น—
ฟิลด์`provider`	ประเภท`schema`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`query`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`session_id`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`top_n`	ประเภท`integer`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด ขั้นต่ำ: 1	ค่าเริ่มต้น—
ฟิลด์`trace`	ประเภท`schema`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`user`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`documents[].text`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`documents[].image`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—

ชุดผสมของสื่ออินพุต

text_rerank · จำเป็น: query, documents array with minItems1

พารามิเตอร์และวงจรการทำงานของเมธอด

พารามิเตอร์	ข้อกำหนด
พารามิเตอร์`content_type`	ข้อกำหนดapplication/json
พารามิเตอร์`required`	ข้อกำหนดmodel, query, documents
พารามิเตอร์`material_types`	ข้อกำหนดtext
พารามิเตอร์`optional_controls`	ข้อกำหนดprovider, session_id, top_n, trace, user
พารามิเตอร์`multimodal_input_binding`	ข้อกำหนดnull

วงจรการทำงาน: synchronous

ส่ง ID โมเดลที่ตรงตามที่กำหนดและเก็บการตอบกลับรูปแบบดั้งเดิมทั้งหมด

ราคา

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว: ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น: ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด: ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราค่าบริการ Ailoot

ราคาตามการตั้งค่า

เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน

การตั้งค่า	ตารางอัตราค่าบริการ	หน่วยคิดค่าบริการ	ค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน	ตารางอัตราค่าบริการอัตราพื้นฐาน	หน่วยคิดค่าบริการ—	ค่าบริการ ขาเข้า · โทเค็นอินพุต — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต — / 1K โทเค็น ขาเข้า · การอ่านแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง — / 1K โทเค็น
การตั้งค่าUltra	ตารางอัตราค่าบริการ—	หน่วยคิดค่าบริการ/ 1K โทเค็น	ค่าบริการ ขาเข้า $0.0001 / 1K โทเค็น

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →

ตัวอย่างคำขอ

Ailoot Ultra · จัดอันดับใหม่

โครงสร้างคำขอทางการตามต้นฉบับ; ตัวอย่างประกอบเอกสารใช้ข้อมูลสำหรับคำขอจริงของคุณและเก็บผลลัพธ์ไว้ให้ครบถ้วน

{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5",
  "query": "What is the capital of France?",
  "top_n": 3
}

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']='voyageai/rerank-2.5'
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/rerank \
  -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 · จัดอันดับใหม่

json

เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน

เก็บดัชนีผลลัพธ์จริงทุกค่า relevance_score ที่เป็นจำนวนจำกัดทุกค่า และออบเจ็กต์เอกสารต้นฉบับทั้งหมด ดัชนีผูกกับอาร์เรย์เอกสารต้นฉบับ JSON ต้นฉบับทั้งหมดจะถูกจัดเก็บและส่งกลับหลังชำระบัญชีแล้วเท่านั้น

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

เก็บการดำเนินการเดิมและการตอบกลับทั้งหมด/บางส่วน อย่าส่ง POST ซ้ำ

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท
ฟิลด์`model`	ประเภทstring
ฟิลด์`id`	ประเภทstring
ฟิลด์`provider`	ประเภทstring
ฟิลด์`results[].index`	ประเภทinteger
ฟิลด์`results[].relevance_score`	ประเภทnumber
ฟิลด์`results[].document.text`	ประเภทstring
ฟิลด์`results[].document.image`	ประเภทstring
ฟิลด์`usage.search_units`	ประเภทinteger
ฟิลด์`usage.total_tokens`	ประเภทinteger
ฟิลด์`usage.cost`	ประเภทnumber

ข้อผิดพลาดและขั้นตอนถัดไป

การตอบกลับ	เงื่อนไข	ขั้นตอนถัดไป
การตอบกลับ400 · `invalid_request_error`	เงื่อนไขฟิลด์ที่จำเป็น รูปแบบข้อมูล หรือค่าไม่ถูกต้อง	ขั้นตอนถัดไปแก้ไขฟิลด์คำขอที่ระบุ

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra voyageai/rerank-2.5

ชื่อพาธเมธอดอื่น

ใช้พาธเมธอดที่แสดงด้านบน

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

voyageai/rerank-2.5

FAQ · VoyageAI by MongoDB: rerank-2.5

มีอินพุตและผลลัพธ์ใดบ้าง?: POST /v1/rerank · voyageai/rerank-2.5: text → rerank
คำขอใช้ฟิลด์ใดบ้าง?: POST /v1/rerank · voyageai/rerank-2.5: documents, model, provider, query, session_id, top_n, trace, user
มีข้อจำกัดใดบ้าง?: POST /v1/rerank · voyageai/rerank-2.5: top_n.minimum: 1

VoyageAI by MongoDB: rerank-2.5