用途:根据用户对某 API 或数据源的描述,构建一个新的 Fivetran 连接器,基于 Connector SDK(CSDK)。
主要流程:先读插件目录的 sdk-reference.md 加载 SDK 规则与示例。第 0 阶段先判断是否有更省事的方案:并行抓取 Fivetran 连接器目录的 databases、events、files、functions、applications 五类页面,查找是否已有匹配连接器,并可用 URL slug 变体探测;若无匹配再判断是否适合由 AI builder 构建、Fivetran 托管的 Lite Connector(SaaS 应用、REST+JSON、标准认证、无需复杂状态逻辑)。是否继续自建由用户决定。
第 1 阶段研究并校验 API 需求,产出规格与 EXACT MATCH、FUZZY MATCH 或 BUILD ON TEMPLATE 结果。第 2 阶段用 fivetran init 脚手架生成项目,例如: printf '\n' | fivetran init "<connector_dir>" --force 或指定模板:--template connectors/<name>。Windows PowerShell 用 "" | 代替前面部分。以 connector.py 是否存在判断成功。
第 3 阶段在已生成文件上用 Edit 适配规格,保留 validate_configuration()、docstrings、connector 全局变量与 main 块。第 4 阶段建虚拟环境并安装依赖(如 uv venv .venv 与 uv pip install)。第 5 阶段配置必须通过加密脚本由用户在自己终端运行 enter_configuration.py,禁止在聊天中粘贴或展示配置值;随后用 run_connector.py 运行并用 duckdb 检查 files/warehouse.db 中 tester 架构的表与行数。第 6 阶段按错误类型处理:基础设施、首次运行、代码、工具错误分别对待,不修改插件工具,只修用户连接器代码。
限制:资料未提供收费与价格信息;需要用户本地环境与 Fivetran 相关工具;配置流程有硬性安全约束。