このリリースノートは、Conversational Analytics API の更新に関するものです。
2025 年 9 月 25 日
Conversational Analytics API の更新:
新しい API ListAccessibleDataAgents を使用して、プロジェクト内のユーザーがアクセスできるデータ エージェントを一覧表示できるようになりました。API を呼び出すユーザーがエージェントに対する get 権限を持っている場合、データ エージェントはアクセス可能と見なされます。creator_filter フィールドを使用すると、このメソッドが返すエージェントを管理できます。
NONE（デフォルト）: 作成者に関係なく、ユーザーがアクセスできるすべてのデータ エージェントを返します。CREATOR_ONLY: ユーザーが作成したデータ エージェントのみを返します。NOT_CREATOR_ONLY: 他のユーザーによって作成されたデータ エージェントのみを返します。
systemMessage.text.textType 列挙型が FINAL_RESPONSE 値と THOUGHT 値で使用できるようになりました。これにより、クライアントはさまざまな種類のテキスト メッセージを区別できます。Conversational Analytics API は、textType = THOUGHT を含む systemMessage.text メッセージを使用して思考ステップを生成するようになりました。
API で、コンテキスト内の Looker Explore データソースを最大 5 つまでサポートするようになりました。Chat リクエストは、最も関連性の高い Explore でクエリを生成します。詳細については、HTTP を使用して Looker データに接続するドキュメントと、Python SDK を使用して Looker データに接続するドキュメントをご覧ください。
systemMessage.data.generatedLookerQuery フィールドが systemMessage.data.query.looker になりました。
2025 年 8 月 25 日
Conversational Analytics API は、パブリック プレビューでご利用いただけるようになりました。
クライアント ライブラリの更新:
次のクライアント ライブラリが複数の言語で利用できるようになりました。
Conversational Analytics API の更新:
HTTP REST の v1beta エンドポイントのサポートが利用可能になりました。
REST API と SDK に GetLocation API メソッドと ListLocations API メソッドのサポートが追加されました。
GetIamPolicy と SetIamPolicy の API メソッドを使用して、データ エージェントを共有できるようになりました。
プライベート IP ネットワークを使用する Looker（Google Cloud コア）インスタンスに基づく Looker データソースからデータ エージェントを構築できるようになりました。（会話分析 API は、Virtual Private Cloud の境界内にある Looker（Google Cloud コア）インスタンスに基づくデータソースをサポートしていません）。
BigQuery データソースの構造化コンテキストが利用可能になりました。これには、API を使用してテーブルとフィールドのレベルで質問/クエリのペアの例、テーブルの説明、同義語、タグを追加する機能が含まれます。
ロケーション API とオペレーション API がサポートされるようになりました。DataAgentCreator と DataAgentEditor の Identity and Access Management ロールに、オペレーション API の権限が付与されるようになりました。
データ エージェントの公開コンテキストが更新されるたびに、Last Published Context がサーバーレイヤに自動的に保存されるように機能が強化されました。
Identity and Access Management ロールの表示名が「Gemini データ分析ステートレス チャット ユーザー」と「Gemini データ分析データ エージェント作成者」に更新されました。API で使用される Identity and Access Management ロールの詳細については、会話分析 API の Identity and Access Management ロールと権限を付与するのドキュメント ページをご覧ください。
Colaboratory バージョン 1.1 がリリースされました。
ステートフル チャットの会話関連の 500 内部エラーを処理するために、エラー処理が更新されました。
400 クライアント エラーに対する例外処理メッセージが改善されました。
ドキュメントの更新:
新しい GitHub の Streamlit クイックスタート アプリケーションを使用して、会話型分析 API のデモを数分で設定できるようになりました。
Conversational Analytics API Golden Demo が GitHub で公開されました。Conversational Analytics API Golden Demo では、Conversational Analytics API をウェブ アプリケーションに統合する例と、TypeScript の完全な本番環境デモを確認できます。このプロジェクトはデモ専用です。本番環境での使用は想定されていません。
Conversational Analytics API のアーキテクチャ、ワークフロー、ロール: データ エージェントの仕組み、一般的なデータ エージェントのワークフロー、会話モード、Identity and Access Management のロール、複数のデータ エージェントを使用するシステムの設計方法など、Conversational Analytics API の使用に関する重要なコンセプトについて説明します。
会話分析 API の既知の制限事項: データソースの数、可視化のスタイル、データセットのサイズに関する制限事項について説明します。
会話分析 API エラーのトラブルシューティング: 会話分析 API の潜在的な問題やエラーと、その解決策について説明します。
Conversational Analytics API エージェントに関する BigQuery の費用をモニタリングして管理する: Conversational Analytics API エージェントの費用管理を実装する方法について説明します。
SetIAMPolicy メソッドと GetIAMPolicy メソッドは、データ エージェントの共有に使用できる Conversational Analytics API の概要のドキュメント ページで確認できます。
会話分析 API に関するよくある質問の回答を掲載した新しいドキュメント ページが公開されました。
BigQuery データソースのデータ エージェント コンテキストを定義する: BigQuery データソースのシステム指示を作成する方法について説明します。
Looker データソースのデータ エージェントのコンテキストを定義する: Looker データソースのシステム指示の作成方法について説明します。
2025 年 7 月 15 日
IAM 事前定義ロールを割り当てることで、特定のデータ エージェントで共同作業を行うようにユーザーを招待できるようになりました。詳細については、Conversational Analytics API の IAM ロールと権限をご覧ください。
新しいベスト プラクティス ガイドは、ビジネスとデータの効果的なコンテキストをエージェントに提供するために役立ちます。詳細については、作成されたコンテキストでエージェントの動作をガイドするをご覧ください。
SDK の更新:
Python Package Index（PyPI）から Python SDK をインストールできるようになりました。
2025 年 6 月 25 日
API の更新:
データ エージェントの作成、管理、操作へのアクセスを制御する新しい IAM 事前定義ロールが追加されました。
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
ロールとその権限の一覧については、Conversational Analytics API の IAM ロールと権限を付与するをご覧ください。
2025 年 6 月 5 日
Conversational Analytics API の最初の非公開プレビューで、データ エージェントの作成と操作の機能が導入されました。
REST と Python SDK の両方で始める際に、次のインタラクティブな Colaboratory ノートブックを利用できます。
API の更新:
データ エージェント サービスにより、Looker、Looker Studio、BigQuery で機能する永続的でコンテキスト認識型の AI エージェントをプログラムで作成、構成、管理できます。
データチャット サービスにより、複数のチャットモードを使用してエージェントと会話することが可能になります。これらのモードには、Google が会話履歴を管理するステートフル モード、アプリケーションが会話を管理するステートフル オプション、アプリケーションが各リクエストで完全なコンテキストを提供するステートレス モードがあります。
この API は、Python を使用した高度な分析をサポートしており、失敗したクエリを自動的に再試行します。
Conversational Analytics API（geminidataanalytics.googleapis.com）は、非推奨の Data QnA API（dataqna.googleapis.com）に代わるものです。これには、DataQuestionService から新しい DataChatService への移行も含まれます。リクエストを更新する詳しい手順については、移行ガイドをご覧ください。