Dokumen ini menjelaskan cara membuat embedding teks menggunakan Text embeddings API Vertex AI.
Embedding teks adalah representasi vektor padat dari teks. Misalnya, model gemini-embedding-001 menghasilkan vektor 3072 dimensi untuk teks tertentu. Embedding vektor padat ini dibuat menggunakan metode deep learning yang serupa dengan yang digunakan oleh model bahasa besar.
Tidak seperti vektor renggang yang memetakan kata ke angka, vektor padat dirancang untuk merepresentasikan makna semantik teks. Manfaat utama penggunaan embedding vektor padat adalah kemampuan untuk melakukan penelusuran semantik. Daripada menelusuri kecocokan kata atau sintaksis langsung, Anda dapat menelusuri bagian teks yang sesuai dengan makna kueri Anda, meskipun bagian teks tersebut tidak menggunakan frasa yang sama.
Vektor embedding dinormalisasi, sehingga Anda dapat menggunakan kesamaan kosinus, perkalian titik, atau jarak Euclidean untuk mendapatkan peringkat kesamaan yang sama.
- Untuk mempelajari penyematan lebih lanjut, lihat ringkasan API penyematan.
- Untuk mempelajari model embedding teks, lihat Embedding teks.
- Untuk mengetahui informasi tentang bahasa yang didukung setiap model embedding, lihat Bahasa teks yang didukung.

Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Vertex AI API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Enable the Vertex AI API.
- Pilih jenis tugas untuk tugas penyematan Anda.
- Untuk mempelajari batas laju lebih lanjut, lihat Batas laju AI Generatif di Vertex AI.
- Untuk mendapatkan prediksi batch untuk embedding, lihat Mendapatkan prediksi embedding teks batch
- Untuk mempelajari lebih lanjut embedding multimodal, lihat Mendapatkan embedding multimodal
- Untuk menyesuaikan embedding, lihat Menyesuaikan embedding teks
- Untuk mempelajari lebih lanjut riset di balik
text-embedding-005
dantext-multilingual-embedding-002
, lihat makalah penelitian Gecko: Versatile Text Embeddings Distilled from Large Language Models.
Model yang didukung
Anda bisa mendapatkan embedding teks dengan menggunakan model berikut:
Nama model | Deskripsi | Dimensi Output | Panjang urutan maksimum | Bahasa teks yang didukung |
---|---|---|---|---|
gemini-embedding-001 |
Performa canggih untuk tugas bahasa Inggris, multibahasa, dan kode. Model ini menyatukan model khusus sebelumnya seperti text-embedding-005 dan text-multilingual-embedding-002 serta mencapai performa yang lebih baik di domain masing-masing. Baca Laporan Teknis kami untuk mengetahui detail selengkapnya. |
hingga 3072 | 2048 token | Bahasa teks yang didukung |
text-embedding-005 |
Khusus dalam tugas bahasa Inggris dan kode. | hingga 768 | 2048 token | Inggris |
text-multilingual-embedding-002 |
Khusus dalam tugas multibahasa. | hingga 768 | 2048 token | Bahasa teks yang didukung |
Untuk kualitas embedding yang lebih unggul, gemini-embedding-001
adalah model besar kami yang dirancang untuk memberikan performa tertinggi. Perhatikan bahwa
gemini-embedding-001
mendukung satu instance per permintaan.
Mendapatkan embedding teks untuk cuplikan teks
Anda bisa mendapatkan embedding teks untuk cuplikan teks dengan menggunakan Vertex AI API atau Vertex AI SDK untuk Python.
Batas API
Untuk setiap permintaan, Anda dibatasi hingga 250 teks input.
API memiliki batas token input maksimum 20.000.
Input yang melebihi batas ini akan menghasilkan error 400. Setiap teks input individual
dibatasi lebih lanjut hingga 2.048 token; kelebihan token akan dipangkas tanpa pemberitahuan. Anda juga
dapat menonaktifkan pemotongan senyap dengan menyetel autoTruncate
ke false
.
Untuk mengetahui informasi selengkapnya, lihat Batas embedding teks.
Pilih dimensi penyematan
Semua model menghasilkan vektor embedding panjang penuh secara default. Untuk gemini-embedding-001
,
vektor ini memiliki 3.072 dimensi, dan model lain menghasilkan vektor 768 dimensi. Namun, dengan
menggunakan parameter output_dimensionality
, pengguna dapat mengontrol ukuran vektor embedding output.
Memilih dimensi output yang lebih kecil dapat menghemat ruang penyimpanan dan meningkatkan efisiensi komputasi untuk aplikasi hilir, sekaligus sedikit mengorbankan kualitas.
Contoh berikut menggunakan model gemini-embedding-001
.
Python
Instal
pip install --upgrade google-genai
Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.
Tetapkan variabel lingkungan untuk menggunakan Gen AI SDK dengan Vertex AI:
# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values # with appropriate values for your project. export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT export GOOGLE_CLOUD_LOCATION=global export GOOGLE_GENAI_USE_VERTEXAI=True
Menambahkan embedding ke database vektor
Setelah membuat embedding, Anda dapat menambahkan embedding ke database vektor, seperti Vector Search. Hal ini memungkinkan pengambilan dengan latensi rendah, dan sangat penting seiring bertambahnya ukuran data Anda.
Untuk mempelajari Vector Search lebih lanjut, lihat Ringkasan Vector Search.