Generated by Answer me with HTML 0.5.10 · 2026-11-04 15:34 · ★ Star on GitHub
01 · 从页面到两个创建接口
分清项目配置、具体输入,以及 HTTP 返回之后的异步边界。
页面上的信息分为哪三组
普通新建入口是 /crawl/form/create。
| 页面内容 | 示例 | 后端用途 |
|---|---|---|
| 项目 | 名称、归属、权限、限流、评估配置 | 建立管理与执行边界 |
| 环境 | App、模型、AB、输出能力 | 定义每套运行配置 |
| 输入来源 | 手动问题、文件、题集、历史会话 | 确定待执行输入 |
提交会结合场景注册表、App 和有效 recipe 判断链路。
编辑还会使用项目保存的 use_biz_storage。
这里只展开普通 next 新建使用的两个 Biz 接口。
为什么必须先创建项目
完整路径:
POST /admin/label/biz/add_evaluate_project/POST /admin/label/biz/create_tasks/
前端 await 第一个响应,再用 projectRes.evaluate_id 组装第二个请求。
可选 biz_project_id 不是本次后续请求使用的字段。
第二个请求失败时,前端不会自动回滚第一个项目。
代码阅读路径
useCrawlPageSubmit.handleSubmit → useSingleTaskSubmit → runNextLinkProjectSubmit。
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。
后端会归一化并补齐适用的产物策略。
创建项目时 Admin 做了什么
数据库事务内:
- 创建
evaluate_project壳。 - 创建当前新链路的
biz_project。 - 创建多个
biz_project_env。 - 回写壳的
biz_project_id。
当前新建通常让壳与 Biz 使用同一 ID。 历史数据仍需读取映射指针。
Scheduler 项目绑定发生在数据库事务之外。 绑定重试耗尽时返回错误,并尝试清理未绑定项目。 这一步还没有等待模型生成回答。
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 来源专题。
为什么 HTTP 成功后还没有抓取结果
后台上下文会保留 LogID 与租户信息。 原 HTTP 结束后,后台创建仍可继续。
普通 Pipeline.CreateBizTasks 使用兼容分发入口。
这里的兼容名称不表示抓取事实仍写旧表。
实际会创建 Biz Task、Scene 和对应兼容壳。
task_count 是本次受理的输入数量。
它不表示已经完成采样的题数。
后台创建失败时,HTTP 可能已经返回成功。
哪些边界会留下什么结果
| 失败位置 | 已有结果 | 继续核对什么 |
|---|---|---|
| 前端校验 | 尚未发出创建请求 | 表单和场景选择 |
| Project DB 事务 | 事务内写入会回滚 | 参数、配额、DB 错误 |
| Scheduler Project 绑定 | DB 事务已提交 | 绑定重试与未绑定清理 |
| 第二个 HTTP 请求 | 项目可以已经存在 | Task 请求参数与服务错误 |
| 异步输入创建 | HTTP 可以已成功 | 后台 LogID、来源解析、Task 行 |
| Task 调度下发 | 业务行可以已落库 | schedule_task_id 与补偿日志 |
先确认失败发生在哪个请求或后台步骤。两次请求没有共同回滚,重发整组请求可能再建一个项目。
周期、实时、编辑和宿主嵌入表单有独立分支。 不要把普通双接口顺序套到所有入口。
去哪里读源码并进入下一步
| 想核对的问题 | 仓库与入口 |
|---|---|
| 前端请求顺序 | 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 |
这一章结束时,应能区分:项目配置已保存、题目已受理、题目已落库、调度已绑定。