このリリースノートは、Conversational Analytics API の更新に関するものです。
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 への移行も含まれます。リクエストを更新する詳しい手順については、移行ガイドをご覧ください。