Voyage AI: Voyage Code 3

Voyage Code 3は、ソースコードの検索に特化した埋め込みモデルです。開発元は、自然言語からコード、コードからコード、docstringからコードを探す作業を説明しています。質問から実装を探し、コード断片から関連するロジックを探し、関数の説明から関連するコードを見つけられます。モデルが生成するのは検索用のベクトルであり、編集済みのファイルや完成したプログラムではありません。

意味のあるコード単位に沿って、リポジトリの資料を用意します。関数は、その名前、シグネチャ、目的を説明するコメントとまとめて保持してください。大きいコンポーネントでは、操作の理解に必要な近くの定義を含めます。リポジトリ、リビジョン、ファイルパス、行の位置を別に保存し、検索結果から、埋め込みに使った正確なソースを開けるようにします。

自然言語の検索では、保存前にアップロードを検証する箇所をプロジェクト内で探す、といった動作を説明できます。コードに基づくクエリでは、他の場所で同じ目的を持つ処理を見つけたい関数を渡せます。見慣れない命名、似た実装、周辺のコードに意味が依存するユーティリティを含め、実際の開発作業から代表的な検索を選んでください。

32,000トークンのコンテキストウィンドウには、十分な量のコードを含められます。その領域を意図して使ってください。制御フローの途中で任意に切り出したブロックより、完全な関数と関連する依存先の方が、多くの情報を伝えられる場合があります。抽出時は、ソースの書式を読みやすく保ち、言語の構文を維持します。ソースファイルが入力ウィンドウを超える場合は、有用な構造の境界で分割し、各断片と元のファイルの関係を保持してください。

Voyage Code 3は、2,048、1,024、512、256次元の埋め込みと、浮動小数点、符号付きまたは符号なしの8ビット、バイナリーの表現に対応します。これらの設定は、リポジトリ索引のサイズや検索構成の選択を支えます。小さい表現は、大きい表現を基準として同じ実際の検索で評価し、正しい関数やファイルが有用な結果の中に残るかを確かめてください。

コーディングアシスタントでは、まず関連するソースの断片を取得し、その断片とファイル参照を、回答や変更を担当するコンポーネントに渡します。類似した一致は文脈選びに役立ちますが、二つの実装を置き換えてよいことを証明するものではありません。編集の指針に使う前に、取得したコードの入力、副作用、周囲の契約を確認してください。

リポジトリの関係のない版をメタデータで分離し、索引に登録したリビジョンを追跡できるようにします。関数が移動したり動作が変わったりした場合は、ベクトルとソース位置の両方を更新してください。索引に登録するソースとクエリには、同じ埋め込み設定を使います。索引を移行する際は、モデルやベクトル表現の変更によって開発者に見えるコードが気付かないうちに変わらないよう、既存の質問の集合で結果を比較します。

有用な確認には、クエリがテスト名だけでなく実際の実装を見つけるか、docstringが対応する関数を見つけるか、意味が関連するコードを表面的に似た断片から区別できるかがあります。開発者が根拠を確認できるよう、返されたソースのテキストと位置を検索結果に残してください。これにより、コードに特化したモデルの埋め込みを、実用的な移動と文脈選択のツールにできます。