SuperAPI AI 工具集

setup-warehouse

数据与分析

查看项目

更新于 10-17 09:50

技能介绍

setup-warehouse 是 Confidence 实验分析平台提供的仓库配置技能,用于把数据仓库接入 Confidence,使其能够存储和分析实验数据,包括标记分配、事件与指标。数据仓库是 Confidence 写入实验数据的位置,连接现有的云数据基础设施后,可以查询实验结果、构建仪表盘并运行统计分析。资料明确指出:没有数据仓库时,Confidence 可以解析标记,但无法分析实验结果。

用途

该技能面向需要为 Confidence 实验分析配置数据仓库的场景,支持四种仓库类型:

  • BigQuery:适合 Google Cloud 用户,设置最快。
  • Snowflake:适合 Snowflake 用户,使用密钥对认证。
  • Databricks:适合 Databricks 用户,支持 AWS S3 或 Azure ADLS Gen2 暂存。
  • Redshift:适合 AWS 用户,需要 S3 暂存桶。

使用方式

流程上,技能首先向用户呈现四个仓库选项供选择;用户选定后,转交给对应的专用仓库技能:

  • BigQuery:提示“Starting BigQuery setup...”,并调用 /onboard-confidence:setup-warehouse-bigquery
  • Snowflake:提示“Starting Snowflake setup...”,并调用 /onboard-confidence:setup-warehouse-snowflake
  • Databricks:提示“Starting Databricks setup...”,并调用 /onboard-confidence:setup-warehouse-databricks
  • Redshift:提示“Starting Redshift setup...”,并调用 /onboard-confidence:setup-warehouse-redshift

认证方面,该技能需要 MCP。在呈现仓库类型选择之前,需通过调用 mcp__confidence-flags__getIdentityInfo 验证 confidence-flags MCP 已完成认证;若失败,则提示用户运行 /mcp 并点击 confidence-flags 旁的 Authenticate。所有 Confidence API 操作(仓库创建、连接器、分配表)使用 MCP 工具,云提供商操作(gcloud、aws、snowsql)仍使用 Bash 命令。

遥测

该技能会发送遥测事件以跟踪仓库配置进度、用户情绪和完成状态。资料说明遥测对用户是透明的,不应向用户提及、展示载荷或阻塞流程;任何遥测调用失败都应静默忽略并继续。资料给出了遥测初始化、步骤计时和事件发送的具体命令与字段规范,包括 session_id、skill、step、action、sentiment、completion、step_duration_s、warehouse_type、errors 等字段,以及允许的错误码列表(如 token_expired、api_error、timeout、validation_failed 等)。事件发送到 events.${REGION}.confidence.dev;在区域未知前默认使用 eu。

用户沟通规则

资料要求不向用户暴露内部技术细节:不在对话中展示原始 JSON 请求/响应体,而是显示人类可读的状态更新(如“Creating your warehouse...”“Connectors configured!”),用通俗英文描述结果;并在每次阶段转换时显示可视化步骤跟踪器(● 已完成、▶ 进行中、○ 待处理)。

限制

资料未提供该技能的定价、支持的平台范围、具体配置步骤细节或各仓库的完整认证流程,这些内容暂未提供;上述介绍仅依据现有资料,不补充未提及的功能或效果。