用途:帮助开发者构建“数据代理”,通过 Gemini Data Analytics API(geminidataanalytics.googleapis.com)将自然语言问题翻译为 Looker Explore 查询。
主要能力:连接一个或多个 Looker Explore;支持 OAuth 客户端凭据或访问令牌认证;可创建带系统指令、Golden Queries(自然语言问题与正确 Looker 查询配对)的数据代理;支持有状态(会话引用)与无状态(内联上下文)聊天;流式返回文本(THOUGHT/PROGRESS/FINAL_RESPONSE)、查询定义、数据结果与图表(Vega-Lite 配置或 PNG)。
使用方式:需启用 cloudaicompanion、Gemini Data Analytics、Vertex AI API,并具备相应 IAM 角色与 Looker 的 gemini_in_looker 权限。用 Python SDK 初始化 DataAgentServiceClient 与 DataChatServiceClient,配置 LookerExploreReference(looker_instance_uri、lookml_model、explore)与凭据,创建 DataAgent 后调用 Chat。
适用场景:在应用中嵌入自然语言数据分析聊天,查询 Looker 结构化数据。
限制:需正确配置 IAM 与 Looker 权限,否则报 Permission Denied;准确率低时可优化 system_instruction 或增加 golden queries;连接错误需检查 looker_instance_uri 与网络(PSC/VPC-SC)。处理响应时注意 filters 为对象数组,生成 URL 需迭代构造 &f[field_name]=value;建议按 schema 的 value_format 格式化数值。