Skip to content

Forge 快速入门 内测中 ​

5 分钟跑通你的第一个 AI Agent workflow。本文配合 Beta 邀请使用 —— 注册即送示例 dataset / rubric / workflow,跟着 5 步走完一遍就知道 Forge 长什么样。

Beta 范围

当前是受邀内测,10-15 个早期用户。试用反馈请见本文末 §5 遇到问题怎么办。

§1 30 秒认识 Forge ​

AI Agent 工作台:浏览器里画 / 跑 / 评估 Agent 工作流,崩溃自动续跑,不重复花 LLM token。

WAL-first 持久执行

底层 Kova(Rust 持久执行引擎,崩溃恢复——不是 checkpoint,每个 LLM Directive 都落盘)。

零外部依赖

运行时单二进制 + 单 WAL 文件,无需 Kafka / Redis / Cassandra。

OpenAI 兼容网关

LLM 经 newapi 网关,可切 OpenAI / Anthropic / DeepSeek / 通义 / GLM。

每步可审计

每次步骤和人工审批签名落盘,满足 EU AI Act + GB/T 信创。


§2 跑第一个 workflow ​

前置条件

已收到 Beta 邀请并在 forge.lurus.cn 完成注册登录。

  1. 打开 /workflows/runs,点 "启动新 run"。

  2. 选 seed 的 classify_then_route_v1,输入框填中文(如 今天上海天气怎么样),点 Start。

  3. 页面跳转 /workflows/runs/[id],timeline 卡片实时刷新(passthrough → llm_call → branch → leaf 四步)。预期 < 30 秒(newapi.lurus.cn 在线时)。

LLM 慢 / 失败

LLM 超时 / 失败时 run 状态变 failed 并显示错误——这是 Kova WAL 崩溃恢复在工作,后续可 resume 不重跑前面步骤。

§3 中间审批节点(HITL) ​

workflow 含 await_input step(如"高风险操作前请审批"模板)时:

  1. 跑到该步暂停,状态变 AwaitingInput。

  2. /approvals 看到一行待审(标题是该 step 的 prompt)。

  3. 点 "Review",选 Approve / Reject / Edit 提交,workflow 自动续跑。

审批决策写进 WAL 永久可追溯,刷新 / 关 tab 不丢状态。

mermaid
sequenceDiagram
    participant U as 你 (操作员)
    participant F as Forge UI
    participant K as Kova 引擎
    participant W as WAL 文件

    U->>F: 启动 workflow
    F->>K: POST /workflows/start
    K->>W: 写 WorkflowStart (event=37)
    loop 每步
        K->>W: 写 StepCheckpoint
    end
    K->>W: 写 WorkflowAwaitInput (event=38)
    K-->>F: 状态 = AwaitingInput
    F-->>U: /approvals 出现一行待审
    U->>F: 点 Approve
    F->>K: POST /workflows/:id/resume
    K->>W: 写 WorkflowInputReceived (event=39)
    K->>W: 继续 StepCheckpoint
    K-->>F: 状态 = Completed

§4 评分(Eval)一个 run ​

  1. 打开 /eval → Rubrics tab,选 seed 的 Sample rubric (PII) 或自建。

  2. 切到 Runs,关联刚跑完的 workflow_id。

  3. 点 Score,后台跑 scorer,看每条 criterion 的分数 + 解释。

可用的 scorer 类型

类型用途配置
pii_regex检测 LLM 输出里有没有泄露身份证 / 手机号 / 邮箱写正则 pattern
json_schema检查输出符合 JSON schema(结构化生成场景)贴 JSON schema
llm_as_judge让另一个 LLM 给主 LLM 输出打分写 judge prompt + 选 model + temperature
semantic_similarity(WIP,暂不可用 —— embedding service 还在搭)—

§5 遇到问题怎么办 ​

workflow 一直 Running 不动?

多半是 LLM 网关超时(30 s)。看 /workflows/runs/[id] timeline 卡片最后一步是什么;如果是 llm_call,等或者 cancel run 后重试。

403 You do not have permission?

你在试图操作别人的 approval。只有发起人本人或同 tenant_id 才能决策 —— 找发起人。

404 Approval not found?

approval 已被 cancel 或终态。找发起人确认;终态不可改。

/workflows/runs 一直 loading?

kova_proxy 连不上 kova-rest。检查 /api/health,看第二段 kova_rest 是否 ok。

中文显示乱码 / 没翻译?

i18n key 缺。反馈 + 截图(见 §6 反馈)。


§6 反馈 ​

发现 bug、想要新功能、想跟我们 30 分钟聊聊使用场景:

Typeform 表单

嵌入在 /settings 页底——30 秒填完,对外部用户最快。

Discord

邀请链接见 footer,开发者向用户首选。

邮件

forge-beta@lurus.cn,24h 内回复 SLA。

Beta 期间所有反馈直接进 roadmap。期待你的使用。


接下来


最后更新: 2026-05-12 | 配套 Beta 邀请 playbook: 2b-bs-forge/docs/beta-invite-playbook.md

Powered by Lurus Technologies