データエージェントを作成する

会話型データエージェントを使用すると、自然言語インターフェースを使用してデータベースデータとやり取りできます。このようなエージェントを構築することで、ユーザーは複雑な SQL クエリを記述することなく、オペレーションデータベースから分析情報を取得できます。

データエージェントは、ペルソナと、その目的に不可欠な一連のビジネス知識にアクセスできる一連のデータソースを組み合わせたものです。

アプリケーションデベロッパーにとって、これらのエージェントには次のようなメリットがあります。

高精度: 作成されたコンテキストを使用することで、特定のビジネスに関する質問に対して高精度を実現できます。作成されたコンテキストは、エージェント作成者が精度を向上させるために使用できる主な要素です。これには、スキーマの説明、システム指示、予想されるデータベースクエリに関する追加情報を提供する構造化されたコンテキストが含まれます。
複雑さの軽減: エージェントは、自然言語を SQL クエリ、実行、さらにはデータの要約や可視化に変換します。
柔軟性: 個人テスト用のエージェントを作成することも、公開してプロジェクト内の他のユーザーが使用できるようにすることも、API を使用してプログラムで利用できるようにすることもできます。

始める前に

プロジェクト Google Cloud に対して課金が有効になっていることを確認します。
Cloud SQL、Data Analytics API with Gemini、Gemini for Google Cloud API を有効にします。
API を有効にするために必要なロール
API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。
API を有効にする

必要なロール

データエージェントを操作するには、次のいずれかの会話型分析 API Identity and Access Management（IAM）ロールが必要です。

QueryData メソッドを使用して、サポートされているデータベースソースからデータをクエリする: プロジェクトレベルの Gemini データ分析データクエリユーザー（roles/geminidataanalytics.queryDataUser）。
プロジェクト内のすべてのデータエージェントを作成、編集、共有、削除する: プロジェクトレベルの Gemini データ分析データエージェントオーナー（roles/geminidataanalytics.dataAgentOwner）。
プロジェクトで独自のデータエージェントを作成する: プロジェクトレベルの Gemini データ分析データエージェント作成者（roles/geminidataanalytics.dataAgentCreator）。このロールにより、作成したデータエージェントに対する Gemini データ分析データエージェントオーナーのロールが自動的に付与されます。
プロジェクト内のすべてのデータエージェントを表示、編集する: プロジェクトレベルの Gemini データ分析データエージェント編集者（roles/geminidataanalytics.dataAgentEditor）。
プロジェクト内のすべてのデータエージェントを表示する: プロジェクトレベルの Gemini データ分析データエージェント閲覧者（roles/geminidataanalytics.dataAgentViewer）。

また、データエージェントを作成または編集するには、次のロールが必要です。

インスタンスレベルで追加された IAM ユーザーまたはサービスアカウント。詳細については、ユーザー、サービスアカウント、またはグループに IAM ポリシーバインディングを追加するをご覧ください。
プロジェクトレベルで IAM ユーザーに付与された cloudsql.studioUser ロールと cloudsql.instanceUser ロール。詳細については、プロジェクトの IAM ポリシーバインディングを追加するをご覧ください。
データベースのパスワードベースのユーザーとしてログインすることで、IAM ユーザーまたはサービスアカウントに付与されるデータベース権限。
```
GRANT ALL PRIVILEGES ON *.* TO 'your-iam-user@example.com';
```
詳細については、個々の IAM ユーザーまたはサービスアカウントにデータベース権限を付与するをご覧ください。

Cloud SQL for MySQL データベースリソースへのアクセスを管理する場合は、次の権限レイヤを考慮してください。

Google Cloud IAM: クラウドリソースとしてデータベースインスタンスへのアクセスを制御します。これには、executeSql 権限を使用して SQL クエリを実行する権限など、接続、インスタンスの管理、SQL クエリの実行の権限が含まれます。
データベース権限: テーブル、ビュー、スキーマなど、データベース内のオブジェクトへのアクセスを制御します。これらは、GRANT などの SQL コマンドと、データベース固有のユーザーシステムとロールシステムを使用して管理されます。

Cloud SQL for MySQL の場合は、インスタンスに接続してクエリを送信する権限を付与するために、適切な Cloud SQL IAM ロールが必要です。テーブルやビューなどのオブジェクトを操作するには、接続するデータベースユーザーに、Cloud SQL for MySQL GRANT システムを使用して必要な権限が付与されている必要があります。詳細については、 Cloud SQL for MySQL ユーザーについてをご覧ください。エージェントがサービスアカウントを使用する場合は、データベースロールを割り当てることができます。たとえば、IAM データベース認証でユーザーを管理するをご覧ください。