一、思维导图整体知识结构梳理整体分为三大模块AI 基础概念、Hutool‑AI 集成、Java 项目实践要点。AI 基础概念大模型 LLM基于海量文本训练擅长对话、文本生成、逻辑推理举例 DeepSeek、通义千问、GPT。API 调用程序通过 HTTP 请求访问大模型本地无需部署模型依靠 ApiKey 完成身份认证。Prompt 提示词分为 system设定 AI 身份、规则、user用户提问、assistantAI 返回回答三部分。Message 消息对象存储一轮对话由 role 角色 content 内容组成多轮对话把全部历史消息存入ListMessage集合。多轮对话请求携带完整消息列表实现 AI 上下文记忆。Hutool‑AI 集成依赖引入Maven 导入 hutool‑ai 依赖指定对应大模型驱动。核心对象AIConfig配置类存放模型名称、apiKey、接口地址。AIConfigBuilder构建者模式链式组装配置。AIUtil工具类chat () 方法发起对话请求。Message封装角色和对话内容。开发步骤创建 AIConfig 配置→初始化消息集合→添加 system 角色设定→添加 user 提问→AIUtil.chat () 发送请求→解析 JSON 取出 content→将 assistant 回复加入消息集合完成多轮。返回结果解析接口返回 JSON 字符串提取 content 字段拿到 AI 输出。常见问题ApiKey 错误报 401没传 system 缺少角色约束多轮不保存历史造成无记忆网络不通、域名访问失败。Java 项目实践要点封装工具类把 AI 请求封装成工具方法外部只传 prompt避免重复配置。异常处理捕获网络异常校验返回结果非空。安全注意ApiKey 禁止硬编码、禁止提交 git使用配置文件保存密钥。二、思维导图制作与分享意图梳理 AI 大模型 Java 集成整套流程区分理论概念和代码实操把 LLM、Prompt、Message、多轮对话这些抽象概念整理成层级结构方便快速回顾。把 Hutool‑AI 的组件、开发步骤、踩坑点统一汇总遇到报错可以直接对照导图排查问题比如 401、多轮无记忆等问题定位。提炼项目开发规范重点标记密钥安全、工具类封装、异常处理等工程化要点用于后续开发 Java 智能体项目时查阅。结构化输出便于复盘记忆巩固大模型 API 调用的底层逻辑不只是调用工具理解多轮对话的消息传递原理。三、当日学习总结今天学习 Java 对接大模型掌握 LLM 基础概念理解 API 调用模式搞懂 Message 消息集合实现多轮对话的原理。学会使用 Hutool‑AI 工具库完成配置、消息组装、请求发送、结果解析完整流程。实操中认识常见报错原因懂得 ApiKey 安全规范不能硬编码密钥。同时理解 system、user、assistant 三种角色消息的作用。明白了 Java 智能体底层本质就是组装消息列表调用大模型接口为后续智能体项目开发打下基础。实际编码要做好工具封装和异常捕获处理接口返回的数据规避开发中的常见坑。
