1. 今日概况
今天主要围绕智能体管理平台的代码结构理解、知识库模块开发和开发工具部署三部分展开。上午,我重点阅读并梳理了项目源码,进一步明确了前后端架构、当前开发进度以及自己后续需要负责的模块。下午和晚上,我与同事一起推进知识库模块的 MVP 链路开发,并完成了 Redis 集群、MySQL 数据库等资源配置接入;此外,还在隔离 VDI 环境中完成了 Claude Code 的本地部署,并向同事介绍了部署方法。
2. 今日完成工作
2.1 项目源码与架构理解
上午,我深入阅读了当前项目的源码,对项目整体结构、前后端实现方式以及现有代码组织有了更清晰的认识。通过代码梳理,我了解到当前项目仍处于从 0 到 1 搭建阶段,前端已经有一个初步 Demo,但后端功能还没有完全建设起来。
目前平台前端主要采用 Vue 相关的 Web 前端结构进行开发,已有页面更偏向展示和原型验证,部分数据和交互逻辑仍然是前端写死的形式。后续需要逐步补充后端服务能力,使平台从原型页面过渡到真正可用的智能体管理平台。
通过上午的代码阅读,我进一步明确了当前整体开发进度,也对自己接下来需要参与的模块和任务有了更加充分的了解。
2.2 明确平台从 0 到 1 的建设状态
今天我进一步认识到,当前项目并不是在一个已经完善的系统上做简单功能补充,而是在建设一个从 0 到 1 的智能体管理平台。前两天我已经理解到项目目标是做一个 Agent 基座或智能体装配工厂,今天通过源码和开发进度梳理,我更加明确了这个平台目前仍处在基础能力搭建阶段。
目前的重点不是直接完成一个成熟 Agent,而是先搭建平台底座,包括前端管理页面、后端服务能力、资源配置、知识库模块以及后续 Agent 装配所需的基础结构。这也让我对后续工作的优先级有了更清楚的判断:需要先把基础链路跑通,再逐步完善 Agent 能力。
2.3 知识库模块需求讨论
下午,我和同事一起讨论了业务方提出的新需求:在智能体管理平台中增加知识库模块,用于后续增强 Agent 的回答和业务理解能力。虽然当前智能体工厂还没有形成一个完整可用的 Agent,但业务方希望先把知识库插件能力建设起来,为后续 Agent 接入和增强做准备。
这一需求说明,知识库模块并不是一个孤立功能,而是未来 Agent 能力的重要支撑。后续智能体在处理业务问题时,可以基于知识库进行信息检索和上下文增强,从而减少纯模型回答的不确定性,提高回答依据和业务适配性。
2.4 资源申请与项目配置接入
在开发知识库模块过程中,涉及服务器连接、资源申请和权限访问等问题。下午我们对服务器进行了连接尝试,并向上级部门申请了项目所需的相关资源。
本次明确接入的资源主要包括:
- Redis 集群;
- MySQL 数据库。
申请完成后,我们将相关资源配置到项目中,为后续知识库模块的数据存储、状态管理和服务调用提供基础支撑。这个过程也让我进一步理解到,实际企业项目开发不仅包括代码实现,还涉及资源权限、环境配置和跨部门资源协调。
2.5 知识库 MVP 链路开发
下午和晚上,我与同事一起推进了知识库模块的 MVP 版本开发。当前目标是先实现一个最小可用链路,保证知识库最核心的流程能够跑通,再逐步补全查询和增强能力。
今天已推进的核心链路包括:
- 新建知识块;
- 将知识语料写入项目流程;
- 对知识语料进行切片处理;
- 对切片后的内容进行 embedding;
- 将处理后的语料上传到 Milvus/向量检索侧;
- 通过项目路由完成知识写入相关流程;
- 使用 API 调试工具对查询接口进行初步尝试。
目前知识入库相关流程已经基本完成,但知识库查询功能还没有正式开发完成。查询部分今天主要通过 API 调试工具进行尝试,后续还需要在项目中补全正式查询接口和前后端联动逻辑。
2.6 Claude Code 离线环境部署
除了知识库模块开发外,我今天还完成了领导安排的一个额外任务:在本地隔离 VDI 虚拟机环境中部署 Claude Code,并将部署方法介绍给其他同事。
这个任务的难点在于公司内部环境对外网访问存在限制,不能像普通个人电脑一样直接连接外部官网或完成完整在线登录。因此,我没有采用 Cloudflare Tunnel 等外部穿透方式,而是通过修改 Claude Code 的配置文件来解决部署问题。
具体来说,我在 cloudcode.json 配置文件中加入了跳过登录相关配置,使 Claude Code 能够在不连接 Claude 官方 API 或官网登录流程的情况下,在离线或受限网络环境中完成部署。同时,结合 Claude Code Switch 的方式以及跳过登录设置,最终在隔离 VDI 虚拟机上成功完成部署,并配置为调用 DeepSeek 相关模型能力。
完成部署后,我也向同事说明了整体部署思路和关键配置方法,为后续其他同事在相同环境下使用该工具提供了参考。
3. 业务背景理解
3.1 平台定位
当前项目的定位是建设一个智能体管理平台,也可以理解为一个面向业务 Agent 的基础管理平台或装配工厂。它不是单一的智能问答工具,而是要为后续不同业务场景下的 Agent 创建、配置、管理和增强提供统一底座。
今天通过代码阅读和需求讨论,我进一步认识到,平台当前仍处于基础建设阶段,需要先完成前后端架构、后端能力、知识库插件和资源接入等底层能力,后续才能支撑更加完整的 Agent 装配与业务应用。
3.2 当前开发进度
目前平台已有前端 Demo,但后端服务能力还没有完全搭建。前端页面可以表达平台大致形态,但要真正支持智能体管理、知识库接入和 Agent 能力增强,还需要进一步补充后端接口、数据存储、知识处理和查询能力。
因此,当前阶段的开发重点是从“可展示 Demo”向“可运行 MVP”推进。知识库模块就是其中一个重要切入点,它可以先作为平台中的插件能力被建设出来,后续再与 Agent 创建和调用流程结合。
3.3 知识库模块价值
知识库模块的建设是为了增强 Agent 的业务理解和回答依据。对于企业内部场景来说,Agent 不能只依赖模型本身的通用能力,还需要结合企业内部文档、业务规则、操作说明和系统知识。
通过知识库模块,后续 Agent 可以在回答问题或执行任务前先检索相关语料,再结合检索结果生成更可靠的响应。这对于后续智能体管理平台的可用性和业务可信度都非常重要。
4. 技术方案理解
4.1 前后端架构理解
今天通过源码阅读,我对项目前后端架构有了初步理解。前端目前主要承担页面展示、用户交互和基础流程入口的作用;后端则需要逐步补充业务逻辑、数据处理、资源访问和知识库相关能力。
目前由于后端能力尚未完全搭建,前端 Demo 中仍存在写死数据和原型化逻辑。后续需要通过后端接口将智能体管理、知识库管理、知识入库、知识查询等能力真正串联起来。
4.2 知识库入库流程
今天开发的知识库 MVP 主要围绕知识入库链路展开。整体流程可以理解为:用户或系统创建知识块后,项目路由接收相关请求,将语料写入系统,并对语料进行切片和 embedding 处理,最后上传到向量检索侧进行存储。
这个流程是后续 RAG 能力的基础。只有先完成知识入库,后续 Agent 才能基于知识库进行检索增强。
4.3 查询流程待完善
当前查询流程还没有完全接入项目代码。今天主要是通过 API 调试工具尝试调用查询接口,验证查询方向和基础可行性。明天或后续需要重点完成查询模块,包括正式查询接口、检索逻辑、返回结果格式,以及与前端页面或 Agent 调用链路的衔接。
查询能力补齐后,知识库 MVP 才能从“只支持入库”进一步发展为“支持入库与检索”的完整最小闭环。
4.4 离线开发工具部署
Claude Code 的离线部署让我进一步理解到,在企业内部受限网络环境中,开发工具的可用性本身也是工程效率的一部分。通过修改配置文件实现跳过登录,并结合内部可访问的代码和模型配置,可以让开发工具在没有完整外网权限的环境中运行起来。
这类部署经验对后续团队效率提升有一定帮助,尤其是在 VDI 虚拟机、内网环境、外网受限的公司开发场景下。
5. 今日个人理解
今天我对项目当前阶段有了更实际的认识。之前更多是在理解“智能体管理平台”或“Agent 基座”这个目标,今天通过阅读源码和参与开发,我意识到项目目前还处在从 0 到 1 的基础搭建阶段。前端已有雏形,但后端能力、知识库能力和 Agent 运行链路仍需要一步步补齐。
我也进一步理解到,知识库模块虽然看起来只是一个插件需求,但它实际上会影响后续 Agent 的核心能力。如果 Agent 要在企业业务中真正可用,就必须能够接入内部知识、检索相关资料,并基于业务上下文进行回答,而不是只依赖模型本身的泛化能力。
另外,今天完成 Claude Code 在隔离环境中的部署,也让我体会到企业开发中环境约束带来的挑战。很多事情在普通网络环境下很简单,但在公司 VDI 和无外网权限环境中,需要通过配置调整和替代方案才能落地。
6. 后续待明确问题
- 知识库查询接口的具体实现方式;
- 查询结果返回格式是否需要统一规范;
- 知识块、知识库、语料切片之间的数据模型关系;
- Redis 集群在知识库模块中具体承担缓存、状态还是其他作用;
- MySQL 数据库中需要保存哪些知识库元数据;
- Milvus/向量检索侧与项目后端之间的接口边界;
- 前端知识库管理页面是否需要同步调整;
- 知识库模块后续如何与 Agent 调用链路结合;
- Claude Code 离线部署配置是否需要整理成团队内部文档。
7. 明日/后续计划
明天计划优先补齐知识库查询模块,将今天已经完成的知识入库流程继续向查询流程推进,争取形成知识库最小可用闭环。后续需要完成查询接口开发、检索结果返回、项目路由接入以及必要的接口调试。
同时,我还需要继续熟悉当前项目代码结构,尤其是后端尚未完善的部分,明确知识库模块后续如何与智能体管理平台、Agent 创建流程和未来的 RAG 增强能力结合。
如果时间允许,也可以将今天 Claude Code 在隔离 VDI 环境下的部署方法整理成简要说明,方便后续同事复现和使用。
8. 今日总结
今天的工作让我从代码层面、业务需求层面和工程环境层面对项目有了更深入的认识。上午我通过源码阅读明确了项目前后端结构和当前从 0 到 1 的建设状态;下午和晚上,我参与推进了知识库模块 MVP,完成了资源接入和入库链路开发;同时还解决了 Claude Code 在隔离 VDI 环境下的部署问题。整体来看,今天不仅推进了具体功能开发,也帮助我更清楚地理解了智能体管理平台后续建设的技术路径。