- PENDING
- RUNNING
- COMPLETED
- FAILED
すぐに答え
レート制限に触れずに巨大なデータセットをベクトル化するには?
バックグラウンドのバッチジョブを使用して、ファイルを一括処理します。AIがジョブを起動し、ステータスを監視し、APIの処理が完了したタイミングで結果を取得します。
データの状態について
バッチ処理の結果
ジョブが完了すると、データは以下のいずれかの状態になります。
PENDING
キュー待ち
APIがリクエストを受理しました。AIはバッチがキューから実行中のプロセスへ移動するのを待機します。
RUNNING
実行中
現在、バッチのベクトル化が行われています。AIは定期的にステータスを確認し、進捗状況を把握できます。
COMPLETED
完了
ジョブが正常に終了しました。AIは、後続のタスクのために完了した埋め込みデータにアクセスできます。
FAILED
エラー発生
バッチ処理中に問題が発生しました。エラーログを確認し、元のファイルをどのように修正すべきか判断する必要があります。
ワークフロー
データ到着後のAIの動き
AIがバッチジョブのライフサイクルを管理するため、手動でAPIをポーリングする必要はありません。
データの準備
AIは、埋め込み処理の準備として、生のドキュメントをVoyage AIのストレージに送信します。
upload_fileジョブの開始
AIはAPIに対し、アップロードされたファイルを一つの大きなバッチとして処理するよう指示します。
create_batch進捗の追跡
AIはジョブのステータスを確認し、実行中か、あるいは完了したかを判断します。
get_batch履歴の確認
AIは過去のジョブを検索し、特定のバッチIDの特定や最近のアクティビティの確認を行います。
list_batches
試してみる
以下のプロンプトをコピーして開始
これらのプロンプトを使って、最初のバッチジョブを開始しましょう。
出発点
括弧内のテキストを、実際のファイル名やバッチIDに書き換えて使用してください。
Voyage AI Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_x7lwFbbAdz5StvxoOu2Tkh9eDMu9Uh5i3GKObLMP/mcpClaude Desktop
以下の手順で数秒で接続できます。
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Voyage AI capabilities are ready to use.
{
"mcpServers": {
"voyage-ai-ai-embeddings-api-mcp": {
"url": "https://edge.vinkius.com/vk_preview_x7lwFbbAdz5StvxoOu2Tkh9eDMu9Uh5i3GKObLMP/mcp"
}
}
}このPDFをアップロードして、新しいバッチジョブを開始してください。
前回のバッチジョブのステータスを確認してください。
最近実行したすべてのバッチジョブをリストアップしてください。
バッチジョブ [ID] はもう完了しましたか?
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
ここから始める
Voyage AIを一度接続するだけで、すぐに指示できます
アカウントの連携は一度だけで済みます。認証情報は暗号化されて保持されるため、すぐにAIクライアントからバッチ管理を開始できます。
Voyage AIをAIに接続するFAQ
動作に関する詳細
- 01
AIはアップロードしたファイルを削除できますか?
いいえ。現在のツールでは、ファイルのアップロードとバッチジョブの管理のみが可能です。
- 02
AIはバッチが完了するまで回答を待機しますか?
指示の出し方によります。ステータスを確認するよう指示することも、完了するまで監視し続けるよう指示することも可能です。
- 03
バッチの途中で埋め込みモデルを変更できますか?
いいえ。一度バッチジョブが作成されると、そのジョブに対してパラメータが固定されます。
- 04
AIは他のAPIアクティビティを閲覧できますか?
いいえ。AIがアクセスできるのは、Voyage AIツールによって提供される特定の操作のみです。
- 05
AIはどうやってジョブの失敗を検知しますか?
AIはバッチステータスツールを使用してエラー状態を確認し、その結果をユーザーに報告します。
Voyage AIについて他に質問がありますか? Voyage AI MCPの全機能を見る
『Voyage AI』を Claude、Cursor、ChatGPT などに接続
