取得批次回應可有效率地傳送大量非延遲敏感的嵌入要求。與線上回覆不同,您一次只能發出一項輸入要求,但可以一次傳送大量嵌入要求。與 Gemini Enterprise Agent Platform 中表格資料的批次推論類似,您可決定輸出位置、新增輸入內容,系統會將回覆非同步填入輸出位置。
Gemini Embedding 批次預測 (預先發布版)
Gemini Embedding 批次推論 (搶先版) 採用更新的輸入和輸出結構定義。每個批次工作最多支援 1,000,000 個資料列,每個專案最多支援佇列中 10,000 個並行批次工作。
如要瞭解端點和適用位置,請參閱「位置」。
JSONL 輸入範例
Gemini Embedding 001
gemini-embedding-001 模型支援為每個資料列設定工作類型和標題。
{"key": "id_1", "request": {"content": {"parts": [{"text": "Hello World"}]}, "embed_content_config":{"output_dimensionality": 768, "title": "some_title", "task_type": "RETRIEVAL_DOCUMENT"}}}
{"key": "id_2", "request": {"content": {"parts": [{"text": "Hello World again"}]}, "embed_content_config":{"output_dimensionality": 768, "title": "some_title_2", "task_type": "RETRIEVAL_DOCUMENT"}}}
Gemini Embedding 2
gemini-embedding-2 模型預期提示中直接內嵌工作類型和標題。
{"key": "id_1", "request": {"content": {"parts": [{"text": "title: sample | text: Hello World"}]}, "embed_content_config":{"output_dimensionality": 768}}}
{"key": "id_2", "request": {"content": {"parts": [{"fileData": {"fileUri": "gs://cloud-samples-data/generative-ai/image/benchmark.jpeg", "mimeType": "image/jpeg"}}]}, "embed_content_config":{"output_dimensionality": 768}}}
JSONL 輸出內容範例
{"key": "id_1", "request": {...}, "response": {"tokenCount": "2", "embedding": {"values": [-0.015, 0.024, ...]}}}
{"key": "id_2", "request": {...}, "response": {"tokenCount": "3", "embedding": {"values": [-0.075, 0.031, ...]}}}
其他資源
如要進一步瞭解如何對 Gemini 嵌入模型使用批次推論,請參閱 Batch Prediction API 參考資料。
舊版 Embedding 批次預測
支援批次推論的文字嵌入模型
所有舊版文字嵌入模型穩定版都支援批次推論,且完全支援實際工作環境。如要查看完整的嵌入模型清單,請參閱「嵌入模型和版本」。
準備輸入內容
批次要求的輸入內容是提示清單,可儲存在 BigQuery 資料表中,或儲存在 Cloud Storage 中的 JSON Lines (JSONL) 檔案。每項要求最多可包含 30,000 個提示。
JSONL 範例
本節提供 JSONL 輸入和輸出格式的範例。
JSONL 輸入範例
{"content":"Give a short description of a machine learning model:"}
{"content":"Best recipe for banana bread:"}
JSONL 輸出內容範例
{"instance":{"content":"Give..."},"predictions": [{"embeddings":{"statistics":{"token_count":8,"truncated":false},"values":[0.2,....]}}],"status":""}
{"instance":{"content":"Best..."},"predictions": [{"embeddings":{"statistics":{"token_count":3,"truncated":false},"values":[0.1,....]}}],"status":""}
BigQuery 範例
本節提供範例,說明如何設定 BigQuery 輸入和輸出格式。
BigQuery 輸入範例
這個範例顯示單一資料欄的 BigQuery 資料表。
| 內容 |
|---|
| 「簡要說明機器學習模型:」 |
| 「香蕉麵包的最佳食譜:」 |
BigQuery 輸出範例
| 內容 | 預測 | 狀態 |
|---|---|---|
| 「簡要說明機器學習模型:」 |
'[{"embeddings": { "statistics":{"token_count":8,"truncated":false}, "Values":[0.1,....] } } ]' |
|
| 「香蕉麵包的最佳食譜:」 |
'[{"embeddings": { "statistics":{"token_count":3,"truncated":false}, "Values":[0.2,....] } } ]' |
要求批次回應
視您提交的輸入項目數量而定,批次生成工作可能需要一些時間才能完成。
REST
您可以向發布者模型端點傳送 POST 要求,使用 REST API 批次取得文字嵌入。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID:專案的 ID。 Google Cloud
- BP_JOB_NAME:工作名稱。
- INPUT_URI:輸入來源 URI。這是 BigQuery 資料表 URI 或 Cloud Storage 中的 JSONL 檔案 URI。
- OUTPUT_URI:輸出目標 URI。
HTTP 方法和網址:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/batchPredictionJobs
JSON 要求內文:
{
"name": "BP_JOB_NAME",
"displayName": "BP_JOB_NAME",
"model": "publishers/google/models/textembedding-gecko",
"inputConfig": {
"instancesFormat":"bigquery",
"bigquerySource":{
"inputUri" : "INPUT_URI"
}
},
"outputConfig": {
"predictionsFormat":"bigquery",
"bigqueryDestination":{
"outputUri": "OUTPUT_URI"
}
}
}
如要傳送要求,請選擇以下其中一個選項:
curl
將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/batchPredictionJobs"
PowerShell
將要求主體儲存在名為 request.json 的檔案中,然後執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/batchPredictionJobs" | Select-Object -Expand Content
您應該會收到如下的 JSON 回覆:
{
"name": "projects/123456789012/locations/us-central1/batchPredictionJobs/1234567890123456789",
"displayName": "BP_sample_publisher_BQ_20230712_134650",
"model": "projects/{PROJECT_ID}/locations/us-central1/models/textembedding-gecko",
"inputConfig": {
"instancesFormat": "bigquery",
"bigquerySource": {
"inputUri": "bq://project_name.dataset_name.text_input"
}
},
"modelParameters": {},
"outputConfig": {
"predictionsFormat": "bigquery",
"bigqueryDestination": {
"outputUri": "bq://project_name.llm_dataset.embedding_out_BP_sample_publisher_BQ_20230712_134650"
}
},
"state": "JOB_STATE_PENDING",
"createTime": "2023-07-12T20:46:52.148717Z",
"updateTime": "2023-07-12T20:46:52.148717Z",
"labels": {
"owner": "sample_owner",
"product": "llm"
},
"modelVersionId": "1",
"modelMonitoringStatus": {}
}
在指令中替換下列變數:
PROJECT_ID: Google Cloud 專案 ID。LOCATION:傳送要求的地點。GCS_SOURCE_BUCKET:Cloud Storage 來源 bucket URI。GCS_OUTPUT_BUCKET:Cloud Storage 輸出 bucket URI。curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://${LOCATION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${LOCATION}/batchPredictionJobs"
Python
安裝
pip install --upgrade google-genai
詳情請參閱 SDK 參考文件。
設定環境變數,透過 Vertex AI 使用 Google Gen AI SDK:
# 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=us-central1 export GOOGLE_GENAI_USE_ENTERPRISE=True
Go
瞭解如何安裝或更新 Go。
詳情請參閱 SDK 參考文件。
設定環境變數,透過 Vertex AI 使用 Google Gen AI SDK:
# 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=us-central1 export GOOGLE_GENAI_USE_ENTERPRISE=True
Node.js
安裝
npm install @google/genai
詳情請參閱 SDK 參考文件。
設定環境變數,透過 Vertex AI 使用 Google Gen AI SDK:
# 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=us-central1 export GOOGLE_GENAI_USE_ENTERPRISE=True
Java
瞭解如何安裝或更新 Java。
詳情請參閱 SDK 參考說明文件。
設定環境變數,透過 Vertex AI 使用 Google Gen AI SDK:
# 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=us-central1 export GOOGLE_GENAI_USE_ENTERPRISE=True
擷取批次輸出內容
批次推論工作完成後,輸出內容會儲存在您在要求中指定的 Cloud Storage bucket 或 BigQuery 資料表。
後續步驟
- 瞭解如何取得文字嵌入。