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