このリリースノートは、Conversational Analytics API の更新に関するものです。
2025 年 12 月 15 日
Conversational Analytics API の更新情報:
Looker と BigQuery のデータソースの API レスポンス ストリームには、textType = THOUGHT を含む追加の systemMessage.text メッセージが含まれます。これらのメッセージは、エージェントがクエリに回答するために行う推論と意思決定のプロセスを段階的に示します。この推論を示すチャットの例を実行するには、HTTP と Python SDK の Colaboratory ノートブックをご覧ください。Looker データソースで THOUGHT メッセージをレンダリングする方法については、Looker データソースのエージェント レスポンスをレンダリングするをご覧ください。これは、発表前の試験運用版の機能に関するお知らせです。この機能を利用するには、申し込みが必要になります。この機能の利用をご希望の方は、conversational-analytics-api-feedback@google.com 宛てにメールをお送りください。
Looker データソースの場合、エージェントはより詳細なメソッドを使用して、Explore のスキーマとデータ値を取得します。エージェントが特定のデータ値を検索すると、API ストリームには textType = PROGRESS を含む systemMessage.text メッセージも含まれ、検索ステータスと結果に関する更新情報が提供されます。PROGRESS メッセージのレンダリングに関するガイダンスについては、Looker データソースのレンダリング エージェント レスポンスをご覧ください。これは、発表前の試験運用版の機能に関するお知らせです。この機能を利用するには、申し込みが必要になります。この機能の利用をご希望の方は、conversational-analytics-api-feedback@google.com 宛てにメールをお送りください。
Conversational Analytics API と VPC Service Controls のインテグレーションはプレビュー版です。このインテグレーションはより広範なテストと使用に対応しますが、本番環境で完全にサポートされるわけではありません。詳細については、サポートされているプロダクトのリストをご覧ください。
big_query_max_billed_bytes が正しく適用されない問題を修正しました。
API による Looker データソースの処理に関する問題が修正されました。また、以下のことも行われています。
- テキスト レスポンスの値の書式設定の改善
- 完全一致のフィルタリングの改善
- 同期比（PoP）指標のサポートの改善
always_filterのサポートの改善
クライアント ライブラリの更新情報:
次のクライアント ライブラリが追加されました。
2025 年 10 月 21 日
Conversational Analytics API の更新情報:
REST API と SDK に deleteConversation 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 は、コンテキストで最大 5 つの Looker Explore データソースをサポートするようになりました。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 データソースからデータ エージェントを構築できるようになりました（Conversational Analytics API は、Virtual Private Cloud の境界内にある Looker（Google Cloud コア）インスタンスに基づくデータソースをサポートしていません）。
BigQuery データソースの構造化コンテキストが利用可能になりました。これには、API を使用してテーブルとフィールドのレベルで質問 / クエリのペア、テーブルの説明、同義語、タグを追加する機能が含まれます。
ロケーションとオペレーションの API がサポートされるようになりました。DataAgentCreator と DataAgentEditor の Identity and Access Management ロールに、オペレーション API の権限が付与されるようになりました。
データ エージェントの公開コンテキストが更新されるたびに、Last Published Context がサーバーレイヤに自動的に保存されるように機能強化されました。
Identity and Access Management ロールの表示名が「Gemini データ分析ステートレス チャット ユーザー」と「Gemini データ分析データ エージェント作成者」に更新されました。API で使用される Identity and Access Management ロールの詳細については、Conversational Analytics API の Identity and Access Management ロールと権限を付与するのドキュメント ページをご覧ください。
Colaboratory バージョン 1.1 がリリースされました。
ステートフル チャットの会話に関連した 500 内部エラーを処理するため、エラー処理が更新されました。
400 クライアント エラーに対する例外処理メッセージが改善されました。
ドキュメントの更新情報:
新しい GitHub の Streamlit クイックスタート アプリケーションを使用して、Conversational Analytics 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 の使用に関する重要なコンセプトについて説明します。
Conversational Analytics API の既知の制限事項: データソースの数、ビジュアリゼーションのスタイル、データセットのサイズに関する制限事項について説明します。
Conversational Analytics API エラーのトラブルシューティング: Conversational Analytics API の潜在的な問題やエラー、および解決策について説明します。
Conversational Analytics API エージェントに関する BigQuery の費用をモニタリングして管理する: Conversational Analytics API エージェントの費用管理を実装する方法について説明します。
データ エージェントの共有に使用する場合の SetIAMPolicy メソッドと GetIAMPolicy メソッドについては、Conversational Analytics API の概要のドキュメント ページで確認できます。
Conversational Analytics 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 への移行も含まれます。リクエストを更新する詳しい手順については、移行ガイドをご覧ください。