For AI agents: the complete documentation index is available at https://a3s-lab.github.io/Flow/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/Flow/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/Flow/index.md.
  • 简体中文
  • v1.1.0
  • A3S FLOW AI Native Workflow Engine

    A3S FlowAI 原生工作流引擎

    把 Agent 任务、工具调用、人工审批和子工作流放进同一张图。每次决定与结果都会写入事件历史。进程退出、Worker 更换,或者流程暂停几天,下一次运行仍从已确认的位置继续。

    客户支持工作流已校验 已自动保存
    开始
    工作流
    support.triage

    定义工作流接收的输入,并指定运行入口。

    0 个输入 · 2 个输出 · 7 项配置
    执行任务
    任务
    risk.review

    调用一个已注册任务,并按失败策略重试或继续。

    2 个输入 · 2 个输出 · 5 项配置
    条件分支
    判断规则
    result.risk < 0.7

    比较一个字段或表达式的结果,并进入对应分支。

    2 个输入 · 2 个输出 · 4 项配置
    符合其他
    82%
    准备运行准备运行
    ENGINE · COMPONENTS · CLI · SKILL

    一份节点清单怎样走到编辑器、CLI 和运行时

    Flow 1.1 提供 18 个公开节点。每个 manifest 都声明字段、端口、默认值和运行绑定。React 与 Vue 据此渲染界面,CLI 与 Skill 据此创建和校验文档。图通过校验以后,才交给持久执行引擎。

    节点 manifest字段、端口、默认值与运行绑定
    React 与 Vue节点卡片、配置表单与 Hooks
    CLI 与 Skill创建、连接、校验与语义摘要
    图编译器作用域、环路、端口与稳定顺序
    持久执行引擎事件、调度、恢复与 Worker
    01DURABLE ENGINE

    进程退出后,运行从已提交的事件继续

    工作流代码读取已经提交的历史,再返回下一项持久决定。步骤结果、等待时间、Hook、信号和子运行状态都写入同一条事件流。

    外部调用留在宿主任务中。Flow 可能再次交付同一任务,宿主可用运行 ID、节点 ID 和尝试次数生成幂等键。即使进程在调用成功后退出,下一次交付也能取回原结果。

    阅读执行模型
    一次恢复怎样发生run_01J8K4 · seq 18
    读取历史

    按事件序号读取已经提交的事实。

    history.read(run_id)事件 1 至 18 已提交
    02FRONTEND COMPONENTS

    节点卡片和配置表单读取同一份 manifest

    18 个公开节点覆盖入口、条件、任务、等待、审批、子工作流、运行终态和子画布容器。每个 manifest 同时声明字段、默认值、端口、运行绑定和持久身份。

    React 的节点卡片和配置面板直接读取 manifest,Vue Hook 管理同一种节点对象。CLI、Skill 和文档也查询这份目录,修改字段时不需要同步另一套手写结构。

    打开节点工作台
    任务执行flow.step
    执行任务
    任务
    task.run

    调用一个已注册任务,并按失败策略重试或继续。

    2 个输入 · 2 个输出 · 5 项配置
    配置面板
    执行任务

    调用一个已注册任务,并按失败策略重试或继续。

    任务名称
    task.run
    任务输入
    A3SFlowExpressionInput
    最多尝试次数
    IntInput
    重试间隔(毫秒)
    IntInput
    03AI WORKLOADS

    Agent 任务的重试由稳定身份约束

    模型调用、MCP 工具、业务 API 和人工审批通过宿主任务或等待节点接入。凭据和权限仍由宿主管理,Flow 保存每次决定以及已经确认的结果。

    Agent 任务

    宿主执行推理或多步 Agent,再用稳定步骤身份提交结果。

    StepCompleted

    工具调用

    任务调用本地工具、MCP 或业务服务,重试时沿用原输入。

    StepAttempted

    人工审批

    Hook 暂停运行并提供一次接收边界,等待期间不占 Worker。

    HookReceived

    子工作流

    父运行保存子项请求,并协调独立历史、终态和取消传播。

    ChildWorkflowResolved
    04DEVELOPER SURFACES

    同一份图可以在网页、脚本和编码 Agent 中编辑

    网页编辑器直接使用节点卡片与配置面板。脚本和编码 Agent 通过 CLI 或 Skill 读取同一份 manifest。节点创建完成以后,再统一校验连线、编译顺序并生成摘要。

    React 组件与 Hook

    一个 Hook 保存节点配置和展示状态,卡片与配置面板直接共享它。

    查看 React 接入
    react
    import { A3SFlowDagNodePreview,
      A3SFlowDagNodeConfigurationPanel,
      useA3SFlowNode } from '@a3s-lab/flow-ui/react';
    
    const { node, setNode } = useA3SFlowNode({
      id: 'agent-task', type: 'flow.step'
    });
    05RUNTIME PATH

    工作流定义进入运行时之前会经过四步

    作者图先检查字段、端口、作用域和环路,再编译成稳定执行计划。运行时命令写入事件历史,调度器和 Worker 只推进当前已经满足条件的工作。

    01Authoring18 个 manifest、节点卡片、配置面板
    02GraphDAG 校验、容器作用域、语义摘要
    03Runtime步骤、等待、Hook、信号、子运行
    04History事件、快照、恢复与并发序号
    内存、JSONL、SQLite、PostgreSQL嵌入式进程或共享任务队列中的 Worker
    START WITH A REAL RUN

    先用一条真实任务验证运行边界

    快速开始会执行任务、写入事件并读取最终快照。确认结果符合预期以后,再接入持久存储、节点组件和生产 Worker。

    开始构建工作流理解执行模型