Generated by Answer me with HTML 0.5.10 · 2026-11-04 15:34 · ★ Star on GitHub

01 · 从页面到两个创建接口

分清项目配置、具体输入,以及 HTTP 返回之后的异步边界。

核对日期2026-11-03

先保存项目和环境,再向该项目提交输入。两个请求顺序执行,但不共享事务。

回到总览 · 下一章:数据与调度

A

页面上的信息分为哪三组

普通新建入口是 /crawl/form/create。

页面内容 示例 后端用途
项目 名称、归属、权限、限流、评估配置 建立管理与执行边界
环境 App、模型、AB、输出能力 定义每套运行配置
输入来源 手动问题、文件、题集、历史会话 确定待执行输入
本文主线表单校验与参数准备链路判断next 提交编排Project payloadTask source payload

提交会结合场景注册表、App 和有效 recipe 判断链路。 编辑还会使用项目保存的 use_biz_storage。 这里只展开普通 next 新建使用的两个 Biz 接口。

B

为什么必须先创建项目

前端AdminSchedulerPOST add_evaluate_project1CreateProject2schedule_project_id3evaluate_id4POST create_tasks,携带 evaluate_id5本次输入受理结果6两次 HTTP 请求不共享事务

完整路径:

  • POST /admin/label/biz/add_evaluate_project/
  • POST /admin/label/biz/create_tasks/

前端 await 第一个响应,再用 projectRes.evaluate_id 组装第二个请求。 可选 biz_project_id 不是本次后续请求使用的字段。 第二个请求失败时,前端不会自动回滚第一个项目。

代码阅读路径

useCrawlPageSubmit.handleSubmit → useSingleTaskSubmit → runNextLinkProjectSubmit。

C

Project payload 表达哪些配置

后端 DTO 按 project 与 envs[] 分层。 下表展示配置职责,不是可直接调用的完整请求。

配置层 字段或内容 解决的问题
Project name、owner、tenant、权限 归谁管理
Project query_src_info、prompt_config 输入从哪里来,如何组织
Project limit_info 如何限制执行资源
Project crawl_config 业务抓取与过滤能力
Project schedule_config 定时、周期、Lane 上下文
Project auto_eval_info 抓取之后如何自动评估
Env env_config 如何运行模型或应用
Env business_config 业务补充与复用配置
Env output_config 输出与导出策略
Env artifact_config 启用哪些产物,如何覆盖默认值

前端 query_config[] 会转换为后端 envs[]。 params_jsonstr 可作为配置底稿,再合并显式环境字段。 当前普通 Env adapter 不显式输出完整外层 artifact_config。 后端会归一化并补齐适用的产物策略。

D

创建项目时 Admin 做了什么

接收 JSON身份与参数校验场景与配置校验owner 配额校验项目与环境事务Scheduler 创建项目绑定调度项目 ID返回 evaluate_id

数据库事务内:

  1. 创建 evaluate_project 壳。
  2. 创建当前新链路的 biz_project。
  3. 创建多个 biz_project_env。
  4. 回写壳的 biz_project_id。

当前新建通常让壳与 Biz 使用同一 ID。 历史数据仍需读取映射指针。

Scheduler 项目绑定发生在数据库事务之外。 绑定重试耗尽时返回错误,并尝试清理未绑定项目。 这一步还没有等待模型生成回答。

E

E create_tasks 如何得到具体题目

Task 请求携带 evaluate_id 和输入来源参数。 Project 的 query_src_info 保存来源描述。 Task 请求负责真正取得输入或启动取题流程。

页面来源 API source_type 后端处理
手动输入或文件 0 读取 query_list,或解析文件
在线题集 100 按题集与选题条件取得题目
实时来源 6 建立持续取题和终止条件
历史数据 58 根据来源与会话条件取得输入
Session 回放 52 / 60 使用专用回放分支

页面来源枚举与 API 数字不同,必须通过 adapter 转换。 一条 Task 可以包含多轮 Prompt、图片和附件。 普通输入会标准化为 QueryInfo 和 PromptDetailJSON。

历史数据的具体取数服务见历史 Prompt 来源专题。

F

为什么 HTTP 成功后还没有抓取结果

请求受理后台执行校验项目与来源取得 QueryInfo 列表提交后台创建HTTP 返回 task_count标准化输入创建 Task 与 Scene下发 Scheduler绑定调度 ID

后台上下文会保留 LogID 与租户信息。 原 HTTP 结束后,后台创建仍可继续。

普通 Pipeline.CreateBizTasks 使用兼容分发入口。 这里的兼容名称不表示抓取事实仍写旧表。 实际会创建 Biz Task、Scene 和对应兼容壳。

task_count 是本次受理的输入数量。 它不表示已经完成采样的题数。 后台创建失败时,HTTP 可能已经返回成功。

G

哪些边界会留下什么结果

失败位置 已有结果 继续核对什么
前端校验 尚未发出创建请求 表单和场景选择
Project DB 事务 事务内写入会回滚 参数、配额、DB 错误
Scheduler Project 绑定 DB 事务已提交 绑定重试与未绑定清理
第二个 HTTP 请求 项目可以已经存在 Task 请求参数与服务错误
异步输入创建 HTTP 可以已成功 后台 LogID、来源解析、Task 行
Task 调度下发 业务行可以已落库 schedule_task_id 与补偿日志
不要整组盲目重复提交

先确认失败发生在哪个请求或后台步骤。两次请求没有共同回滚,重发整组请求可能再建一个项目。

周期、实时、编辑和宿主嵌入表单有独立分支。 不要把普通双接口顺序套到所有入口。

H

去哪里读源码并进入下一步

想核对的问题 仓库与入口
前端请求顺序 eval-fe-search-chat/apps/evaluate/src/routes/crawl/form/[mode]/data/crawlTask.mutation.ts:222
Project adapter eval-fe-search-chat/apps/evaluate/src/routes/crawl/form/[mode]/adapters/next-link/projectAdapter.ts:8
来源构建 eval-fe-search-chat/apps/evaluate/src/routes/crawl/form/[mode]/adapters/next-link/sourceBuilders.ts:408
Project DTO eval-crawl-admin/views/biz_create_entry.go:193
项目 Pipeline eval-crawl-admin/service/bizcreate/pipeline.go:901
项目事务 eval-crawl-admin/service/repository/project.go:415
创建任务入口 eval-crawl-admin/views/biz_create_entry.go:5715
后台创建 eval-crawl-admin/views/biz_create_entry.go:5135

这一章结束时,应能区分:项目配置已保存、题目已受理、题目已落库、调度已绑定。

回到总览 · 下一章:Task、Scene 与调度