Gemini API の File Search Tool の概要
以下の記事が面白かったので、簡単にまとめました。
1. はじめに
本日、「File Search Tool」をリリースしました。Gemini APIに直接統合されたフルマネージド型RAGシステムで、検索パイプラインを抽象化することで、開発者はアプリケーション構築に集中できます。
すべての開発者が「File Search Tool」をシンプルかつ手頃な価格で利用できるように、クエリ時のストレージと埋め込み生成は無料です。料金が発生するのは、ファイルを最初にインデックス化する際の埋め込み生成時のみで、100万トークンあたり0.15ドル (gemini-embedding-001) の固定料金です。
2. File Search Tool のしくみ
「File Search Tool」は、RAGの複雑な処理を自動で行うことで、開発ワークフローを効率化します。
・シンプルで統合された開発者エクスペリエンス
RAGプロセス全体を合理化しました。ファイル検索は、ファイルストレージ、最適なチャンキング戦略、埋め込み、および取得したコンテキストのプロンプトへの動的な挿入を自動的に管理します。既存のgenerateContent API内で動作するため、簡単に導入できます。
・強力なベクトル検索
「Gemini Embedding」を搭載したファイル検索は、ベクトル検索を使用してユーザーのクエリの意味とコンテキストを理解します。正確な単語が使用されていない場合でも、ドキュメントから関連情報を検索できます。
・組み込みの引用機能
モデルの応答には、回答の生成に使用されたドキュメントのどの部分が使用されたかを指定する引用が自動的に含まれるため、検証が容易になります。
・幅広いファイル形式をサポート
PDF、DOCX、TXT、JSON、および多くの一般的なプログラミング言語のファイルタイプを含む、さまざまなファイル形式を使用して包括的なナレッジベースを構築できます (サポート形式の完全なリストについてはドキュメントを参照)。
「Google AI Studio」で提供されている新しいデモアプリで「File Search Tool」のの動作を確認できます (有料APIキーが必要)。
3. File Search Tool の使い方
「File Search Tool」の使い方は、次のとおりです。
from googleimport genaifrom google.genaiimport types# Gemini APIのクライアントの準備client = genai.Client()# ファイルストアの準備store = client.file_search_stores.create()# ファイルストアへのインポート (チャンク化+埋め込み+インデックス登録)upload_op = client.file_search_stores.upload_to_file_search_store( file_search_store_name=store.name, file='path/to/your/document.pdf')# アップロード完了まで待機whilenot upload_op.done: time.sleep(5) upload_ops = client.operations.get(upload_op)# File Search Store をツールとして利用response = client.models.generate_content( model='gemini-2.5-flash', contents='What does the research say about ...', config=types.GenerateContentConfig( tools=[types.Tool( file_search=types.FileSearch( file_search_store_names=[store.name] ) )] ))# 回答の表示print(response.text)# 回答に使用した情報源の表示grounding = response.candidates[0].grounding_metadatasources = {c.retrieved_context.titlefor cin grounding.grounding_chunks}print('Sources:', *sources)・client.files.upload()
ファイルの一時アップロード
48時間で自動削除
・client.file_search_stores.upload_to_file_search_store()
ファイルストアへのインポート
削除するまで無期限に保存
詳しくは、「File Search Tool」のドキュメントを参照してください。
