SuperAPI AI 工具集

conversational-analytics-api

编程与开发

查看项目

更新于 10-16 00:01

技能介绍

用途:帮助开发者构建“数据代理”,通过 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 格式化数值。