跳转到正文
Docs
下载 Markdown
文章目录

配置工作流

连接准入、人工工作、检查、验收和交付步骤。

下载 Markdown

打开已有活动Developer 组织的一组数据工作及其相关设置,选择 Open builder(打开构建器)。选中画布节点打开配置面板,设置输入和后续路径;先在面板选择 Save(保存),再用画布工具栏的 Save 保存工作流。重新打开节点,核对数值和连接。

以一项小型标注工作为例,一条记录可以依次经过 Entry Gate → Supply(label)→ Accept → Sink。Gate 检查谁可加入,Supply 展示材料并收集标签,Accept 决定是否接受,Sink 结束已接受的路径。只有工作需要额外检查或字段处理时,才加入 validate、Consensus、Dedup、ETL 或 Agent TaskContributor 实际领取或进入的一项具体工作。这是流程示例,仍需配置表单、验收规则并通过发布检查。

Entry Gate:参与条件

分别配置适用协议、Required course、资料要求和 Invite code。System required(平台必需)按参与者适用主体判断,作者不能移除;额外协议必须来自有已发布版本的目录。所选协议无法解析时,先修正目录绑定,并保留必要条款。

课程绑定已发布的组织课程版本。Has finished the course(已学完该课程)认可 passed 或 mastered;Has mastered the course(已掌握该课程)需要 mastered。学完课程记录的是 passed,课程编辑器里没有任何设置能产生 mastered;因此把 Gate 设为 Has mastered the course 时,目前没有人能通过,应选择 Has finished the course。若显示 No courses published yet(尚未发布任何课程)、版本不存在或加载失败,先发布或恢复正确课程及版本。历史通过记录的关系见课程与版本。

邀请码与注册推荐码、组织邀请不同。启用邀请码后,通过 Generate / Copy / Regenerate / Revoke 管理;这些操作立即生效,不等待画布保存。换码或撤码不会单独移除已兑换的准入,退出后重新加入仍需满足邀请码要求。

Supply:人工工作

选择 Task type,配置工作界面、奖励和额度。

  • 普通人工步骤可按每份被接受的提交设置基础报酬。
  • 每人额度可以选择 No limit、Per day 或 In total;Per day 按 UTC 零点重置。
  • Items to collect(采集条数)限制全体收集总量。正在执行或审核中的记录占用额度;被驳回或重复结果会释放相应名额。

不要用 Concurrent tasks per user(单人同时进行的任务数)作为已经生效的并发限制;当前该项设置尚未接入执行检查。

validate 与 Consensus

普通 validate 选择要复核的前序人工步骤,最多配置 1–5 名审核者,一致人数不能超过最多人数。达到一致门槛即可形成结果;一致驳回也可以结束复核,无需再配置 Consensus。

普通 validate 的 Accept 使用 Auto(自动)。其奖励若标为 per item, shared by whoever agreed,表示同一条目的奖励池由符合一致结果规则的获奖者共同分配。

Consensus 用于比较同一对象的多份答案。选定前序步骤、最多答案数、一致门槛和必须匹配的字段。没有选比较字段时,会比较整个答案,包括自由文本;若只需类别一致,就明确选择对应字段。这与复核一份已有提交不同。

Dedup:重复后的处理

Dedup 的每条规则设置 Key fields(关键字段)和比较范围。同一规则中的全部字段要匹配,多个规则命中任一条就可能判重;跨活动的组织范围还需一致的 Canonical key(统一键)。包含相应设置的版本部署后,可在某条规则中开启 Send the duplicate to publisher review(把重复提交转给发布者人工审核):关闭时,验收阶段命中该规则会自动标为 Duplicate;开启时,提交保持待审且不结算,直到发布方决定。若同时命中自动判重规则,自动判重优先。

Agent Task(Agent 任务)需要组织已接入的 Agent、本活动的指令,以及所需检查或评分门槛。只把节点命名为“AI 检查”不会执行检查。工作流 Agent 的接入状态需在组织中核对;Agent 访问说明另述程序取数。

Accept:验收

Audit mode工作到达前要配置到达后核对
Auto在前序路径安排所需复核或共识使用已有结果,不会凭空增加审核
Manual设置最低评分,并安排有权限的审核者保持待审直到人工决定;到 Reviews(审核)核对
Automated checks选择字段、检查方式或 Agent、失败处理和评分门槛核对各项检查与最终评分
Scripted选择已有 Acceptance check(验收检查)或使用 Write a check(编写检查),设置评分门槛没有选定检查会失败,不会静默接受

需要最低接受评分时,配置范围为 1–5。Manual 的已有提交保留开始时的门槛;修改门槛不会重写旧结果。

ETL 与 Sink:交付

Accept 的接受分支直接连接 Sink(落库),或先经 ETL(字段转换节点)整理字段再连接 Sink。Sink 是路径末端。JSON / CSV 是 Sink 的输出配置;文件获取要另查交付方式。

API 获取还需满足交付、订阅和授权条件,见任务产出与数据交付。保存工作流后,进入 2 Test & Launch 完成发布检查。

其他节点,以及为什么有些是灰色

节点用途
Data Source(数据来源)引入平台上已有的数据:新建的节点默认选中 CSV,请改选 Marketplace(数据市场)。目前没有任何程序读取 CSV、File batch(文件批量)和 Webhook(Webhook 推送),所以它们的路径输入框不可用,已保存的路径也不会带入条目。需要导入 CSV 时,联系 hello@humanbased.ai
Code(代码)对每个条目运行自定义 Python 转换。节点面板中已不再提供 Code,只有已经包含 Code 步骤的已保存流程才会显示它
Routes(流向)分支、循环或抽样
Agent Task(智能体任务)运行平台智能体检查,按结论把条目送往下游

节点面板中有些条目是带锁的灰色,每一项都写明原因和解锁条件。Labeling(标注)和 Validate(校验)没有自己的执行程序:改用 Supply(采集)节点,并选择 label 或 validate 任务类型。Evaluate(评估)还没有执行程序,上线前保持锁定。Transform(转换)、De-identify(去标识)和 Policy Gate(策略门)可以运行,但尚未通过内部验收,验收前保持锁定。

检查失败时回到哪里

现象回到
Contributor 无法加入Entry Gate(准入门):协议、课程及版本和可达结果、资料规则、活动邀请码
人工步骤没有表单Supply(采集):Task type、模板绑定和 Preview;普通 validate 核对前序来源
复核迟迟无法形成结果validate 或 Consensus:来源、最多人数、一致门槛和比较字段
一直待审Accept(采纳):模式、待处理审核者、所选检查及失败结果
已接受但没有预期交付接受分支至 ETL(如有)和 Sink;再查交付与访问

修正节点后,分别保存面板和画布,重新打开核对保存值,再运行 Dry-run(试跑)。保存后继续试运行,检查通过后再发布。