会話分析 API に関するよくある質問

このプロダクトまたは機能は、サービス固有の規約の「一般サービス規約」セクションの「一般提供前サービス規約」の対象となります。 pre-GA のプロダクトと機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

会話分析 API でデータを変更または削除できますか？

会話分析 API は、データの変更や削除を防ぐための保護機能を備えて設計されています。

データソースごとのデータ セーフティの取り扱いは次のとおりです。

• BigQuery: API は、データ定義言語（DDL）ステートメントとデータ操作言語（DML）ステートメントをブロックします。具体的には、生成された SQL でテスト実行を行い、SELECT タイプのクエリのみを許可します。
• Looker: API は、選択、フィルタ、上限などの読み取りオペレーションに制限されている run_inline_query などのメソッドを使用して Looker とやり取りします。これらのメソッドは DDL オペレーションまたは DML オペレーションをサポートしておらず、削除オペレーションまたはドロップ オペレーションは含まれていません。
• Looker Studio（CSV と Google スプレッドシートの場合）: Looker Studio は、構造化された形式を使用して、可視化とレポートのデータを定義して取得します。このメソッドで実行されるクエリは読み取り専用であり、データ ミューテーションはサポートされていません。

会話分析 API は、これらのデータソース全体で読み取り専用になるように設計されています。

認証エラーと権限エラーを処理するにはどうすればよいですか？

注: エラーと解決策の詳細については、会話分析 API エラーのトラブルシューティング ガイドをご覧ください。

会話分析 API の使用時に発生する可能性のある一般的な認証エラーと権限エラーは次のとおりです。

1. エラー: PERMISSION_DENIED または 403 Write access to project ... was denied

   • 考えられる原因: このメッセージは、 Google Cloud IAM ロールに関する問題を示していることがよくあります。API を使用しようとしているユーザーまたはサービス アカウントに、 Google Cloud プロジェクトに対する必要な権限がありません。
   • トラブルシューティング
     • Google Cloud プロジェクト オーナーは、ユーザーまたはサービス アカウントに Google Cloud プロジェクトで正しい IAM ロールが割り当てられていることを確認する必要があります。API の有効化や関数のテストなどの特定のオペレーションには、Project Editor などのロールが必要になることがあります。
     • リージョンを切り替えるときに Write access to project 'us-gcp-project-name' was denied などの 403 エラーが発生した場合は、プロジェクトの IAM 構成を確認してください。

2. エラー: 500 Internal Server Error。ユーザー ロールを持つ Looker ユーザーがデータ エージェントとチャットしようとした場合。

   • 考えられる原因: Looker ユーザーに十分な権限がない可能性があります。
   • トラブルシューティング: データ エージェントとチャットするには、IAM と Looker で適切なロールがユーザーに付与されていることを確認します。詳細については、このよくある質問の 会話分析 API を使用するための Looker の要件は何ですか？をご覧ください。

会話分析 API を使用するための Looker の要件は何ですか？

会話分析 API を使用するには、実行するデータソースとアクションに応じて、 Google Cloud IAM と Looker の両方で適切な権限が必要です。

1. Google Cloud IAM ロール:

   • geminidataanalytics.googleapis.com API を操作するには、 Google Cloud プロジェクトに十分な IAM ロールが必要です。IAM ロールの構成が正しくないと、PERMISSION_DENIED エラーが発生することがよくあります。
   • 必要な特定のロールはアクションによって異なりますが、特定のオペレーションでは プロジェクト編集者などの一般的なロールが必要になる場合があります。

2. Looker の権限とロール:

   • モデルレベルの権限: 会話分析と会話分析 API を使用するには、操作するモデルに対する gemini_in_looker 権限を含むロールが Looker ユーザーに割り当てられている必要があります。

会話分析 API の使用に必要な権限とロールの詳細については、会話分析 API の IAM ロールと権限を付与するのドキュメント ページをご覧ください。

また、Looker インスタンスは特定の要件を満たしている必要があります。

• Looker（オリジナル）
• Looker（Google Cloud コア）

Looker Studio Pro で会話分析 API を使用するには、Pro サブスクリプションが VPC-SC 境界外にある必要があります。

Data QnA API から会話分析 API に移行するにはどうすればよいですか？

以前の試験運用版の Data QnA API（dataqna.googleapis.com）を使用していた場合は、移行ガイドで、会話分析 API（geminidataanalytics.googleapis.com）の新しい公式エンドポイントに移行する方法をご覧ください。

データ エージェントの名前と ID の違いは何ですか？

data_agent_id の値として定義されるデータ エージェントの ID は、データ エージェントの固有識別子です。データ エージェントの名前 data_agent.name は、data_agent_id から完全修飾名（FQN）として自動的に派生し、projects/<project>/locations/<location>/dataAgents/<data_agent_id> の形式になります。

データ エージェントを作成するときに data_agent.name に入力した値は無視されます。get、update、delete のオペレーションを実行する場合、完全な data_agent.name はデータ エージェントの固有識別子として扱われます。

会話分析 API を使用してデータ エージェントを作成する場合、次のシナリオが適用されます。

• data_agent_id を定義しない場合、一意の ID が自動的に生成されます。
• data_agent_id を TestID などとして定義すると、data_agent.name に入力した値は projects/<project>/locations/<location>/dataAgents/TestID で上書きされます。
• FQN を使用して data_agent_id を定義すると、「名前の形式が正しくありません」というエラーが表示されます。

会話分析 API のデータ エージェントのメモリ機能とは何ですか？

• 単一セッション内: 会話分析 API はマルチターンの会話をサポートしています。つまり、現在の会話の以前の部分を参照できます。
• 複数のセッションにわたる: 会話分析 API には、会話履歴を管理する機能が含まれており、ユーザーは複数のセッションにわたってチャットできます。また、Google マネージドのマルチターンの会話でステートフル エージェントもサポートしています。
• 長期記憶: 会話分析 API データ エージェントは、明示的な長期記憶機能をサポートしていません。

注: 会話分析 API が成功以外のレスポンスを返した場合、データ エージェントとの会話でメッセージが保持されないことがあります。

会話分析 API データ エージェントに同じ質問をすると、毎回同じ回答が返ってきますか？

• 会話分析 API データ エージェントからの自然言語の回答は決定的ではないため、同じ表現の質問でも、エージェントから提供される自然言語の回答が異なる場合があります。
• データクエリのレスポンス: ただし、特定のデータを求める質問については、基盤となる生成クエリ（SQL または Looker クエリ）は決定的であることが想定されます。基盤となるデータが変更されていない場合、取得されるデータは同じになります。

会話分析 API データ エージェントからのレスポンスの精度を高めるにはどうすればよいですか？

Gemini for Google Cloudプロダクトは初期段階のテクノロジーであるため、もっともらしく見えても事実に反する出力を生成する場合があります。Gemini for Google Cloud プロダクトからのすべての出力は、使用する前に検証することをおすすめします。詳細については、Gemini for Google Cloud と責任ある AI をご覧ください。

データ エージェントの回答の精度を高める方法の 1 つは、データ エージェントに堅牢なコンテキスト情報を提供することです。コンテキストは次の方法で追加できます。

• Looker のセマンティック レイヤでは、LookML 定義内でコンテキストを指定できます。詳細と例については、Looker で作成されたコンテキストでエージェントの動作をガイドするのドキュメント ページをご覧ください。
• データ エージェントを作成する際に、システム指示を指定できます。これは、データ エージェントの動作を形成できるユーザー定義のガイダンスです。このガイダンスには、ビジネス固有のロジック、レスポンスの形式、データのプレゼンテーションが含まれます。正しい SQL クエリまたは Looker クエリとペア設定された自然言語の質問の例である「ゴールデン クエリ」を指定することもできます。システム指示の詳細については、作成されたコンテキストでエージェントの動作をガイドするのドキュメント ページをご覧ください。

会話分析 API をサードパーティ アプリケーションと統合できますか？

会話分析 API をサードパーティ アプリケーションと統合すると、ユーザーは毎日使用しているツール内でデータを直接操作できます。

geminidataanalytics.googleapis.com API エンドポイントとやり取りするサードパーティ アプリケーションは、アプリケーションからエージェントにユーザー メッセージを送信し、レスポンスを表示できる必要があります。

インテグレーションを構築するには、会話分析のクイックスタート リポジトリで例やライブラリをご覧ください。Google デベロッパー フォーラムで、他のユーザーの例を検索することもできます。

会話分析 API の費用はどのくらいですか？

会話分析 API はプレビュー段階であり、プレビュー版のプロダクトに対して Google が料金を請求することはありません。今後、料金が変更される場合は事前にお知らせいたします。

会話分析 API はどのようなデータソースをサポートしていますか？

会話分析 API は、次のデータソースをサポートしています。

• BigQuery
• Looker の Explore
• Looker Studio

BigQuery を介して SAP や Salesforce などのソースへの接続や、Looker Studio を介して CSV や Google スプレッドシートに接続することもできます。

会話分析 API の既知の制限事項は何ですか？

会話分析 API の既知の制限事項について詳しくは、会話分析 API の既知の制限事項のドキュメント ページをご覧ください。

Google Cloud プロジェクトで注意すべき割り当ては何ですか？

Google Cloud プロジェクトの選択やロケーションに制限はありません。データ エージェントを作成して、任意のプロジェクトまたはリージョンに属するサポートされているデータソースに対してクエリを実行できます。

会話分析 API はデータ リージョン指定をサポートしていますか？

会話分析 API はデータ所在地（DRZ）または Service Control 境界（VPC-SC）をまだサポートしていないため、特定の地理的リージョンでエージェントをホストすることはできません。データのリージョン指定はサポートされていません。

会話分析 API は英語以外の言語をサポートしていますか？

会話分析 API で正式にサポートされている言語は英語のみです。基盤となる Gemini モデルは多くの言語をサポートしており、英語以外のクエリで成功したという報告も一部のユーザーから寄せられていますが、会話分析 API は英語以外の言語を正式にはサポートしていません。