🛠️ 工具 / 平台控制台手册 · 与「用户手册」配套

投标智能体平台 工具与控制台手册

本手册面向平台 / 企业管理员与运营人员，说明投标智能体平台的控制台（bidding-tool 服务提供的 Web 管理界面）如何操作，以及平台内置的 AI 工具集（TOOL）分别是做什么的。日常投标操作（招标解析、评分匹配、标书生成、去重检测、智能助手）请阅读配套的《用户手册》。

适用：控制台 / 平台后台 配套：📖 用户手册（业务操作） 整理时间：2026-09
📁
项目管理
投标项目建档
📦
知识库管理
导入 / 列表 / 预警
🏢
知识主体
公司 / 人员
🔍
检索管理
多维度检索 / 映射
📚
历史档案
去重底库 · 知识提取
🧰
系统工具
平台运维调试
🤖
Prompt 管理
提示词配置
⚙️
AI 工具说明
TOOL 能力清单

1 · 控制台是什么

平台采用「React 业务台 + 控制台」双界面：

入口承担功能文档
投标业务台（React）招标解析、评分匹配、方案编写、标书生成、去重检测、智能助手「小昭」等面向业务人员的操作。《用户手册》
控制台（bidding-tool）项目建档、企业知识库（材料导入 / 管理 / 过期预警）、知识主体（公司 / 人员）、检索管理、历史档案（去重底库 + LLM 知识提取审核）、系统工具 / Prompt 管理 / 系统管理，并为智能助手提供底层 AI 工具服务。本手册

控制台的核心价值是把“投标弹药库”管理好：通过知识导入 / 档案导入把资质证书、人员证书、项目业绩沉淀成结构化知识库，供业务台的评分匹配、方案编写、标书生成自动引用；把历史投标文档导入去重底库，供去重检测比对。

🔗
数据同源：业务台与控制台读写的是同一套项目 / 知识库 / 档案数据。例如在业务台「标书生成 → 知识库材料搜索」能找到的资质、业绩，就是在控制台导入并审核通过的材料。

2 · 角色 · 菜单 · 权限

控制台左侧菜单由后端按登录用户角色动态下发（登录后按 token 从菜单字典渲染），不需要也不能手工固定。菜单分两种可见范围：

范围说明包含菜单
通用各租户（含企业自身）都能看到、使用的业务菜单。项目管理 / 知识库管理 / 知识主体 / 检索管理 / 历史档案 / 系统管理（用户·角色·权限）
平台仅平台租户（平台管理员）可见，面向运维与运营。系统工具 / 系统管理中的 菜单管理 · 投标主体 · 企业认证 / Prompt 管理 / JavaPrompt
  • 内置角色：ADMIN 管理员、BID_USER 投标业务用户、MANAGER（可自定义）。内置角色不可删除 / 改名。
  • 菜单权限与数据权限分开管理：角色的“可见菜单”写入菜单授权（t_sys_role_menu）；“数据权限”按权限点授权（需 permission:grant）。
  • 对象级管控：项目管理中，“项目成员”由项目经理管理；编辑 / 删除项目需管理员或该项目经理。
💡
看不到某菜单？说明你的角色未被授权该菜单，或该菜单为“平台”范围。请联系租户管理员通过「角色管理 → 菜单权限」分配，而不是手动改前端。

3 · 项目管理

控制台 项目管理 → 项目信息：把每次投标作为一个“项目”建档，用于归集该项目关联的历史标书、知识材料与成员，并与业务台的“关联项目”打通。

  1. 查看项目列表
    表格列：项目名称、编号、类型、项目经理、投标日期、材料数、状态（正常 / 停用）。可按名称 / 编号搜索、按类型筛选（市政工程 / 建筑工程 / 信息化项目 / 政府采购 / 企业采购 / 水利 / 交通 / 能源 / 环保 / 其他）。
  2. 新增 / 编辑项目
    点 + 新增项目：填写项目名称（必填）、项目编号（选填，留空自动生成）、项目类型、项目经理（从系统用户下拉选择）、投标日期与备注。
  3. 查看详情与关联材料
    行内 详情 查看项目信息及“关联材料 (N)”，可从材料列表跳转材料详情。
  4. 成员管理
    行内 成员 进入项目成员页，为项目分配可参与的成员（权限要求：管理员或项目经理）。
⚠️
删除项目前请确认其关联的档案 / 材料归属；项目停用后相关业务台下拉中不再默认出现。

4 · 知识库管理

企业投标材料（资质证书、人员证书、项目业绩、财务报表等）统一在此沉淀。菜单：知识库管理 → 知识导入 / 知识列表 / 过期预警。

4.1 知识导入

页面上方 4 张统计卡（可用 / 处理中 / 扫描件 / 失败，约每 5 秒自动刷新），下方为上传区。

  1. 选择材料文件
    点击或拖拽文件上传，支持 PDF · Word · Excel · JPG · PNG · TXT 等；一次最多 3 个文件、总大小 ≤ 100MB。扫描件 PDF 会保存原件并按图片处理。
  2. 等待后台处理
    提交后进入后台流水线（knowledge_importer）：自动分类 → 打标签 → 提取正文 / OCR → 多模态向量化建索引 → 进入审核。期间文件状态依次为 扫描件(scanned) → 处理中(processing) → 可用(active)，失败会显示原因。
  3. 审核上架
    自动入库的材料仍需人工审核通过后才对业务台开放引用：在「知识列表」按状态“待审核”筛选 → 审核 进入审核页通过或驳回。
🎯
材料类型：系统按类型组织材料，包括 资质证书 / 知识产权 / 人员证书 / 人员简历 / 项目经验 / 财务报表 / 技术方案 / 需求文档 / 公司信息 —— 与业务台「知识库材料搜索」的类型筛选一一对应。

4.2 知识列表

浏览 / 筛选 / 管理已导入材料，可按 类型、状态、审核、来源（手动上传档案提取数据迁移）筛选；默认隐藏“离职人员材料”（可勾选“含离职人员材料”查看）。列表展示 材料名称（含原文件名与大小）、类型、标签、持有人（离职人员带灰标）、来源、版本状态、审核状态与时间。

  • 预览：新窗口查看原件；审核：对待审核材料通过 / 驳回；删除：移除该材料（二次确认）。
  • 版本管理 / 下载在材料详情页进行：可查看历史版本、上传新版本替换（replace）、回滚。
  • 材料详情还可追溯来源：若材料来自档案 LLM 提取，可反向查看来源档案、提取类型、置信度与原文片段。

4.3 过期预警

监控证书 / 资质有效期，到期前自动提醒。统计卡：已过期 / 30 天内到期 / 90 天内到期；可按 级别与类型（资质证书 / 人员证书 / 知识产权 / 公司信息）筛选。列表列：材料名称、类型、持有人、到期日、剩余（已过期或“剩余 N 天”）、级别、操作（标记处理 / 忽略），已处理项带“已处理”标记。

📅
建议习惯：每周查看一次“90 天内到期”，提前安排资质续期或补充，避免评标时证书过期失分。

5 · 知识主体（公司 / 人员）

菜单 知识主体 → 公司信息 / 人员信息：材料要有“归属”，即把证书 / 业绩挂到公司主体或人员主体（持证人 / 项目负责人）上，评分匹配与标书引用才能按主体对号入座。

5.1 公司信息

  • 列表可按公司名称 / 信用代码搜索；表格列：公司名称、信用代码、地址、法人、状态（正常 / 停用）。
  • 操作：详情（含“关联材料 (N)”）、编辑、合并、删除。
  • 公司合并：同名 / 关联公司整理时，把源公司并入目标公司，其关联材料全部转移到目标；可勾选“信息补全”把源公司的空缺字段（信用代码 / 地址 / 法人）填充到目标。⚠️ 合并不可撤销。

5.2 人员信息

  • 字段：姓名（必填）、身份证号、部门、职位、电话、邮箱；状态：在职 / 离职。可按姓名 / 身份证搜索、按部门或状态筛选。
  • 操作：详情 / 编辑 / 合并 / 离职（在职时显示）/ 复职（离职时显示）/ 删除。离职操作会提示“离职后其关联材料默认不在标书 / 搜索中出现”。
  • 人员合并支持“信息补全 + 同步快照”：把源人员关联材料的持有人姓名 / 身份证一并改写为目标人员，避免合并后材料仍是旧持有人。
  • 人员证书挂接：人员证书以“关联材料”形式挂到人员主体上——导入人员证书时把持有人（姓名 / 身份证）填对，系统会通过 sync_person 自动匹配 / 新建人员并回填。
⚠️
离职人员处理：人员离职后系统默认把其材料从搜索 / 标书引用中隐藏，避免误用。确有需要可在知识列表勾选“含离职人员材料”查看，或由管理员复职。

6 · 检索管理

6.1 多维度检索

菜单 检索管理 → 多维度检索：面向知识库的检索工具，输入关键词（如“工程资质”“建造师证”“市政项目”“近3年业绩”）。结果页会先显示命中检索映射规则，再按打分排序返回材料：标题可点进材料详情，右侧展示类型与原始文件名。

  • 打分逻辑：向量语义命中权重最高（×10），标题命中 +5，标签命中 +3，综合排序。
  • 支持类型：资质证书 / 知识产权 / 人员证书 / 人员简历 / 项目经验 / 财务报表 / 技术方案 / 需求文档 / 公司信息 / 其他。
  • 精准度优化：搜不准时，把“招标文件里的说法”映射成“你知识库里的标签”，见下方「检索优化」。

6.2 检索优化（关键词映射）

菜单 检索管理 → 检索映射：把常用检索词映射到标签 / 类型，提升命中率。

  1. 新建映射规则
    点 + 新建映射规则：填写关键词（逗号分隔多个别名，如“工程资质,建筑资质”）、目标标签（逗号分隔，如“建筑业企业资质,施工总承包”）、目标类型（可选）与优先级。
  2. 测试效果
    在“🔍 测试搜索”输入关键词点 测试，观察命中的规则与返回材料，不满意再调整。
  3. 维护规则
    规则列表支持编辑 / 删除，改后即生效，业务台搜索同步受益。

7 · 历史档案与去重底库

菜单 历史档案：把历史投标标书批量入库，构建去重比对底库，同时从中用 LLM 精准提取证书 / 业绩等知识。这是“去重检测”与“知识库材料”的历史来源之一。

7.1 档案导入

  1. 填写档案信息
    选择关联项目（可选）、投标日期；项目类型自动带出。
  2. 批量选择标书文件
    支持 Word(.docx) / PDF，可多选，单文件 ≤ 100MB。
  3. 选择知识提取范围
    默认勾选“🤖 同时提取到知识库”：用 LLM 从标书里提取 资质证书 / 人员证书 / 项目经验 / 公司信息（财务报表默认不勾选）。提取结果先进审核队列，不会直接上架。
  4. 开始导入
    点 ⬆ 开始导入，任务后台异步执行（离开页面不中断），页面通过流实时展示“正在处理: 文件名 — 阶段”；结束给出 总计 / 成功 / 失败 / 知识提取 汇总。

流水线：文档解析 → 去重入库（企业内部历史库）→ 正文较长的文件再旁路做 LLM 知识提取，生成候选材料与来源关联。页面会记住最近任务，刷新后可一键恢复进度。

7.2 档案列表

管理已导入的去重历史文档。列：文件名、类型、项目名称、段落数、状态（parsed / completed / failed 原文徽标）、导入时间、知识提取（显示“📚 N 条, X 条待审核”，点进去即知识审核页）、操作（删除，确认后连同向量一并移除）。

7.3 知识审核（档案提取结果）

LLM 从档案里提取出的材料在此第一道把关，确认可信后再进知识库。可按 来源档案、类型、最低置信度（全部 / ≥0.8 高 / ≥0.6 中）筛选；每行展示提取信息（标题、编号、颁发、有效期、持证人、身份证、项目、金额、姓名及原文）、类型、置信度百分比。支持：

  • 通过 / 拒绝 单条处理；✅ 批量通过 / ❌ 批量拒绝 批量处理。
  • 🚀 全部信任高置信度：对某档案自动通过所有置信度 ≥ 0.8 的提取项（人工抽查低置信度项即可）。
🔁
两道审核：档案提取项“通过”后进入知识库的待审核队列；最终能否被业务台引用，还需在「知识列表」的材料审核中通过上架。两道把关确保自动提取的内容可溯源、可追责。

7.4 去重配置

配置文档解析与风险判定规则，改动影响去重检测的比对与展示：

配置组关键项与默认值作用
封面识别封面关键词、检测字符数（默认 800）、最小命中数（默认 3）识别并跳过标书封面，避免干扰比对。
目录识别目录正则识别目录区。
模板套话过滤套话正则过滤“通用套话”，不计入重复判定。
章节标题识别章节正则、最大标题长度（默认 100）切分章节，用于章节级重复率展示。
风险等级定义风险阈值 low 20% / medium 30% / high 50%，等级名称与处理建议重复率 → 低 / 中 / 高 / 严重 分档。
比对默认值相似度阈值（默认 0.85）判定“命中重复”的内容相似度门槛。
分段参数分段大小 500 字符、重叠 50 字符比对粒度控制。
⚙️
谨慎修改：这些是全局判定规则。改动后需点 保存全部 生效，任何时刻可 恢复默认。默认值已适配大多数场景，非必要不建议调整。

8 · 系统工具

菜单 系统工具（平台范围，仅平台管理员）：面向知识库运维与问题排查的工具集。建议由熟悉向量库（Qdrant）与 MRAG 数据结构的运维 / 开发人员使用。

菜单用途主要操作
📚 知识库文件向知识库补充原始文件（不经业务页，供解析建索引）。从 S3/OSS 链接 批量添加、本地上传（PDF / docx / txt / xls / ppt 及图片）、网页 URL 三种方式入库；文件列表状态 成功 / 等待 / 处理中 / 失败；支持单条 / 批量删除（二次确认）。
🔎 知识库浏览直接查询 Qdrant 向量库里的文档片段，排查索引是否异常。选集合（text 文本 / image 图片 / page 页面 / dedup 投标档案）与知识库，关键词搜索或浏览全部，查看每向量的 相似度 / 文件名 / chunk 类型 / 文本与元数据；可删除单个向量点（不可恢复）。
🔍 知识库查询测试整条 RAG 检索 + 生成链路（平台调试用）。输入问题 → 🚀 检索（可勾选流式输出），展示回答与检索到的 text/page/image 片段及分数、首 Token 延迟 / 总耗时 / Token 数；历史可重新查询。
📚 知识库管理管理“知识库”这个顶层容器。切换知识库、✏️ 改名、🗑 删除（双重确认，会同时删除该库全部向量与文件记录）；下方文件列表可批量删除文件。
🗄 MySQL 查询浏览 / 修复 MRAG 元数据表。只开放 t_kb / t_kb_file / t_kb_doc 三张表，可看 schema、行数，支持编辑 / 删除行用于数据修复；查询列名走白名单、值参数化绑定，拒绝拼接注入。
☢️
高危操作集中区：“知识库浏览”的删除向量点、“知识库管理”的删除知识库、“MySQL 查询”的删除行都属于不可恢复操作，请先在测试环境验证，再对生产数据操作。

9 · Prompt 管理

平台把 AI 提示词统一收敛到控制台管理，让 prompt 修改不依赖发版。分两套配置界面：

9.1 Prompt 管理（Python 侧各模块）

菜单 系统工具 → Prompt管理：管理投标各环节的提示词模板，按业务分组（知识库 / 档案知识提取 / 招标解析 / 去重检测 / 数据分析 / 代码解释器 / 深度搜索 / NL2SQL / Plan SOP / 报告生成 / Table RAG）。

  • DB 优先，修改即生效：每个模板 Key 显示描述与内容预览，编辑 可改正文（支持 {{变量名}} 模板语法），保存后 Python 侧立即使用，无需重启。
  • 回退与批量：单条 重置 = 删除 DB 记录、回退到内置 YAML；工具栏 📥 同步全部yaml / 🔄 恢复全部默认 / 💾 保存全部修改 用于批量管理。

9.2 JavaPrompt（Java Agent 提示词）

菜单 系统工具 → JavaPrompt：管理 Java 侧多 Agent 引擎（计划 Agent / 执行 Agent / React Agent / 任务 / 工具 / 全局 Prompt / 总结）的提示词，同样 DB 优先。

  • 生效时机：JavaPrompt 修改后需重启 Java 服务或触发热加载才生效（与 Python 侧“即改即生效”不同）。
  • 重置语义：内置 YAML 中存在的键 → 重置为 YAML 默认值；不在 YAML 中的自定义键 → 物理删除。给工具新增的临时提示词请确认是否要保留。
💡
最佳实践：先在“内容预览 / 测试”确认效果再批量应用；生产环境建议通过「同步全部yaml + 保存全部修改」走变更，保留 YAML 作为默认基线。

10 · 系统管理

菜单 系统管理：租户内部的用户 / 角色 / 权限由各租户管理员维护；菜单管理 / 投标主体 / 企业认证为平台级（平台管理员）。

10.1 用户管理

  • 列表：用户名、姓名、角色（管理员 / 普通 徽标）、状态（正常 / 停用）、创建时间；内置 admin 显示 🔒 且不可编辑 / 删除。
  • 新增用户：用户名（失焦即校验唯一）、姓名、密码（≥ 6 位）；“设为管理员(ADMIN)”仅创建时可指定。
  • 行操作：编辑（用户名只读）、删除、修改密码（≥6 位）、分配角色（需管理员或有分配角色权限）。用户亦可自助“修改本人密码”。

10.2 角色管理

  • 角色 CRUD：角色名称 + 角色编码（保存时自动大写）；内置 ADMIN / BID_USER / MANAGER 禁止创建 / 改名。
  • 行操作 菜单权限：给角色分配可见菜单（即左侧菜单来源）；数据权限：授权具体权限点（需 permission:grant）。

10.3 权限管理

权限点字典，按“模块:操作”编码（如 material:view）分组维护；支持新增，主要用于角色数据权限的授权粒度。

10.4 菜单管理（平台）

动态菜单字典：分组 / 菜单项的增删改、排序（▲▼）、范围（通用 / 平台）与启停。菜单项可指定“页面路径”，即静态页面地址。删除分组会连带删除子项。

10.5 投标主体（租户管理，平台）

SAAS 多租户管理：每个租户编码即一个“投标主体”。创建租户时指定 租户名称、租户编码（创建后不可修改，登录时需填写）、管理员账号 / 密码（≥6 位）/ 姓名、联系人。可对租户停用 / 启用；行内可进入该租户的“用户管理”，由平台代指定租户补建用户。平台租户（ID=1）为系统平台自身。

10.6 企业认证审核（平台）

个人租户在业务台提交“企业认证”（公司信息 + 营业执照）后，在此审核：查看公司名称 / 统一信用代码 / 法人 / 申请人 / 联系电话 / 所属租户 / 营业执照原件（图片或 PDF 可放大）→ 填审核意见（驳回必填）→ ✕ 驳回 或 ✓ 通过并升级公司。通过后该租户由个人升级为公司，申请人升级为管理员，从而具备成员管理能力。

🧾
操作日志：用户、角色、材料、项目等关键变更均写入操作日志（含操作模块、动作、来源 IP、成功与否等），目前仅开放后端审计接口查询、尚未提供前端页面；如需界面展示可联系平台。

11 · TOOL：AI 工具说明

智能助手「小昭」之所以能“做事”，靠的是平台内置的一批 AI 工具（TOOL）。对话时右侧“任务时间线”里看到的“正在搜索 / 正在调用知识库 / 数据分析 / 生成文件”等动作，就是工具在被调用。这些工具由 bidding-tool 提供底层执行能力（多为 SSE 流式），以下逐一说明用途，方便您理解 AI 每一步在做什么、能做什么：

工具服务接口作用与典型用法触发场景
🐍 代码解释器
code_interpreter		 /code_interpreter 在隔离沙箱中执行 Python 代码：读入你上传的附件、做数据处理 / 统计分析、生成图表与结果文件（可下载）。典型提问：“用 Python 分析这份附件并按月份画图”。 数据分析类提问、附件处理
🌐 深度搜索
deepsearch		 /deepsearch 多搜索引擎并行联网检索，逐页阅读后推理综合，产出带来源的调研结论。典型提问：“竞品公司最近中标了哪些项目”“XX 行业最新政策”。 行业调研、信息求证
📄 报告生成
report		 /report 把分析结果排版成结构化报告（HTML / Markdown 等），供阅读、复制或落地为文档。 网页模式、文档模式输出
📊 数据分析
auto_analysis		 /auto_analysis 对查询 / 上传的数据计算指标，确定维度、指标、筛选与公式，并生成图表配置 —— 即经营分析结果里图表与“分析参数”的来源。 经营分析图表、指标卡
🗄 NL2SQL 查询
nl2sql		 /nl2sql 把自然语言问题转成 SQL 去企业数据库执行，返回数据行用于分析；结合表结构召回选择正确的库表。 经营分析“自然语言查库”
🧮 计算引擎
cal_engine		 /cal_engine 对已有数据做指定口径的指标计算（聚合 / 对比 / 环比等），支撑“算一下”“对比一下”类追问。 数据追问与二次计算
📋 表格召回
table_rag		 /table_rag 对“表结构 / 表格型知识”做向量召回与问答，让 AI 知道企业库有哪些表、每列什么含义，是 NL2SQL 选表的前置能力。 经营分析选库表
🗺 SOP 规划
plan_sop / sopRecall		 /sopRecall 匹配历史“标准作业流程”（SOP），把复杂任务拆成多步计划再执行 —— 即 Plan + Execute 模式下任务拆解的来源。 复杂任务规划、多 Agent 编排
🧠 多模态检索
mragQuery		 /mragQuery 文本 + 图片 + 页面多模态 RAG 检索问答：给定问题先在向量库召回相关片段（带分数与来源），再让 LLM 依据片段作答。知识库问答、评分匹配“查材料”都基于它。 知识库问答、材料匹配、RAG 引用
📦 知识导入引擎
knowledge_importer		 后台流水线 导入文档后自动分类、OCR、打标签、多模态向量化建索引，把“文件”变成可检索的“知识”。业务台所见材料即由此产生。 知识导入、档案导入后台
🔗
与业务界面的对应：“经营分析”= NL2SQL + 数据分析 + 计算引擎；网页 / 文档模式 = 报告生成；知识库问答与评分匹配 = 多模态检索（带引用）；深度思考的拆解 = SOP 规划。您在对话时间线看到工具名，就是本清单中的一项。

12 · 注意事项

  • 菜单是动态的：看不到模块先检查角色“菜单权限”；改菜单应通过「菜单管理」，不要改前端代码。
  • 删除多为不可恢复：档案删除会移除向量，知识库删除、向量点删除、合并操作均不可撤销，操作前请二次确认。
  • 文件规格：知识导入一次 ≤ 3 个文件、总 ≤ 100MB；档案导入单文件 ≤ 100MB；超限请拆分。
  • 自动提取需人工把关：档案 LLM 提取与自动导入的材料都要“两道审核”后才被业务台引用，低置信度项务必人工抽查。
  • Prompt 生效差异：Prompt 管理（Python 模块）即改即生效；JavaPrompt 修改需重启 / 热加载 Java 服务。
  • 离职人员材料默认隐藏：需要时在知识列表勾选“含离职人员材料”查看。
  • 生产安全：系统工具与“MySQL 查询”仅限平台管理员在受控环境使用，误操作会影响线上知识库检索与去重结果。

本文档基于 2026-09 版本整理，界面文案以线上实际为准。业务操作请配合阅读《用户手册》。如有疑问请联系朝云数据支持团队。