Sentence Transformers: multi-qa-mpnet-base-dot-v1
Sentence Transformers multi-qa-mpnet-base-dot-v1 mengodekan pertanyaan dan bagian teks menjadi vektor 768 dimensi untuk pencarian semantik. Model menggunakan pooling CLS dan embedding yang tidak dinormalisasi untuk penilaian hasil kali titik, dengan batas masukan 512 unit word piece.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
multi-qa-mpnet-base-dot-v1 adalah model Sentence Transformers yang dirancang untuk menemukan bagian teks bagi pertanyaan atau kueri. Pelatihannya menggunakan sekitar 215 juta pasangan tanya–jawab. Setiap masukan menjadi vektor dense 768 dimensi, dengan pooling CLS dan penilaian hasil kali titik yang menentukan edisi tepat ini.
Siapkan pertanyaan dan bagian kandidat
Tulis kueri sebagai kebutuhan informasi dan siapkan entri korpus sebagai bagian teks yang dapat dibaca. Misalnya, pertanyaan tentang perubahan alamat pengiriman dapat dibandingkan dengan paragraf terpisah tentang perubahan alamat, pembatalan pesanan, dan pelacakan pengiriman. Pertahankan kondisi yang relevan dalam bagian perubahan alamat, termasuk apakah pesanan sudah dikirim.
Kodekan kueri dan bagian teks dengan model yang sama ini. Contoh yang diterbitkan melakukannya langsung, tanpa prefiks query/document, lalu mengurutkan bagian berdasarkan skor hasil kali titiknya. Pertahankan hubungan setiap vektor dengan bagian asli dan pengenal dokumen agar hasil berperingkat dapat menunjukkan materi yang benar-benar diindeks.
Pooling CLS dan edisi hasil kali titik
Resep rujukan model mengambil representasi token pertama, yang dikenal sebagai pooling CLS. Tabel teknisnya secara eksplisit menyatakan bahwa embedding tidak dinormalisasi dan mencantumkan hasil kali titik sebagai fungsi penilaian yang sesuai. Pertahankan resep tersebut saat menyiapkan koleksi dan sisi kueri.
Normalisasi L2 pada vektor ini mengubah geometri penilaiannya. Profil all-mpnet-base-v2 yang dinormalisasi menggunakan resep berbeda dan merupakan checkpoint terpisah, meskipun berbagi keluarga MPNet dan keluaran 768 komponen. Simpan edisi tepat dan fungsi perbandingan bersama koleksi tersimpan alih-alih memilihnya hanya berdasarkan panjang vektor.
Batas panjang dan bagian yang lebih panjang
Batas masukan yang dinyatakan adalah 512 unit word piece; teks lebih panjang dipotong. Pembuat juga mencatat bahwa masukan pelatihan hanya mencapai 250 unit word piece dan teks lebih panjang mungkin bekerja kurang baik. Karena itu, panjang yang diterima tokenizer dan catatan panjang pelatihan menjelaskan batas praktis berbeda.
Untuk artikel bantuan besar, siapkan bagian pendek yang menjawab pertanyaan spesifik. Pertahankan judul ketika mengidentifikasi topik, dan simpan aturan bersama pengecualian yang dibutuhkan untuk membacanya dengan benar. Satu masukan halaman penuh mungkin kehilangan materi berikutnya akibat pemotongan, sedangkan fragmen terlalu kecil dapat kehilangan kondisi yang membuatnya berguna.
Gunakan peringkat dalam temu kembali dan RAG
Vektor dense mendukung tahap awal temu kembali. Kembalikan bagian kandidat berskor tertinggi bersama rujukan sumber, lalu periksa apakah bagian tersebut menjawab pertanyaan sebenarnya. Dalam alur RAG, berikan bagian-bagian itu sebagai materi sumber kepada tahap penulisan jawaban; temu kembali sendiri tidak menyusun jawaban.
Gunakan pertanyaan yang representatif dengan bagian relevan yang diketahui untuk memilih jumlah hasil dan menilai peringkat. Sertakan contoh dengan kosakata serupa tetapi maksud berbeda, seperti mengubah alamat dibanding melihat alamat saat ini. Tafsirkan skor relatif terhadap kandidat di bawah model dan pengaturan penilaian yang sama, bukan sebagai probabilitas kebenaran yang terkalibrasi.
Keluaran berguna checkpoint ini adalah ruang embedding pertanyaan dan bagian teks untuk pencarian semantik. Vektor yang tidak dinormalisasi, pooling CLS, skor hasil kali titik, dan catatan masukan panjang yang diterbitkan merupakan detail yang perlu dipertahankan saat menyiapkan serta menggunakan hasil.
Ailoot Ultra · Embedding POST /v1/embeddings sentence-transformers/multi-qa-mpnet-base-dot-v1
sentence-transformers/multi-qa-mpnet-base-dot-v1
sentence-transformers/multi-qa-mpnet-base-dot-v1Mulai
Sentence Transformers multi-qa-mpnet-base-dot-v1 mengodekan pertanyaan dan bagian teks menjadi vektor 768 dimensi untuk pencarian semantik. Model menggunakan pooling CLS dan embedding yang tidak dinormalisasi untuk penilaian hasil kali titik, dengan batas masukan 512 unit word piece.
- Masukan yang diterima
- Teks · token_ids
- Hasil
- embedding
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Embedding POST /v1/embeddings
- Masukan
text,token_ids- Keluaran
embedding- Format keluaran
- json
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan sentence-transformers/multi-qa-mpnet-base-dot-v1 | Bawaan— |
Kolominput | Jenisstring|string[]|integer[]|integer[][] | PersyaratanWajib | Nilai & batasan Item minimum: 1 Kondisi: Batch homogen yang tidak kosong. ID token berupa bilangan bulat nonnegatif. Anggaran masukan: Maksimum: 512 · Satuan teks: byte UTF8 · Satuan token: elemen array token | Bawaan— |
Kolomencoding_format | Jenisstring | PersyaratanOpsional | Nilai & batasan float | Bawaanfloat |
Kolomdimensions | Jenisinteger | PersyaratanTidak didukung | Nilai & batasan Minimum: 1 | Bawaan— |
Kolomuser | Jenisjson_value | PersyaratanOpsional | Nilai & batasan Kondisi: Sumber mengizinkan kolom metadata JSON ini; makna tepatnya pada layanan hulu bergantung pada model. | Bawaan— |
Kolomsession_id | Jenisjson_value | PersyaratanOpsional | Nilai & batasan Kondisi: Sumber mengizinkan kolom metadata JSON ini; makna tepatnya pada layanan hulu bergantung pada model. | Bawaan— |
Kolomtrace | Jenisjson_value | PersyaratanOpsional | Nilai & batasan Kondisi: Sumber mengizinkan kolom metadata JSON ini; makna tepatnya pada layanan hulu bergantung pada model. | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan Kondisi: provider.options ditolak | Bawaan— |
Kombinasi bahan masukan
text_to_embedding
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input |
Parameterinput_shapes | Kontrakstring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parameterencoding_format | Kontrakfloat |
Parameterdimensions_override | Kontrakfalse |
Parametermax_input_budget_units | Kontrak512 |
Parametermultimodal_objects | Kontrakfalse |
Parametermaterial_types | Kontraktext, token_ids |
Siklus hidup: synchronous_json
Pertahankan index dan dimensi setiap vektor.
Nama model multimodal tidak mengizinkan objek gambar pada jalur persis ini.
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Tarif Ailoot
Harga menurut konfigurasi
| Konfigurasi | Jadwal tarif | Biaya |
|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Biaya Masukan · Token masukan $0.00001 / 1K token Keluaran · Token keluaran $0 / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Embedding
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "sentence-transformers/multi-qa-mpnet-base-dot-v1", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-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
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='sentence-transformers/multi-qa-mpnet-base-dot-v1',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
Terima dan simpan hasil
Ailoot Ultra · Embedding
json
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.
Simpan setiap vektor beserta index masing-masing. Jumlah vektor harus sama dengan jumlah input; dimensinya harus konsisten.
Jika respons asli perlu diperiksa
Endpoint untuk tugas embedding tidak ditambahkan.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomobject | Jenisstring |
Kolommodel | Jenisstring |
Kolomdata[].index | Jenisinteger |
Kolomdata[].embedding | Jenisfinite float[] |
Kolomusage | Jenisobject |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Alias
Alias model
Ailoot Ultra sentence-transformers/multi-qa-mpnet-base-dot-v1
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Sentence Transformers: multi-qa-mpnet-base-dot-v1
- Input dan hasil apa yang tersedia?
POST /v1/embeddings·sentence-transformers/multi-qa-mpnet-base-dot-v1:text,token_ids→embedding- Kolom apa yang digunakan permintaan?
POST /v1/embeddings·sentence-transformers/multi-qa-mpnet-base-dot-v1:model,input,encoding_format,provider- Batasan apa yang berlaku?
POST /v1/embeddings·sentence-transformers/multi-qa-mpnet-base-dot-v1:input.budget.maximum:512(byte UTF8);input.min_items:1