用途:这是 Hex 的次级工作流技能(Core Workflow B),用于实现定时运行(Scheduled Runs)与通过 Hex Admin API 管理工作区资源,适合作为主工作流的补充。
主要能力:一是在 Hex UI 中按小时、每日、每周、每月配置定时运行,Hex UI 支持 cron 表达式;二是通过外部 cron 或 CI 触发运行,文档给出 node-cron 示例(如 '0 6 * * *' 表示每日 UTC 6 点、'0 9 * * 1' 表示每周一 9 点),也可与 Airflow/Dagster 集成;三是通过 Admin API 管理用户、组和数据连接,接口基础地址为 https://app.hex.tech/api/v1,鉴权使用环境变量 HEX_API_TOKEN。
用法要点:调用 fetch 时设置请求头 'Authorization': Bearer ${TOKEN};查询项目运行使用 /project/{projectId}/runs,列出用户、组、连接分别使用 /workspace/users、/workspace/groups、/workspace/connections。
前提与限制:需要指定数据/项目负责人、已批准的参数与目标策略、受限凭证以及安全的沙箱项目;还需不可读的运行 ID、幂等策略、聚合断言与取消/回滚方案。上述调度方式均要求 Team+ 计划。
输出与错误处理:返回工作流回执,包含项目、运行、参数修订、接受/隔离操作数、幂等状态、聚合断言、取消结果与回滚引用,不包含 SQL、输出或凭证;对未知项目、参数、目标或响应结构进行隔离,取消失败运行并恢复先前配置,未幂等时不重试变更,也不将输出导出到诊断通道。
其他常见错误可参考 hex-common-errors;文档未提供价格与其他限制细节。