SuperAPI AI 工具集

connect-ai-hubspot

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 HubSpot 数据提供 HubSpot 专属指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言和三段式查询命名约定。使用前必须先定位并阅读 connect-ai-base;若当前环境未加载、未启用或未安装,应立即停止并告知用户需先安装启用。

主要能力与用法:该技能取代 HubSpot 驱动的 getInstructions,不要调用它,直接进入 getSchemas 识别架构,再经 getCatalogs 找到 HubSpot 连接后做 getTables / getColumns 架构发现。HubSpot 连接由 CData Schema 连接属性决定呈现三种完全不同的表面:HubSpotV3(约 137 张表,Id 主键,小写枚举,含自定义对象/属性、GDPR 删除、文件管理等存储过程)、HubSpotV4(约 62 张表,Id 主键,小写枚举,含邮件订阅管理)、旧版 HubSpot(约 60 张表,VID / DealId 主键,TitleCase 枚举,含 InsertEngagement 等)。必须始终把 getSchemas 作为对 HubSpot 连接的第一个工具调用,不能从连接名推断表面。识别后加载对应 references/v3.md、v4.md 或 legacy.md 再写查询。三段式名称为 [Catalog].[Schema].[Table],例如 SELECT [Id], [Deal Name], [Amount] FROM [YourConnection].[HubSpotV3].[Deals] LIMIT 10。

通用约定:所有列需用方括号引用,因列名含空格和标点;关系存于关联表而非外键列,关联连接会扇出,必要时用 DISTINCT 或聚合;存储值常为 id 而非标签,能否解析取决于表面;创建记录时不要提供主键,优先使用专用创建工具,原始 INSERT 可作后备;自定义属性常见,可用 getColumns 的 columnName 过滤;部分表需要 WHERE 过滤;每个连接只有一个架构,不能跨表面限定查询;枚举大小写因表面而异,不要跨表面复制过滤值;不要对对象表执行 SELECT *。

限制:资料未提供具体收费、价格、平台支持范围或性能效果等信息。