SuperAPI AI 工具集

hex-sdk-patterns

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Hex API 集成提供生产级 SDK 模式,覆盖 TypeScript 与 Python,适合实现 Hex 集成、重构 SDK 调用或统一团队编码规范。

主要能力:类型化客户端边界、流水线编排、重试逻辑与 Python 集成。示例包含带重试的运行函数(遇 429 限流等待 30 秒)、Python 客户端 hextoolkit(pip install hextoolkit,使用 HexAPI 列出项目、运行项目、轮询状态),以及 Airflow 集成(hex-inc/airflow-provider-hex 的 HexRunProjectOperator,支持 wait_for_completion 与 timeout)。

使用方式:先准备类型化客户端边界、密钥管理器引用、环境允许列表,以及使用虚构或已批准非敏感数据的沙箱项目;设定明确执行预算、幂等/关联约定,并规定未知项目范围或响应结构时失败关闭。输出 SDK 回执,包含客户端版本、环境、不透明项目/运行 ID、参数模式版本、执行状态、聚合结果校验与回滚/取消引用,不得包含 API 令牌、SQL、单元格输出或工作区数据。

错误处理:分别归类认证、授权、校验、配额、超时与终态运行失败;无幂等保障不得重试写类项目运行,不得扩大范围绕过拒绝,也不得记录笔记本输出用于诊断。

限制:资料未提供具体定价、平台支持范围或完整 API 细节,需以官方文档为准。