このドキュメントでは、コンテキスト セット ファイルを使用して Spanner Studio でコンテキスト セットを作成する方法について説明します。コンテキスト セット名は、データベース内で一意である必要があります。
コンテキスト セットの詳細については、コンテキスト セットの概要をご覧ください。始める前に
エージェントを作成する前に、次の前提条件を満たす必要があります。
必要なサービスを有効にする
プロジェクトで次のサービスを有効にします。Spanner インスタンスを準備する
- Spanner インスタンスが使用可能であることを確認します。詳細については、インスタンスの作成をご覧ください。
- テーブルを作成するインスタンスにデータベースを作成してください。詳細については、Spanner インスタンスにデータベースを作成するをご覧ください。
このチュートリアルでは、Spanner インスタンスにデータベースが必要です。詳細については、データベースを作成するをご覧ください。
必要なロールと権限
- IAM ユーザーまたはサービス アカウントをクラスタに追加します。詳細については、IAM ロールを適用するをご覧ください。
- プロジェクト レベルで IAM ユーザーに
spanner.databaseReaderロールとgeminidataanalytics.queryDataUserロールを付与します。詳細については、プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。 - 必要なデータベースに対して、プロジェクト レベルで IAM ユーザーにロールと権限を付与します。
コンテキスト セットを作成する
コンテキスト セットを作成する手順は次のとおりです。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで [Spanner Studio] をクリックします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを作成] をクリックします。
[コンテキスト セット名] に、一意のコンテキスト セット名を入力します。コンテキスト セット名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。
省略可。[コンテキスト セットの説明] に、コンテキスト セットの説明を追加します。
[作成] をクリックします。
コンテキスト セットを構築する
コンテキスト セットを作成したら、Gemini CLI を使用してコンテキストを構築するの手順に沿って、コンテキスト セット ファイルを作成します。その後、コンテキスト セットを編集してコンテキスト セット ファイルをアップロードできます。
コンテキスト セットを編集する
コンテキスト セットを編集する手順は次のとおりです。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで [Spanner Studio] をクリックします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを編集] をクリックします。
省略可。[コンテキスト セットの説明] を編集します。
[コンテキスト セット ファイルのアップロード] セクションで [参照] をクリックし、コンテキスト セット ファイルを選択します。
[保存] をクリックします。
コンテキスト セットを削除する
コンテキスト セットを削除するには、次の操作を行います。
Google Cloud コンソールで、[Spanner] ページに移動します。
リストからインスタンスを選択し、データベースを選択します。
ナビゲーション メニューで [Spanner Studio] をクリックします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを削除] をクリックします。
[コンテキスト セットを削除しますか?] 確認ダイアログで、コンテキスト セットの名前を入力します。
[確認] をクリックして、コンテキスト セットを削除します。
次のステップ
- 詳しくは、コンテキスト セットをご覧ください。
- 詳しくは、コンテキスト セットをテストするをご覧ください。
- Gemini CLI を使用してコンテキストを構築する方法を確認する。