华数杯数学建模竞赛有一个很真实的情况比赛时间紧张赛题发散论文要求高。很多队伍不是不会建模而是卡在“怎么把思路快速落地成代码再快速整理成论文素材”。我这次想分享的是一个可以随手用的AI智能体方案——把它搭好之后读题、检索相关资料、生成Python代码、整理论文章节初稿都能在同一个工作台里完成。先说结论这件事不需要买昂贵显卡。智能体跑在云端平台知识库和模型调用都走HTTP接口本地只需要一个浏览器加一个Python环境用来验证生成的代码。你真正需要花时间的是两件事把历年华数杯赛题、算法模板、团队笔记整理成一个知识库把“赛题分析—知识检索—代码生成—论文润色”的工作流调通。这篇文章会从零教你搭一套“数模竞赛辅助智能体”。内容覆盖智能体架构、知识库向量检索、工作流配置、API调用、批量任务和常见问题排查。如果你团队里正好有准备华数杯的同学建议把这篇发给队长跟着搭一遍能省不少事。1. 核心能力速览能力项说明智能体类型数学建模竞赛辅助智能体RAG 工作流核心功能赛题解析、算法推荐、Python代码生成、论文素材整理、批量数据处理知识库数学建模论文库、算法模板库、赛题数据说明以向量数据库存储支持平台扣子Coze、Dify等智能体平台或自建服务显存需求使用云端大模型API时本地无需GPU本地部署模型需按实际模型测试启动方式Web页面拖拽配置、API服务调用是否支持API是智能体平台一般提供HTTP接口是否支持批量任务是通过工作流循环或外部脚本批量调用适合场景数模竞赛、学术写作辅助、自动化数据分析这套方案的重点不是训练模型而是把现有的大模型能力编排成一条可复用的工作流。智能体负责理解问题、从知识库里找依据、生成代码和文字初稿人负责验证、修正和最终决策。分工明确之后竞赛期间的高频重复劳动可以被压缩到很短时间内。2. 适用场景与使用边界2.1 适合谁用首先要明确这套AI智能体不是“自动答题器”而是“效率增强工具”。它适合下面几类人已经具备一定Python和建模基础想在竞赛期间减少重复代码编写时间的参赛队伍。团队里有论文手、建模手、编程手但缺少一名“资料检索员”希望用知识库统一管理历年论文和算法模板。正在从零学习数学建模希望通过智能体快速了解某个算法适用场景和实现框架的学生。指导教师需要快速评估多份赛题思路用智能体做初步方案筛选。如果把智能体当作“输入赛题直接输出完整论文”的工具那方向就错了。当前大模型生成的代码和文字仍然会出现幻觉直接提交会带来很大风险。正确的用法是把它当做一个“带资料检索能力的编程助手”人做最终把关。2.2 能解决什么问题赛题理解阶段输入题目文字智能体输出问题背景、目标函数、约束条件、可选的建模思路。建模选型阶段根据数据规模和问题类型推荐回归、分类、优化、微分方程、图论等具体方法。代码实现阶段生成带注释的Python代码包括数据读取、特征工程、模型训练、结果可视化。论文写作阶段生成“模型建立与求解”章节的大纲以及结果分析部分的初稿。批量处理阶段一次性处理多个问题比如多张数据表的统计描述或多个算法的效果对比。2.3 使用边界与合规提醒这一点必须放在前面数学建模竞赛允许使用编程工具但AI工具是否允许、是否需要申报要以华数杯当年官方通知为准。使用智能体辅助不等于可以代写论文。论文中的核心模型、推导过程和最终结论必须由参赛队员自己理解并负责。同时要注意隐私与版权边界未公开的赛题数据不要上传到不受控的第三方服务。如果赛题有保密要求优先使用本地部署的模型和知识库。知识库中的历年论文如果来源不明不要直接照搬全文只抽取方法描述和结构思路并在论文中正确引用。生成代码如果涉及第三方库注意依赖版本和开源许可。3. 环境准备与前置条件搭建这套智能体依赖一个“平台 知识库 模型服务 本地验证环境”的组合。下面是一份通用检查清单。3.1 智能体平台推荐从成熟平台入手减少运维成本。扣子Coze国内访问方便自带知识库、工作流、插件和市场模型适合快速搭建。Dify开源项目支持本地部署也提供云服务适合有自部署需求的团队。FastGPT偏知识库问答适合做论文检索和赛题问答。如果团队有开发能力也可以完全自建大模型API 向量数据库 Web服务。但考虑到竞赛时间窗口短建议首次使用先从扣子Coze或Dify这类平台起步。3.2 Python本地环境智能体生成的代码最终要落地跑通所以本地必须有一套可运行的Python环境。# 建议使用 Anaconda 创建独立环境 conda create -n math_model python3.10 -y conda activate math_model # 基础数学建模常用库 pip install numpy pandas scipy scikit-learn matplotlib seaborn openpyxl以上命令是通用安装方式实际使用时按团队需要增加库。Jupyter Notebook推荐同时安装因为竞赛期间需要频繁做数据探索和代码调试。3.3 知识库与向量数据库知识库的作用是把“历年华数杯优秀论文、算法模板、团队笔记”这些非结构化资料变成可供大模型检索的依据。关于“企业知识库是存放在向量数据库中的吗”这个问题答案是知识库本身是文档集合但为了支持语义检索文档会被切分成文本块再通过Embedding模型转换成向量存放在向量数据库中。查询时系统把用户问题也转换成向量检索出最相似的一段或几段文本拼进Prompt喂给大模型。常见向量数据库向量数据库特点适用场景Chroma轻量本地文件存储小规模知识库测试QdrantRust实现性能好中大规模知识库Milvus分布式功能全面团队级知识库平台内置知识库免运维快速搭建验证如果是第一次测试直接用智能体平台自带的知识库功能即可不需要单独部署向量数据库。后面知识库大了再迁移到独立向量数据库不迟。3.4 大模型API智能体的核心推理能力来自大模型。两种路线云端API路线使用平台自带模型或接入DeepSeek、通义千问等API。优点是本地无硬件压力缺点是需要网络和API额度。本地部署路线使用Ollama或LM Studio跑Qwen等开源模型。优点是数据不出内网缺点是需要显存和调试时间。竞赛期间建议优先用云端API路线把时间集中在业务逻辑上。4. 智能体架构与知识库设计4.1 整体架构一个数模竞赛辅助智能体的结构通常是四层输入层用户输入赛题文字、数据说明或具体问题。编排层工作流节点负责调用知识库、大模型、代码解释器。存储层向量数据库存放文档切片本地文件系统存放数据和输出结果。输出层返回结构化分析、代码、Markdown论文素材。编排层的核心是一个“先检索后生成”的RAG流程。当用户问“这个优化问题应该用什么算法”时工作流先到知识库检索“优化算法”“TSP问题”“遗传算法”等关键词的语义相似内容再把检索结果拼进Prompt让大模型基于这些内容回答。4.2 知识库内容设计知识库质量直接决定智能体的回答质量。建议建立三个独立知识库第一个是赛题库包含近几年公开的赛题题目、数据说明、解题思路摘要。这部分用来帮助智能体快速理解“这类问题以前是怎么解的”。第二个是算法模板库包含线性回归、逻辑回归、决策树、随机森林、XGBoost、遗传算法、模拟退火、排队论、层次分析法等算法的适用条件、伪代码、注意事项。这是智能体生成代码时最主要的依据。第三个是写作素材库包含论文结构模板、常用句式、图表描述模板、误差分析写法。这部分主要服务论文润色节点。4.3 文档切块示例知识库文档不能整篇塞给模型需要切块。切块太小语义不完整太大检索不够精确。一般以500到1500字为一块比较常见。下面是一个通用切块示例。from langchain.text_splitter import MarkdownHeaderTextSplitter # 通用示例读取Markdown格式的算法文档按标题切块 headers_to_split_on [ (#, H1), (##, H2), (###, H3), ] splitter MarkdownHeaderTextSplitter(headers_to_split_onheaders_to_split_on) with open(algorithm_templates.md, r, encodingutf-8) as f: content f.read() chunks splitter.split_text(content) print(f分块数量: {len(chunks)}) for chunk in chunks[:3]: print(chunk.metadata) print(chunk.page_content[:200])这段代码只是一个片段实际运行时需要安装langchain并且根据文档格式调整分隔符。切块之后每个块会被Embedding成向量再入库。4.4 提示词工程建议智能体的效果很大程度取决于提示词。给“赛题分析节点”和“代码生成节点”使用不同的提示词效果会明显更好。赛题分析节点提示词模板你是数学建模竞赛指导助手。请按以下结构分析用户提供的赛题 1. 问题重述用三句话概括题目要求。 2. 目标分析列出需要优化的核心目标。 3. 约束条件列出题目中的限制条件。 4. 可行方法结合知识库检索结果列举3种可行建模思路并说明适用性。 5. 风险提示指出数据量和计算资源的潜在瓶颈。 回答语言中文。不要直接给出完整代码。代码生成节点提示词模板你是Python算法工程师。根据用户描述的数据格式和建模方法生成完整可运行的Python代码。 要求 - 使用pandas读取数据字段名用占位符表示。 - 包含数据清洗、特征构造、模型训练、结果评估、可视化五个部分。 - 关键步骤添加中文注释。 - 如果数据量较大优先使用适合大规模数据的实现。这样的提示词能让输出更结构化减少“模型自说自话”的情况。5. 搭建与部署工作流配置5.1 在智能体平台上创建一个数模助手以扣子Coze为例通用流程如下登录平台进入“智能体”页面点击创建智能体。填写名称例如“华数杯数模助手”选择基础模型。在人设与提示词中粘贴上一步写好的赛题分析提示词。在知识库模块创建三个知识库赛题库、算法模板库、写作素材库上传处理好的文档。创建工作流开始节点 → 知识库检索节点 → 大模型节点 → 结束节点。工作流中把知识库检索结果作为上下文变量传给大模型节点。保存并预览先在调试窗口输入一条简单问题测试。需要说明的是平台界面和字段名称会不断更新具体以实际页面为准。整个搭建过程的核心思路是每一个工作流节点只做一件事节点之间通过变量传递数据。5.2 工作流节点设计推荐在智能体内建立多个独立工作流而不是把全部逻辑塞进一个流程里。第一个工作流叫“赛题解析”输入赛题文字输出问题重述、目标分析、约束条件和可行方法。第二个工作流叫“代码生成”输入数据格式说明和建模方法输出带注释的Python代码。第三个工作流叫“论文润色”输入论文片段输出结构化的章节初稿和常用句式建议。拆分成三个独立工作流的好处是某一环节出错时不会影响其他环节遇到新赛题时可以单独重新编排其中一步。5.3 知识库检索参数知识库检索节点的关键参数有召回条数一般设置为3到5条。太少可能漏信息太多会撑爆Prompt长度。相似度阈值低于阈值的结果直接丢弃。建议从0.3开始调试根据实际问答效果调整。检索范围可以选择只检索某个知识库也可以跨库检索。竞赛阶段建议分开检索避免论文素材干扰代码生成。6. 功能测试与效果验证智能体搭好后不要急着上赛题先跑一组标准测试用例。下面给出四个测试维度和对应的验证方法。6.1 测试一赛题解析能力输入一条模拟赛题描述例如某快递公司在一个城市有50个配送站点和1个配送中心车辆载重有限每天需要规划配送路线使总行驶距离最小。请给出建模思路。预期结果智能体输出问题重述、优化目标、约束条件并推荐车辆路径问题或TSP相关算法同时指出数据量和求解时间是风险点。判断标准输出的结构是否完整推荐算法是否与赛题匹配。如果智能体只给出一个笼统的“用机器学习”方案说明知识库缺少运筹优化类内容需要补充算法模板。6.2 测试二代码生成与本地运行向智能体提问请用Python读取data.csv字段包括id、x1、x2、y。要求做线性回归并输出R方和特征重要性。把生成的代码复制到本地Jupyter运行。如果代码缺少字段名处理或没有导入pandas需要调整提示词要求“使用占位符表示字段名”并“包含必要的import语句”。这个环节最容易暴露模型幻觉所以代码务必在本地跑通后再进入正式工作流。6.3 测试三知识库命中率在知识库中放入一篇关于“遗传算法求解TSP”的模板然后向智能体提问有100个城市的TSP问题数据量为100×100的距离矩阵应该用什么算法观察智能体是否引用了知识库内容。如果它的回答和知识库模板毫无关系说明检索节点配置有问题优先检查文档是否已经完成向量化、召回条数是否过少。6.4 测试四批量问题处理竞赛期间需要同时处理多个小问题例如多个数据表的统计描述。可以把问题写成一个文本文件逐行读取后调用智能体API批量处理。下面是一个通用Python调用示例import requests import time API_URL https://api.example.com/v1/chat # 以实际平台接口为准 API_KEY 替换为你的访问令牌 def ask_assistant(question): headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } payload { model: 你的模型名, messages: [ {role: user, content: question} ] } resp requests.post(API_URL, jsonpayload, headersheaders, timeout120) return resp.json() questions [ 对data1.csv做描述性统计输出均值、中位数、标准差, 对data2.csv检查缺失值并给出处理方案, 比较data3中A和B两个分组的均值差异 ] for q in questions: result ask_assistant(q) print(result.get(choices, [{}])[0].get(message, {}).get(content, result)) time.sleep(2)这段代码是通用模板字段名和URL必须根据实际平台替换。批量任务的核心是增加间隔和重试机制避免触发限流。7. 接口API与批量任务7.1 发布为API服务智能体在平台上完成测试后需要发布为API服务才能被外部脚本调用。发布后通常获得一个HTTP接口地址、访问令牌和工作流ID或智能体ID。调用方式一般有两种对话接口发送用户问题返回大模型回答。适合在线问答和论文草稿生成。工作流接口指定工作流ID传入工作流参数返回节点输出。适合批量执行固定流程。竞赛团队建议优先使用工作流接口因为赛题解析、代码生成、论文润色是三条固定流程直接用工作流接口更稳定。7.2 批量任务设计批量任务适合以下场景对多个数据表执行相同的数据探索。对多篇参考资料做摘要提取。对论文的多个章节分别生成润色建议。在脚本层面可以做一个简单的队列和重试设计。import time import requests TASK_QUEUE [ task1_description, task2_description, task3_description, ] def call_api(task): # 伪代码实际替换为平台接口 resp requests.post(API_URL, json{task: task}, timeout120) if resp.status_code 429: raise RuntimeError(rate limit) return resp.json() for task in TASK_QUEUE: retry 0 while retry 3: try: output call_api(task) print(task, OK, output) break except Exception as e: retry 1 print(task, retry, retry, str(e)) time.sleep(10) time.sleep(3)批量任务务必记录每个任务的输入与输出建议统一保存为JSON文件方便赛后复盘和审计。7.3 输出格式约定为了让批量结果能被下一个环节消费建议在提示词中要求智能体输出JSON格式。请以JSON格式返回结果包含字段 { summary: 简短结论, code: 生成的代码, risk: 潜在风险 }然后脚本解析JSON自动写入文件。import json def save_result(task, raw_output): parsed json.loads(raw_output) with open(fresult_{task}.json, w, encodingutf-8) as f: json.dump(parsed, f, ensure_asciiFalse, indent2)这样可以避免在大量自由文本中人工查找关键信息。8. 资源占用与性能观察8.1 云端API路线使用云端智能体平台时本地资源占用非常低主要消耗的是网络带宽和API请求额度。观察重点三个方面单次请求延迟普通问答通常在几秒到十几秒如果超过60秒需要检查Prompt是否过长或模型是否负载过高。API限流批量任务最容易触发限流。建议在脚本中加入指数退避重试。成本控制每天记录调用次数和Token消耗设置预算上限避免竞赛期间额度用完。8.2 本地部署路线如果赛题数据有保密要求可以选择本地部署大模型。此时需要关注显存占用。不同参数量的模型显存需求差异很大没有一个固定值必须以实际模型和量化方式为准。降低显存占用的通用手段使用量化版本模型例如4-bit量化。降低最大生成长度。显存不足时让Embedding模型走CPU只把大模型放GPU。使用Ollama等框架自动管理模型加载和释放。8.3 知识库检索性能知识库文档数量不大时检索时间基本可忽略。但当文档数量上万时要关注向量数据库的查询延迟。常见优化方式控制单个文档切块的大小。按知识库主题分库缩小单次检索范围。如果检索结果不准确优先增加召回条数而不是扩大检索范围。9. 常见问题与排查方法下面是搭建和运行过程中最高频的问题按现象、原因、排查方式、解决方案拆开。问题现象可能原因排查方式解决方案知识库检索不到内容文档未完成向量化或切块失败查看知识库文档状态重新上传并确认Embedding成功智能体回答和知识库无关检索召回条数过少或阈值过高在调试窗口查看检索结果增加召回条数降低相似度阈值生成的代码运行报错大模型幻觉缺少import或字段名本地运行看具体报错调整提示词要求先解释算法再写代码批量任务大面积超时单次请求文本过长查看日志中的请求时长拆分子任务限制输入长度API返回限流错误请求频率超过平台限制检查响应状态码增加sleep间隔并加入重试上传PDF后知识库乱码扫描版PDF无法直接读取打开PDF查看文字层先用OCR转换为文本再入库智能体输出内容空洞提示词约束不足检查提示词是否要求结构化输出使用分点、JSON、公式等格式约束论文素材风格不统一写作素材库样本过少检查知识库内容覆盖度补充优秀论文结构模板排查顺序通常是先看输入是否正确再看知识库是否命中最后看大模型输出。不要一上来怀疑模型能力大部分问题都出在前面环节。10. 最佳实践与合规提醒10.1 工程化使用建议第一先跑通最小闭环。不要一开始就把全套工作流搭完先用一个知识库加一个赛题解析节点输入一条赛题确认输出可用后再加代码生成节点。第二保留一套最小可运行配置。竞赛期间很容易改坏工作流建议把稳定版本的提示词、知识库、工作流快照保存好出了问题可以回滚。第三目录管理要规范。所有模型输入、生成的代码、输出结果按日期分类存放。math_model_team/ ├── knowledge_base/ # 知识库原始文档 ├── data/ # 赛题数据 ├── scripts/ # 本地验证脚本 ├── output/ # 智能体生成的代码和结果 │ ├── 20250420/ │ └── 20250421/ └── prompts/ # 提示词备份第四为智能体的每次生成结果做记录。输出文件命名时带上任务ID、时间和模型名方便赛后复现。10.2 竞赛合规与学术诚信使用AI智能体辅助数学建模竞赛最终提交的论文和代码必须由团队自己负责。建议遵守以下原则以华数杯官方规则为准确认AI工具是否允许使用、是否需要声明。不要把未公开的赛题数据上传到无法控制的外部平台。知识库中的历年论文只用作方法参考不复制原文。比赛结束后如果需要公开代码和论文要隐去敏感数据并检查版权。遇到“直接生成整篇论文”的诉求时智能体不应该被配置成这样工作人必须参与核心建模和写作。10.3 提升生成质量的小技巧给智能体提供数据样例前几行它生成的代码更容易匹配真实字段。生成代码后立即本地运行把报错信息回传给智能体让它修复。对回复内容敏感的任务要求智能体标注信息来源。如果感觉回答质量下降先检查Prompt长度是不是被检索内容撑爆再检查模型是否选错。11. 总结与下一步这套“华数杯AI智能体”最有价值的点是把知识库检索、大模型生成和批量任务编排成了一条可以复用的工作流。它不解决所有问题但能把竞赛中查资料、写代码、整理论文素材这几个环节的重复劳动降下来。建议第一步先验证两个核心能力赛题解析和Python代码生成。把这两个节点调通后再加入论文润色和批量任务。最容易踩的坑有三个知识库质量差导致检索不准、提示词没有结构导致输出发散、批量任务触发限流导致脚本卡死。这三个问题都在本文前面给出了对应的排查方式。下一步可以考虑把工作流扩展到其他团队场景比如把知识库替换成课程资料变成学习助手或者把代码生成节点接到自动执行环境让智能体不仅能写代码还能直接运行代码。基础架构是一样的换一层业务数据就能复用。建议收藏备用比赛前一周搭好赛题发布当天就能直接用。 数模竞赛AI智能体搭建：从知识库向量检索到代码生成全流程
华数杯数学建模竞赛有一个很真实的情况比赛时间紧张赛题发散论文要求高。很多队伍不是不会建模而是卡在“怎么把思路快速落地成代码再快速整理成论文素材”。我这次想分享的是一个可以随手用的AI智能体方案——把它搭好之后读题、检索相关资料、生成Python代码、整理论文章节初稿都能在同一个工作台里完成。先说结论这件事不需要买昂贵显卡。智能体跑在云端平台知识库和模型调用都走HTTP接口本地只需要一个浏览器加一个Python环境用来验证生成的代码。你真正需要花时间的是两件事把历年华数杯赛题、算法模板、团队笔记整理成一个知识库把“赛题分析—知识检索—代码生成—论文润色”的工作流调通。这篇文章会从零教你搭一套“数模竞赛辅助智能体”。内容覆盖智能体架构、知识库向量检索、工作流配置、API调用、批量任务和常见问题排查。如果你团队里正好有准备华数杯的同学建议把这篇发给队长跟着搭一遍能省不少事。1. 核心能力速览能力项说明智能体类型数学建模竞赛辅助智能体RAG 工作流核心功能赛题解析、算法推荐、Python代码生成、论文素材整理、批量数据处理知识库数学建模论文库、算法模板库、赛题数据说明以向量数据库存储支持平台扣子Coze、Dify等智能体平台或自建服务显存需求使用云端大模型API时本地无需GPU本地部署模型需按实际模型测试启动方式Web页面拖拽配置、API服务调用是否支持API是智能体平台一般提供HTTP接口是否支持批量任务是通过工作流循环或外部脚本批量调用适合场景数模竞赛、学术写作辅助、自动化数据分析这套方案的重点不是训练模型而是把现有的大模型能力编排成一条可复用的工作流。智能体负责理解问题、从知识库里找依据、生成代码和文字初稿人负责验证、修正和最终决策。分工明确之后竞赛期间的高频重复劳动可以被压缩到很短时间内。2. 适用场景与使用边界2.1 适合谁用首先要明确这套AI智能体不是“自动答题器”而是“效率增强工具”。它适合下面几类人已经具备一定Python和建模基础想在竞赛期间减少重复代码编写时间的参赛队伍。团队里有论文手、建模手、编程手但缺少一名“资料检索员”希望用知识库统一管理历年论文和算法模板。正在从零学习数学建模希望通过智能体快速了解某个算法适用场景和实现框架的学生。指导教师需要快速评估多份赛题思路用智能体做初步方案筛选。如果把智能体当作“输入赛题直接输出完整论文”的工具那方向就错了。当前大模型生成的代码和文字仍然会出现幻觉直接提交会带来很大风险。正确的用法是把它当做一个“带资料检索能力的编程助手”人做最终把关。2.2 能解决什么问题赛题理解阶段输入题目文字智能体输出问题背景、目标函数、约束条件、可选的建模思路。建模选型阶段根据数据规模和问题类型推荐回归、分类、优化、微分方程、图论等具体方法。代码实现阶段生成带注释的Python代码包括数据读取、特征工程、模型训练、结果可视化。论文写作阶段生成“模型建立与求解”章节的大纲以及结果分析部分的初稿。批量处理阶段一次性处理多个问题比如多张数据表的统计描述或多个算法的效果对比。2.3 使用边界与合规提醒这一点必须放在前面数学建模竞赛允许使用编程工具但AI工具是否允许、是否需要申报要以华数杯当年官方通知为准。使用智能体辅助不等于可以代写论文。论文中的核心模型、推导过程和最终结论必须由参赛队员自己理解并负责。同时要注意隐私与版权边界未公开的赛题数据不要上传到不受控的第三方服务。如果赛题有保密要求优先使用本地部署的模型和知识库。知识库中的历年论文如果来源不明不要直接照搬全文只抽取方法描述和结构思路并在论文中正确引用。生成代码如果涉及第三方库注意依赖版本和开源许可。3. 环境准备与前置条件搭建这套智能体依赖一个“平台 知识库 模型服务 本地验证环境”的组合。下面是一份通用检查清单。3.1 智能体平台推荐从成熟平台入手减少运维成本。扣子Coze国内访问方便自带知识库、工作流、插件和市场模型适合快速搭建。Dify开源项目支持本地部署也提供云服务适合有自部署需求的团队。FastGPT偏知识库问答适合做论文检索和赛题问答。如果团队有开发能力也可以完全自建大模型API 向量数据库 Web服务。但考虑到竞赛时间窗口短建议首次使用先从扣子Coze或Dify这类平台起步。3.2 Python本地环境智能体生成的代码最终要落地跑通所以本地必须有一套可运行的Python环境。# 建议使用 Anaconda 创建独立环境 conda create -n math_model python3.10 -y conda activate math_model # 基础数学建模常用库 pip install numpy pandas scipy scikit-learn matplotlib seaborn openpyxl以上命令是通用安装方式实际使用时按团队需要增加库。Jupyter Notebook推荐同时安装因为竞赛期间需要频繁做数据探索和代码调试。3.3 知识库与向量数据库知识库的作用是把“历年华数杯优秀论文、算法模板、团队笔记”这些非结构化资料变成可供大模型检索的依据。关于“企业知识库是存放在向量数据库中的吗”这个问题答案是知识库本身是文档集合但为了支持语义检索文档会被切分成文本块再通过Embedding模型转换成向量存放在向量数据库中。查询时系统把用户问题也转换成向量检索出最相似的一段或几段文本拼进Prompt喂给大模型。常见向量数据库向量数据库特点适用场景Chroma轻量本地文件存储小规模知识库测试QdrantRust实现性能好中大规模知识库Milvus分布式功能全面团队级知识库平台内置知识库免运维快速搭建验证如果是第一次测试直接用智能体平台自带的知识库功能即可不需要单独部署向量数据库。后面知识库大了再迁移到独立向量数据库不迟。3.4 大模型API智能体的核心推理能力来自大模型。两种路线云端API路线使用平台自带模型或接入DeepSeek、通义千问等API。优点是本地无硬件压力缺点是需要网络和API额度。本地部署路线使用Ollama或LM Studio跑Qwen等开源模型。优点是数据不出内网缺点是需要显存和调试时间。竞赛期间建议优先用云端API路线把时间集中在业务逻辑上。4. 智能体架构与知识库设计4.1 整体架构一个数模竞赛辅助智能体的结构通常是四层输入层用户输入赛题文字、数据说明或具体问题。编排层工作流节点负责调用知识库、大模型、代码解释器。存储层向量数据库存放文档切片本地文件系统存放数据和输出结果。输出层返回结构化分析、代码、Markdown论文素材。编排层的核心是一个“先检索后生成”的RAG流程。当用户问“这个优化问题应该用什么算法”时工作流先到知识库检索“优化算法”“TSP问题”“遗传算法”等关键词的语义相似内容再把检索结果拼进Prompt让大模型基于这些内容回答。4.2 知识库内容设计知识库质量直接决定智能体的回答质量。建议建立三个独立知识库第一个是赛题库包含近几年公开的赛题题目、数据说明、解题思路摘要。这部分用来帮助智能体快速理解“这类问题以前是怎么解的”。第二个是算法模板库包含线性回归、逻辑回归、决策树、随机森林、XGBoost、遗传算法、模拟退火、排队论、层次分析法等算法的适用条件、伪代码、注意事项。这是智能体生成代码时最主要的依据。第三个是写作素材库包含论文结构模板、常用句式、图表描述模板、误差分析写法。这部分主要服务论文润色节点。4.3 文档切块示例知识库文档不能整篇塞给模型需要切块。切块太小语义不完整太大检索不够精确。一般以500到1500字为一块比较常见。下面是一个通用切块示例。from langchain.text_splitter import MarkdownHeaderTextSplitter # 通用示例读取Markdown格式的算法文档按标题切块 headers_to_split_on [ (#, H1), (##, H2), (###, H3), ] splitter MarkdownHeaderTextSplitter(headers_to_split_onheaders_to_split_on) with open(algorithm_templates.md, r, encodingutf-8) as f: content f.read() chunks splitter.split_text(content) print(f分块数量: {len(chunks)}) for chunk in chunks[:3]: print(chunk.metadata) print(chunk.page_content[:200])这段代码只是一个片段实际运行时需要安装langchain并且根据文档格式调整分隔符。切块之后每个块会被Embedding成向量再入库。4.4 提示词工程建议智能体的效果很大程度取决于提示词。给“赛题分析节点”和“代码生成节点”使用不同的提示词效果会明显更好。赛题分析节点提示词模板你是数学建模竞赛指导助手。请按以下结构分析用户提供的赛题 1. 问题重述用三句话概括题目要求。 2. 目标分析列出需要优化的核心目标。 3. 约束条件列出题目中的限制条件。 4. 可行方法结合知识库检索结果列举3种可行建模思路并说明适用性。 5. 风险提示指出数据量和计算资源的潜在瓶颈。 回答语言中文。不要直接给出完整代码。代码生成节点提示词模板你是Python算法工程师。根据用户描述的数据格式和建模方法生成完整可运行的Python代码。 要求 - 使用pandas读取数据字段名用占位符表示。 - 包含数据清洗、特征构造、模型训练、结果评估、可视化五个部分。 - 关键步骤添加中文注释。 - 如果数据量较大优先使用适合大规模数据的实现。这样的提示词能让输出更结构化减少“模型自说自话”的情况。5. 搭建与部署工作流配置5.1 在智能体平台上创建一个数模助手以扣子Coze为例通用流程如下登录平台进入“智能体”页面点击创建智能体。填写名称例如“华数杯数模助手”选择基础模型。在人设与提示词中粘贴上一步写好的赛题分析提示词。在知识库模块创建三个知识库赛题库、算法模板库、写作素材库上传处理好的文档。创建工作流开始节点 → 知识库检索节点 → 大模型节点 → 结束节点。工作流中把知识库检索结果作为上下文变量传给大模型节点。保存并预览先在调试窗口输入一条简单问题测试。需要说明的是平台界面和字段名称会不断更新具体以实际页面为准。整个搭建过程的核心思路是每一个工作流节点只做一件事节点之间通过变量传递数据。5.2 工作流节点设计推荐在智能体内建立多个独立工作流而不是把全部逻辑塞进一个流程里。第一个工作流叫“赛题解析”输入赛题文字输出问题重述、目标分析、约束条件和可行方法。第二个工作流叫“代码生成”输入数据格式说明和建模方法输出带注释的Python代码。第三个工作流叫“论文润色”输入论文片段输出结构化的章节初稿和常用句式建议。拆分成三个独立工作流的好处是某一环节出错时不会影响其他环节遇到新赛题时可以单独重新编排其中一步。5.3 知识库检索参数知识库检索节点的关键参数有召回条数一般设置为3到5条。太少可能漏信息太多会撑爆Prompt长度。相似度阈值低于阈值的结果直接丢弃。建议从0.3开始调试根据实际问答效果调整。检索范围可以选择只检索某个知识库也可以跨库检索。竞赛阶段建议分开检索避免论文素材干扰代码生成。6. 功能测试与效果验证智能体搭好后不要急着上赛题先跑一组标准测试用例。下面给出四个测试维度和对应的验证方法。6.1 测试一赛题解析能力输入一条模拟赛题描述例如某快递公司在一个城市有50个配送站点和1个配送中心车辆载重有限每天需要规划配送路线使总行驶距离最小。请给出建模思路。预期结果智能体输出问题重述、优化目标、约束条件并推荐车辆路径问题或TSP相关算法同时指出数据量和求解时间是风险点。判断标准输出的结构是否完整推荐算法是否与赛题匹配。如果智能体只给出一个笼统的“用机器学习”方案说明知识库缺少运筹优化类内容需要补充算法模板。6.2 测试二代码生成与本地运行向智能体提问请用Python读取data.csv字段包括id、x1、x2、y。要求做线性回归并输出R方和特征重要性。把生成的代码复制到本地Jupyter运行。如果代码缺少字段名处理或没有导入pandas需要调整提示词要求“使用占位符表示字段名”并“包含必要的import语句”。这个环节最容易暴露模型幻觉所以代码务必在本地跑通后再进入正式工作流。6.3 测试三知识库命中率在知识库中放入一篇关于“遗传算法求解TSP”的模板然后向智能体提问有100个城市的TSP问题数据量为100×100的距离矩阵应该用什么算法观察智能体是否引用了知识库内容。如果它的回答和知识库模板毫无关系说明检索节点配置有问题优先检查文档是否已经完成向量化、召回条数是否过少。6.4 测试四批量问题处理竞赛期间需要同时处理多个小问题例如多个数据表的统计描述。可以把问题写成一个文本文件逐行读取后调用智能体API批量处理。下面是一个通用Python调用示例import requests import time API_URL https://api.example.com/v1/chat # 以实际平台接口为准 API_KEY 替换为你的访问令牌 def ask_assistant(question): headers { Authorization: fBearer {API_KEY}, Content-Type: application/json } payload { model: 你的模型名, messages: [ {role: user, content: question} ] } resp requests.post(API_URL, jsonpayload, headersheaders, timeout120) return resp.json() questions [ 对data1.csv做描述性统计输出均值、中位数、标准差, 对data2.csv检查缺失值并给出处理方案, 比较data3中A和B两个分组的均值差异 ] for q in questions: result ask_assistant(q) print(result.get(choices, [{}])[0].get(message, {}).get(content, result)) time.sleep(2)这段代码是通用模板字段名和URL必须根据实际平台替换。批量任务的核心是增加间隔和重试机制避免触发限流。7. 接口API与批量任务7.1 发布为API服务智能体在平台上完成测试后需要发布为API服务才能被外部脚本调用。发布后通常获得一个HTTP接口地址、访问令牌和工作流ID或智能体ID。调用方式一般有两种对话接口发送用户问题返回大模型回答。适合在线问答和论文草稿生成。工作流接口指定工作流ID传入工作流参数返回节点输出。适合批量执行固定流程。竞赛团队建议优先使用工作流接口因为赛题解析、代码生成、论文润色是三条固定流程直接用工作流接口更稳定。7.2 批量任务设计批量任务适合以下场景对多个数据表执行相同的数据探索。对多篇参考资料做摘要提取。对论文的多个章节分别生成润色建议。在脚本层面可以做一个简单的队列和重试设计。import time import requests TASK_QUEUE [ task1_description, task2_description, task3_description, ] def call_api(task): # 伪代码实际替换为平台接口 resp requests.post(API_URL, json{task: task}, timeout120) if resp.status_code 429: raise RuntimeError(rate limit) return resp.json() for task in TASK_QUEUE: retry 0 while retry 3: try: output call_api(task) print(task, OK, output) break except Exception as e: retry 1 print(task, retry, retry, str(e)) time.sleep(10) time.sleep(3)批量任务务必记录每个任务的输入与输出建议统一保存为JSON文件方便赛后复盘和审计。7.3 输出格式约定为了让批量结果能被下一个环节消费建议在提示词中要求智能体输出JSON格式。请以JSON格式返回结果包含字段 { summary: 简短结论, code: 生成的代码, risk: 潜在风险 }然后脚本解析JSON自动写入文件。import json def save_result(task, raw_output): parsed json.loads(raw_output) with open(fresult_{task}.json, w, encodingutf-8) as f: json.dump(parsed, f, ensure_asciiFalse, indent2)这样可以避免在大量自由文本中人工查找关键信息。8. 资源占用与性能观察8.1 云端API路线使用云端智能体平台时本地资源占用非常低主要消耗的是网络带宽和API请求额度。观察重点三个方面单次请求延迟普通问答通常在几秒到十几秒如果超过60秒需要检查Prompt是否过长或模型是否负载过高。API限流批量任务最容易触发限流。建议在脚本中加入指数退避重试。成本控制每天记录调用次数和Token消耗设置预算上限避免竞赛期间额度用完。8.2 本地部署路线如果赛题数据有保密要求可以选择本地部署大模型。此时需要关注显存占用。不同参数量的模型显存需求差异很大没有一个固定值必须以实际模型和量化方式为准。降低显存占用的通用手段使用量化版本模型例如4-bit量化。降低最大生成长度。显存不足时让Embedding模型走CPU只把大模型放GPU。使用Ollama等框架自动管理模型加载和释放。8.3 知识库检索性能知识库文档数量不大时检索时间基本可忽略。但当文档数量上万时要关注向量数据库的查询延迟。常见优化方式控制单个文档切块的大小。按知识库主题分库缩小单次检索范围。如果检索结果不准确优先增加召回条数而不是扩大检索范围。9. 常见问题与排查方法下面是搭建和运行过程中最高频的问题按现象、原因、排查方式、解决方案拆开。问题现象可能原因排查方式解决方案知识库检索不到内容文档未完成向量化或切块失败查看知识库文档状态重新上传并确认Embedding成功智能体回答和知识库无关检索召回条数过少或阈值过高在调试窗口查看检索结果增加召回条数降低相似度阈值生成的代码运行报错大模型幻觉缺少import或字段名本地运行看具体报错调整提示词要求先解释算法再写代码批量任务大面积超时单次请求文本过长查看日志中的请求时长拆分子任务限制输入长度API返回限流错误请求频率超过平台限制检查响应状态码增加sleep间隔并加入重试上传PDF后知识库乱码扫描版PDF无法直接读取打开PDF查看文字层先用OCR转换为文本再入库智能体输出内容空洞提示词约束不足检查提示词是否要求结构化输出使用分点、JSON、公式等格式约束论文素材风格不统一写作素材库样本过少检查知识库内容覆盖度补充优秀论文结构模板排查顺序通常是先看输入是否正确再看知识库是否命中最后看大模型输出。不要一上来怀疑模型能力大部分问题都出在前面环节。10. 最佳实践与合规提醒10.1 工程化使用建议第一先跑通最小闭环。不要一开始就把全套工作流搭完先用一个知识库加一个赛题解析节点输入一条赛题确认输出可用后再加代码生成节点。第二保留一套最小可运行配置。竞赛期间很容易改坏工作流建议把稳定版本的提示词、知识库、工作流快照保存好出了问题可以回滚。第三目录管理要规范。所有模型输入、生成的代码、输出结果按日期分类存放。math_model_team/ ├── knowledge_base/ # 知识库原始文档 ├── data/ # 赛题数据 ├── scripts/ # 本地验证脚本 ├── output/ # 智能体生成的代码和结果 │ ├── 20250420/ │ └── 20250421/ └── prompts/ # 提示词备份第四为智能体的每次生成结果做记录。输出文件命名时带上任务ID、时间和模型名方便赛后复现。10.2 竞赛合规与学术诚信使用AI智能体辅助数学建模竞赛最终提交的论文和代码必须由团队自己负责。建议遵守以下原则以华数杯官方规则为准确认AI工具是否允许使用、是否需要声明。不要把未公开的赛题数据上传到无法控制的外部平台。知识库中的历年论文只用作方法参考不复制原文。比赛结束后如果需要公开代码和论文要隐去敏感数据并检查版权。遇到“直接生成整篇论文”的诉求时智能体不应该被配置成这样工作人必须参与核心建模和写作。10.3 提升生成质量的小技巧给智能体提供数据样例前几行它生成的代码更容易匹配真实字段。生成代码后立即本地运行把报错信息回传给智能体让它修复。对回复内容敏感的任务要求智能体标注信息来源。如果感觉回答质量下降先检查Prompt长度是不是被检索内容撑爆再检查模型是否选错。11. 总结与下一步这套“华数杯AI智能体”最有价值的点是把知识库检索、大模型生成和批量任务编排成了一条可以复用的工作流。它不解决所有问题但能把竞赛中查资料、写代码、整理论文素材这几个环节的重复劳动降下来。建议第一步先验证两个核心能力赛题解析和Python代码生成。把这两个节点调通后再加入论文润色和批量任务。最容易踩的坑有三个知识库质量差导致检索不准、提示词没有结构导致输出发散、批量任务触发限流导致脚本卡死。这三个问题都在本文前面给出了对应的排查方式。下一步可以考虑把工作流扩展到其他团队场景比如把知识库替换成课程资料变成学习助手或者把代码生成节点接到自动执行环境让智能体不仅能写代码还能直接运行代码。基础架构是一样的换一层业务数据就能复用。建议收藏备用比赛前一周搭好赛题发布当天就能直接用。