vector-index-tuning

ベクトルインデックスのチューニング

本番環境のパフォーマンスに向けてベクトルインデックスを最適化するためのガイドです。

このスキルを使用する場合

• HNSW パラメータをチューニングするとき
• 量子化を実装するとき
• メモリ使用量を最適化するとき
• 検索レイテンシを削減するとき
• 再現率と速度のバランスを取るとき
• 数十億のベクトルにスケールするとき

このスキルを使用しない場合

• 小規模なデータセットで正確な検索のみが必要な場合（フラットインデックスを使用してください）
• ワークロードのメトリクスや、再現率を検証するための正解データがない場合
• インデックスのチューニングを超えたエンドツーエンドの検索システム設計が必要な場合

手順

1. ワークロードの目標（レイテンシ、再現率、QPS）、データサイズ、メモリ予算を収集します。
2. インデックスの種類を選択し、デフォルトのパラメータでベースラインを確立します。
3. 実際のクエリを使用してパラメータスイープをベンチマークし、再現率、レイテンシ、メモリを追跡します。
4. 本番環境に展開する前に、ステージングデータセットで変更を検証します。

詳細なパターン、チェックリスト、テンプレートについては resources/implementation-playbook.md を参照してください。

安全性

• ロールバック計画なしに本番環境で再インデックス化しないでください。
• グローバルに適用する前に、現実的な負荷の下で変更を検証してください。
• 再現率の低下を追跡し、品質が低下した場合は元に戻してください。

リソース

• 詳細なパターン、チェックリスト、テンプレートについては resources/implementation-playbook.md。

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、停止して確認を求めてください。