LLM服务在教育管理系统中的价值,在于维护大模型服务配置、调用参数和接口连通性。模块需要和现有接口、权限、页面状态保持一致,不能只写成普通后台表格。

在这里插入图片描述

本文基于 系统功能/三方服务_LLM服务 对应源码,把业务目标拆成模型字段、接口规则、页面交互和验收标准,形成 Codex 可执行的项目代码生成任务。

设计与需求

LLM服务不能只按普通 CRUD 理解。源码范围包括 server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx,这些文件共同决定页面入口、字段保存、接口动作、权限边界和验收口径。交给 Codex 的任务需要明确业务字段、接口前缀、页面回显和异常处理,避免后端字段、前端表单和 PDD 文档相互脱节。

生成阶段

设计阶段

输入阶段

教育需求

LLM服务

页面结构

数据模型

接口规则

权限验收

读取源码

生成代码

验收修复

需求层描述 设计层转换 Codex 代码生成方向
业务目标 维护大模型服务配置、调用参数和接口连通性。 生成模块入口、页面结构和业务说明
数据模型 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口) 生成序列化、字段校验、查询筛选和保存回显
页面结构 server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx 生成列表、筛选区、表单、详情、预览或自定义操作区
接口规则 /api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/ 保持 GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting 与页面调用一致
权限验收 按钮权限、接口权限、用户数据范围、异常响应 在 PDD 中列出角色、接口和越权用例
扩展能力 数据联动、LLM 内容生成 只实现源码中真实存在的扩展入口和服务边界

更适合交给 Codex 的需求说明,应覆盖源码路径、字段、接口和验收口径。LLM服务的重点是把 AIServiceSetting 与前端接口封装、列表配置、表单状态或自定义页面逻辑合并成一个可测试的模块任务。

可以直接使用下面的Prompt进行模块功能的设计

请 Codex 基于教育管理系统真实源码设计“LLM服务”模块。

业务说明:维护大模型服务配置、调用参数和接口连通性。
源码范围:server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
接口范围:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)
已有动作:GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting
扩展能力边界:数据联动、LLM 内容生成

请输出模块页面结构、数据模型、接口规则、权限验收、测试用例和 Codex 代码生成任务。只允许使用源码中存在的字段、接口和页面状态。

后端设计

LLM服务的后端设计重点不是堆 CRUD 接口,而是建立可复用的数据底座。当前后端范围包括 server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py。Codex 需要识别模型字段、序列化器、ViewSet、筛选逻辑和自定义 action,并让接口返回结构稳定服务前端。

源码中可识别的模型或查询对象为 AIServiceSetting,核心字段覆盖 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)。接口动作包含 GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting,查询参数关注 category(category)、config(config)、fields(fields)、billing_rule(billing_rule)、provider(provider)、id(ID)、model_name(模型名称)、api_url(接口地址)、api_key(api_key)、save_data(save_data),这些内容需要和前端封装保持同名语义,避免页面有按钮但后端没有对应能力。

后端设计项 设计重点 Codex 生成方向
核心字段 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址) 生成序列化、查询筛选、表单回显和保存校验
补充字段 api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口) 处理状态、时间、JSON、资源或关联字段的格式转换
接口视图 server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py /api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/ 注册列表、详情、保存、删除和已有 action
查询筛选 category(category)、config(config)、fields(fields)、billing_rule(billing_rule)、provider(provider)、id(ID)、model_name(模型名称)、api_url(接口地址)、api_key(api_key)、save_data(save_data) 生成 filterset、SearchFilter 或自定义查询参数
权限控制 后端接口承担真实访问边界,前端按钮只做入口展示 生成权限判断、异常响应和越权测试
扩展服务 数据联动、LLM 内容生成 按真实源码补齐服务函数、异步任务或状态回写

可以直接使用下面的Prompt进行后端代码的设计

请 Codex 按“LLM服务”业务从源码上下文设计或补齐后端代码。

后端源码范围:server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py
模型或查询对象:AIServiceSetting
模型字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)
接口前缀:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
已有接口动作:GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting
查询参数:category(category)、config(config)、fields(fields)、billing_rule(billing_rule)、provider(provider)、id(ID)、model_name(模型名称)、api_url(接口地址)、api_key(api_key)、save_data(save_data)

需要生成或修正数据模型、序列化规则、接口视图、路由注册、筛选查询、权限控制和基础校验。同时补齐 数据联动、LLM 内容生成 对应的后端接口或服务边界。

输出时列出涉及文件、字段校验、接口返回结构和需要执行的测试。

前端设计

LLM服务的前端设计重点不是把字段堆到页面上,而是让用户能按业务路径完成查询、编辑、状态处理和结果确认。当前前端范围包括 server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx,其中 api.ts 负责接口封装,crud.tsxindex.vue 负责列表、表单、自定义布局和按钮交互。

页面需要围绕 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口) 组织筛选、表单和详情。保存前要处理字段格式转换,保存后刷新列表或回显详情;存在扩展能力时,还要把 数据联动、LLM 内容生成 的入口、状态和结果纳入同一套页面状态。

前端设计项 设计重点 Codex 生成方向
页面结构 server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx 生成列表、筛选区、表单、详情抽屉、弹窗或自定义操作区
接口封装 /api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/ 统一封装查询、详情、保存、删除和 GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting 等动作
字段回显 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口) 处理下拉、树形、JSON、状态、时间和资源字段回显
权限按钮 根据 auth、按钮权限或后端权限结果展示操作入口 生成新增、编辑、删除、处理、下载或预览按钮
扩展交互 数据联动、LLM 内容生成 生成入口按钮、加载状态、结果回填、人工确认和异常提示

可以直接使用下面的Prompt进行前端代码的设计

请 Codex 按“LLM服务”业务生成或补齐前端页面代码。

前端源码范围:server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
接口范围:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)
已有动作:GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting

需要生成页面结构、列表查询、筛选区域、新增编辑表单、详情预览、权限按钮、保存回显和接口调用;源码已有批量入口时再接入批量操作。涉及扩展交互时只实现源码已有的 数据联动、LLM 内容生成,包括入口按钮、状态提示、结果回填和保存回显。

输出时说明字段转换、表单初始化、异常提示和刷新策略。

扩展功能

LLM服务的扩展能力来自源码中的字段结构、接口动作或页面组件,不属于单纯 CRUD。它们的价值在于把教育管理系统中的生成、识别、统计、文件、审批、任务或批量流程接入真实业务数据。

扩展功能 主要用途 落地重点
数据联动 把筛选条件、树节点、状态字段、远程下拉和表单回显组织成稳定数据流。 字段变化要同步查询参数、保存载荷和回显结构,避免页面临时状态与后端字段脱节。
LLM 内容生成 把 Prompt、模型配置、生成接口和业务表单连接起来。 生成结果只回填表单或编辑区,由人工确认后再保存到正式数据。

数据联动

源码中的 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、接口参数和页面状态之间存在联动关系。Codex 生成时需要把查询条件、表单选择、字段转换和详情回显串成一条数据流,不能把每个下拉框或状态开关写成互不关联的临时变量。

结果阶段

处理阶段

输入阶段

筛选条件

表单选择

参数转换

接口请求

字段回显

列表刷新

状态更新

交给 Codex 生成时,边界要限定在 server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx 内。字段变化要同步查询参数、保存载荷和回显结构,避免页面临时状态与后端字段脱节。 同时需要补齐权限判断、异常提示、保存回显和测试用例。

可以直接使用下面的Prompt进行数据联动设计

请 Codex 基于真实源码补齐“LLM服务”的数据联动能力。

模块源码范围:server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
接口范围:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)
功能用途:把筛选条件、树节点、状态字段、远程下拉和表单回显组织成稳定数据流。
落地边界:字段变化要同步查询参数、保存载荷和回显结构,避免页面临时状态与后端字段脱节。

要求只使用源码中已经存在的字段、接口和页面状态,不新增未确认的业务能力。输出接口设计、前端交互、权限约束、异常处理和验收清单。

LLM 内容生成

LLM服务中的 LLM 能力服务于业务内容生成或服务测试。生成前需要收集当前记录、业务字段和附加要求,生成后只回填到表单或编辑区,正式保存仍走模块原有保存接口。

结果阶段

处理阶段

输入阶段

业务输入

生成入口

Prompt组装

模型调用

结果校验

表单回填

人工保存

交给 Codex 生成时,边界要限定在 server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx 内。生成结果只回填表单或编辑区,由人工确认后再保存到正式数据。 同时需要补齐权限判断、异常提示、保存回显和测试用例。

可以直接使用下面的Prompt进行LLM功能设计

请 Codex 基于真实源码补齐“LLM服务”的LLM 内容生成能力。

模块源码范围:server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
接口范围:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)
功能用途:把 Prompt、模型配置、生成接口和业务表单连接起来。
落地边界:生成结果只回填表单或编辑区,由人工确认后再保存到正式数据。

要求只使用源码中已经存在的字段、接口和页面状态,不新增未确认的业务能力。输出接口设计、前端交互、权限约束、异常处理和验收清单。

Codex开发标准

使用 Codex 开发 LLM服务 时,不能直接让它随意写代码。需求边界、PDD、SOP、接口权限规则和验收标准需要同时约束后端、前端和扩展能力,让生成结果能回到项目源码中运行。

验收交付

Codex开发

模块设计

输入约束

需求边界

PDD设计

SOP目录

接口权限

后端设计

前端设计

扩展功能

读取上下文

生成后端

生成前端

补齐扩展

功能自检

PDD验收

问题修复

模块交付

SOP 标准

SOP 用于约束代码目录、文件职责和开发顺序。Codex 在动手写代码前,需要先确认目录结构和文档位置,再按后端、前端、联动、验收的顺序推进。

docs/modules/LLM服务/
├── pdd.md
├── api.md
├── test-cases.md
└── codex-sop.md
server_backend/
└── dvadmin/system/models.py
└── dvadmin/system/urls.py
└── dvadmin/third_party_service/llm/api.py
└── dvadmin/third_party_service/views_setting.py
server_vue3/
└── src/views/system/ThirdPartyService/LLMSetting/api.ts
└── src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
开发阶段 Codex 执行目标 输出结果
模块设计 读取源码、确认字段、接口和页面入口 输出模块边界和设计说明
目录规划 规划后端、前端和 docs/modules 文档 输出目录结构和文件职责
后端实现 补齐模型、序列化、ViewSet、路由和权限 输出可调用接口和基础校验
前端实现 补齐 api.ts、crud.tsx、index.vue 或自定义组件 输出可操作页面和保存回显
数据联动或功能补齐 校验筛选、下拉、状态、详情和异常提示 输出联动说明和修复记录
扩展功能 按源码补齐 数据联动、LLM 内容生成 输出扩展接口、交互和边界测试
验收修复 按 PDD 和测试用例检查模块 输出验收结果和问题修复

可以直接使用下面的Prompt进行SOP撰写

请 Codex 按教育管理系统模块开发 SOP,从零实现或补齐“LLM服务”。

源码范围:server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
接口范围:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)

执行要求:
1. 先输出目录结构,不要直接写代码。
2. 先生成 docs/modules/LLM服务/pdd.md、api.md、test-cases.md 和 codex-sop.md。
3. 再根据文档生成后端代码、前端代码、接口封装、权限控制和测试用例。
4. 开发阶段需要包含 数据联动、LLM 内容生成,但只能写源码真实存在的能力。
5. 每个阶段输出涉及文件、修改目标和验收方式。

PDD 标准

PDD 是 LLM服务 的设计与验收文档,用于约束 Codex 输出是否符合真实业务。验收不能只看页面能否打开,还要检查字段、接口、权限、异常、回显和扩展功能是否与源码一致。

验收维度 验收重点 通过标准
业务目标 维护大模型服务配置、调用参数和接口连通性 页面和接口围绕该目标闭环
页面结构 server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx 列表、表单、详情或自定义操作区可用
数据模型 category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口) 字段保存、查询、回显和校验一致
接口规则 /api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/ GetList、GetDefalutModelList、saveDefaultSetting、GetDefalutSetting、GetObj、GetModelObj、AddObj、get_tencent_agent_config、save_tencent_agent_config、init_tencent_agent_config、init_fixtures、get_default_setting_models、get_default_setting、save_default_setting、get_app_setting、save_app_setting 能被前端正确调用
权限控制 按角色、按钮和接口权限检查 越权访问有后端拦截和错误响应
测试用例 覆盖新增、编辑、删除、查询、异常和回显 测试记录包含输入、输出和修复位置
数据联动 把筛选条件、树节点、状态字段、远程下拉和表单回显组织成稳定数据流。 字段变化要同步查询参数、保存载荷和回显结构,避免页面临时状态与后端字段脱节。
LLM 内容生成 把 Prompt、模型配置、生成接口和业务表单连接起来。 生成结果只回填表单或编辑区,由人工确认后再保存到正式数据。

可以直接使用下面的Prompt进行PDD 验收

请 Codex 根据 docs/modules/LLM服务/pdd.md 对“LLM服务”进行验收。

源码范围:server_backend/dvadmin/system/models.py、server_backend/dvadmin/system/urls.py、server_backend/dvadmin/third_party_service/llm/api.py、server_backend/dvadmin/third_party_service/views_setting.py、server_vue3/src/views/system/ThirdPartyService/LLMSetting/api.ts、server_vue3/src/views/system/ThirdPartyService/LLMSetting/components/PrividerModel/crud.tsx
接口范围:/api/system/ai_service_setting/、/api/system/ai_service_setting/get_default_setting_models/?category=LLM、/api/system/ai_service_setting/save_default_setting/、/api/system/ai_service_setting/get_default_setting/?category=LLM、/api/system/ai_service_setting/get_model_list/
字段范围:category(服务类型)、enabled(是否激活)、name_en(英文描述)、name_zh(中文描述)、logo(logo保存地址)、api_url(API请求地址)、api_url_create(任务创建接口)、api_url_upload(上传文件接口)、api_url_status(查询任务接口)、api_url_outputs(结果查询接口)、api_key(API密钥)、api_keys(API密钥列表)、api_area(API区域)、api_key_url(API Key 获取地址)、official_url(官网地址)、docs_url(文档说明)
验收范围必须包含 数据联动、LLM 内容生成。

请输出验收结果表,标记通过、未通过和需要修复的文件位置。不要只给结论,需要指出具体问题、影响范围和修复建议。

总结

LLM服务的开发价值在于维护大模型服务配置、调用参数和接口连通性。它把核心字段、接口规则和页面状态连成业务闭环,避免模块停留在普通列表维护。

Codex 开发该模块时,PDD 定义业务边界和验收标准,SOP 约束目录结构和开发顺序,Prompt 把页面、模型、接口、权限和扩展功能 分阶段交给 Codex 实现。

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐