なぜ検索システムは複雑になるのか
近年、AI研究やサービス開発において「検索」の重要性は増す一方です。特に論文検索のように正確性が重視されるドメインでは、単純なキーワードマッチングだけでは不十分です。「小さな言語モデルでコード生成するには?」というクエリに対し、論文タイトルにその単語が完全一致していなくても、関連性を見つけ出す必要があります。
Papers with Codeチームはこの課題を解決するため、キーワード検索とベクター検索を組み合わせたハイブリッドアーキテクチャを採用しました。本記事では、彼らがどのようにして110,000件以上の論文に対する埋め込みを生成し、リアルタイム検索サービスを運用しているのか、その設計思想を分析します。
本記事の焦点
単なる技術スタックの羅列ではなく、「バッチ処理」と「リアルタイム処理」という相反する性質のワークロードを、いかに分離し接続したかが核心です。これは検索システムに留まらず、機械学習モデルをプロダクションに統合するあらゆる開発者にとって有効な設計パターンを示しています。
設計の核心: バッチ処理とリアルタイム処理の分離
このアーキテクチャで最も重要な決定は、埋め込み生成処理を2つの経路に分離したことです。
- オフラインバッチ: 全論文コーパスを対象とした大規模な埋め込み生成。スループットが重要であり、GPUを限定的な時間のみ使用します。
- オンラインサービス: ユーザーの検索クエリをリアルタイムに埋め込む処理。レイテンシが重要であり、常時稼働が求められます。
これらを単一のシステムに統合しようとすれば、コストがかさみ、性能も最適化できない可能性が高まります。この記事では、この分離のために Hugging Faceの3つのサービスをどのように組み合わせたのかを詳述します。

構成要素の分析: Jobs、Buckets、Inference Endpoints
各サービスの役割を図式化すると以下の通りです。
- Hugging Face Jobs: GPUインスタンスを起動し、大規模なバッチ処理を実行します(例: NVIDIA L4 GPU)。
- Hugging Face Storage Buckets: Jobsの出力結果やデータスナップショットなど、中間生成物を保存するストレージです。
- Hugging Face Inference Endpoints: リアルタイムのクエリ埋め込みや、少量の差分更新を処理する常時稼働のサーバーです。
# 概念実証のための簡易コード構造 (実際の実装は公式ドキュメント参照)
# 1. バッチ処理 (Jobs): DBスナップショットを読み込み、全論文の埋め込みを生成
def run_embedding_job(snapshot_path: str, output_path: str):
"""全コーパスに対する埋め込みを生成し保存する仮想的なバッチ処理"""
papers = load_papers_from_snapshot(snapshot_path)
embeddings = []
for batch in chunk(papers, batch_size=64):
vectors = embedding_model.encode_document(batch)
embeddings.extend(vectors)
save_embeddings_to_parquet(output_path, embeddings)
# 2. オンライン検索 (Inference Endpoints): ユーザークエリをベクトル化しDBで検索
@app.get("/search")
def search_papers(query: str):
"""リアルタイム検索API: クエリを埋め込み、PostgreSQLでベクター検索を実行"""
query_vector = embedding_model.encode_query(query)
# pgvectorを使用した類似度検索 (例: cosine distance)
results = db.execute(
"""
SELECT paper_id, embedding <=> :query_vector AS distance
FROM paper_embeddings
ORDER BY distance
LIMIT 50
""",
{"query_vector": query_vector}
)
return results
なぜこの構造が効率的なのか
| 特性 | バッチ処理 (Jobs) | リアルタイム処理 (Inference Endpoints) |
|---|---|---|
| ワークロード | 大量データ処理、高スループット | 少量リクエスト、低レイテンシ |
| リソース | 必要な時だけGPUインスタンスを使用 | 常時稼働またはオートスケーリング |
| コスト最適化 | Scale-to-zero 可能 | コールドスタートを考慮した設計が必要 |
| 障害処理 | 再試行・再開が容易 | 高速タイムアウトとフォールバックが必須 |
この表からも分かるように、2つの処理の性質は完全に異なるため、インフラを分離することは合理的です。特に、Storage Bucketsが2つのシステム間の「契約」の役割を果たしている点が印象的です。処理の出力はチェックサムとマニフェストと共に保存され、その後の検証やロールバックを容易にします。
ハイブリッド検索の力: RRFと障害耐性
このシステムの検索品質の核心は、**相互ランク融合(Reciprocal Rank Fusion, RRF)アルゴリズムです。キーワード検索とベクター検索の結果を単純に結合するのではなく、それぞれの順位(Rank)**に基づいてスコアを計算し、よりインテリジェントに結果を統合します。
RRFの利点
- スコア体系に依存しない: キーワード検索のBM25スコアとベクター検索のコサイン類似度はスケールが異なり、直接比較できません。RRFは順位のみを使用するため、この問題を解決します。
- 頑健性: 2つの検索システムの一方が不正確でも、もう一方が結果を補完できます。
実運用環境の設計思想
このアーキテクチャで最も重要な部分は、Inference Endpointsが失敗した際の動作です。システムは性能低下を「例外的な状況」とは見なさず、基本的な動作環境の一部と見なします。
- 短いタイムアウト: クエリ埋め込みに1秒のタイムアウトを設定。
- サーキットブレーカー: 連続失敗時は即座にベクター検索経路を遮断。
- 自動フォールバック: ベクター検索が不能な場合は常にキーワード検索結果のみを返す。
このような設計は、検索システムが単一障害点に依存しないようにします。これは、「可用性」と「完全な正確性」の間のバランスを模索する中で生まれた決定です。

批判的考察: このアーキテクチャの欠陥と注意点
この設計は非常に優れていますが、あらゆる状況に完璧な解決策というわけではありません。実際に導入を検討する際には、以下の限界点を必ず認識する必要があります。
1. インフラストラクチャの複雑化
単にPostgreSQLだけで検索を実装する場合と比較して、Jobs、Buckets、専用エンドポイントを運用することは、明らかにインフラの複雑さを増大させます。小規模なサービスや初期段階のスタートアップには過剰なエンジニアリングになり得ます。記事内でも言及されているように、まずキーワード検索で十分かどうかを検証する方がより合理的なアプローチです。
2. 埋め込みモデルへの高い依存度
システムの性能は、選択した埋め込みモデル(Qwen3-Embedding-0.6B)の品質に大きく左右されます。モデルが更新または交換されるたびに、全コーパスに対する再埋め込みが必要になる可能性があり、これはかなりの時間とコストがかかる作業です。埋め込みバージョン管理の重要性をこの事例で再確認できます。
3. 日本語サポートの問題
このシステムは基本的に英語の論文を対象としています。日本語検索にこの構造をそのまま適用しようとする場合、日本語特化の埋め込みモデルの選択が非常に重要になります。日本語は膠着語的な特性があるため、トークナイゼーション方式によって検索品質に大きな差が生じる可能性があります。また、日本語特有の分かち書きの誤りや新語に頑健な形態素解析器が必要かどうかも追加で検討する必要があります。
まとめ: 検索を一つの「プロダクト」として捉える
今回の事例から得られる最大の教訓は、検索を単なる機能ではなく、一つの「プロダクト」として捉えるべきだということです。単に技術的な正確性を高めるだけでなく、コスト、速度、可用性といった複数の制約条件の中で最適なバランス点を見つけ出すことが、中核となるエンジニアリング能力です。
バッチ処理とリアルタイム処理の分離、明示的なストレージ層、そして障害を前提とした設計は、大規模AIシステムを運用する際に必ず考慮すべき優れたパターンです。この構造により、コストを抑えながらも性能と正確性を同時に確保する方法を学ぶことができます。
このようなシステム設計は、結局のところ「個別化」や「実験」のような複雑なドメインでも同様の考慮が必要です。様々な技術スタックをどのように分離し接続するかについての洞察が必要であれば、個別化と実験システムの分離戦略に関する記事を参照してください。また、大規模システム運用のもう一つの側面であるコスト最適化と自動化に興味があれば、Generali MalaysiaのEKS運用最適化事例も合わせてお読みになることをお勧めします。
次のステップとしての学習方向性
- 埋め込みモデルの探求: MTEBリーダーボードを調査し、様々なタスクに適したモデルを選択する基準を学びましょう。
- ベクターDBの比較: pgvectorの他にも、Pinecone、Milvus、Weaviateなど様々なベクターデータベースの特性を比較してみましょう。
- RRFおよびランキングアルゴリズム: Learning to Rank(LTR)アルゴリズムとRRFの違い、適用シナリオについて研究してみましょう。

実務適用のための要約チェックリスト
- ワークロード特性の分析: 自身のサービスの検索トラフィックとデータ規模に基づき、バッチ/リアルタイム処理の分離が必要か検討。
- 埋め込み契約の定義: モデル名、リビジョン、次元数、正規化手法などをコードと設定ファイルに明示的に管理。
- 障害対策の設計: ベクター検索エンジンが停止した際に、サービスが完全に停止しないようフォールバックロジックを実装。
- コストと品質のトレードオフ: Matryoshka Representation Learningなどの技術を活用し、ベクトル次元を削減してコストを削減する方法を検討。