手搓生产级 AI Agent 系统(35):Agent类型选型与架构设计中的伦理安全约束
承接MCP服务集成,本篇从感知-决策-行动循环出发,梳理反应式、基于模型、学习型Agent的选型取舍,并把伦理、隐私、透明性与责任归属作为架构约束嵌入分层设计,给出面向中国开发者的落地决策参考。
手搓生产级 AI Agent 系统(34):MCP服务集成实战与配置排错指南
承接系列第33篇的配置排错思路,本篇聚焦MCP服务集成实战。基于官方资料中反复出现的MCP概念、stdio/sse分类、uvx指令、json配置和MCP Inspector调试工具,梳理从环境准备到调用MCP服务的完整流程,并针对连接失败、配置错误、调试困难等常见问题给出排查路径。
手搓生产级 AI Agent 系统(33):Spring AI接入Spring Boot的常见配置问题与排错思路
承接多模型接入架构设计,聚焦Spring AI与Spring Boot集成时最易卡住的环节:依赖与配置组织、提示模板与模型交互链路、分层排错清单。基于官方快速开始类资料,给出可复用的最小集成路径与排查顺序。
手搓生产级 AI Agent 系统(32):Spring AI多模型接入架构设计
本篇是系列第32篇,从Java开发者已有Spring Boot项目出发,讨论Spring AI多模型接入的工程架构设计。围绕统一接口抽象、依赖组织、配置切换与分层结构展开,并分析Spring AI与LangChain4j在Spring生态融合度上的选型考量。文中接口名、依赖名与版本兼容性均需以官方文档为准,对比结论也需结合实测评估。
手搓生产级 AI Agent 系统(31):Spring AI 架构选型与生产落地考
本篇从已有 Spring 应用的架构演进视角出发,讨论引入 Spring AI 时的分层与模块化设计思路、模型集成方式的选型维度,以及生产落地阶段需要额外评估的工程问题。文中对 Spring AI 具体能力的描述均标注为当前搜索到的社区资料摘要,尚未经官方文档独立核验,选型时需进一步确认。
手搓生产级 AI Agent 系统(30):DeepSeek接入方式怎么选
承接MCP选型,梳理DeepSeek的多种集成形态:应用程序、AI Agent框架、RAG框架、编辑器与浏览器插件、即时通讯插件及本地部署。从开发场景出发给出选型判断框架,并列出需核验的官方能力与限制。
手搓生产级 AI Agent 系统(29):MCP接入选型与架构梳理
本篇是系列第29篇,围绕MCP接入选型展开。基于当前搜索信号中的社区资料,梳理stdio与SSE两类传输方式的工程差异、Host/Server结构下各客户端的配置特点,以及多客户端接入的常见问题。所有来自社区的说法均明确归因,未经验证的细节标注为工程经验或待官方文档确认,并给出选型决策框架与时效性提醒。
手搓生产级 AI Agent 系统(28):MCP三层架构解析与集成选型
本篇为系列第28篇,基于公开搜索资料与社区实践整理,解析MCP Host/Client/Server三层协作机制,对比Java SDK、Spring AI与Python SDK的开发模式差异,梳理生产集成中的调试依赖、description字段、LLM选型等关键考量,并提供从Function Calling向MCP迁移的选型checklist。所有具体产品能力均标注为待官方核验。
手搓生产级 AI Agent 系统(27):Gemini agent的企业集成机制与落地启示
Google Cloud在Gemini at Work 2026发布Gemini agent,定位为面向工作的通用Agent。本文从企业Agent落地视角,拆解其业务上下文接入、技能与工具调用、模型选择与成本控制、安全治理等机制,并给出对自建生产级Agent系统的工程启示。
手搓生产级 AI Agent 系统(26):GitHub 上下文感知密钥检测模型解析
GitHub 发布专用密钥泄露检测模型,通过读取上下文识别无固定格式的凭据。本文解析其检测机制、与传统正则/熵检测的差异,并给出集成到 CI/CD 与 AI Agent 编程工作流的工程建议。
手搓生产级 AI Agent 系统(25):MCP 全链路落地前的架构梳理
作为系列第 25 篇,本文基于官方资料梳理 MCP Host、Client、Server 三种角色的边界,对比 stdio 与 SSE 两种通信方式,分析 Python、TypeScript、Java、Kotlin 四种 SDK 及 Spring AI 集成路径,并给出 MCP Inspector 调试与选型建议,帮助开发者在全链路落地前完成架构决策。
手搓生产级 AI Agent 系统(24):RAG变体选型指南
承接系列教程,基于六类RAG变体(Agentic RAG、AUTO-RAG、ChunkRAG、FastRAG、Graph RAG、HtmlRAG)的核心思想,提出面向中国AI开发者的选型决策框架,重点讨论从传统RAG迁移时的检索策略、数据形态与系统复杂度等工程维度。
手搓生产级 AI Agent 系统(23):LangGraph 与 Ollama 选型对比
本篇是《手搓生产级 AI Agent 系统》第 23 篇,围绕 AI Agent 构建工具选型展开。基于公开资料中关于 LangGraph 与 Ollama 的对比信息,分析两者在 Agent 编排与本地模型推理上的不同定位,给出选型考量与组合使用建议,帮助开发者在生产级 Agent 系统中做出合理技术决策。
手搓生产级 AI Agent 系统(22):DeepSeek Harness 桌面版实测与外
作为系列第 22 篇,本文以社区实测文章为唯一信息来源,梳理 DeepSeek Harness v0.2 桌面版在脏表清洗、定时任务、npm 插件安装与 Agent 自造插件四类场景中的表现,并对比 Claude Code、WorkBuddy、Trae、Qoder 的定位差异。全文对赠金规则、插件使用率、发布稿引语等社区转述口径做明确归因与降级处理,给出可复现的安装配置步骤、实测口径与安全边界。
手搓生产级 AI Agent 系统(21):MCP 接入后调不通?全链路排错与验
本篇是系列第 21 篇,聚焦 MCP 接入后的全链路排错。围绕 Host、Client、Server 三层,梳理 stdio/SSE 通信选择、资料中提到的 MCP Inspector 调试工具、SDK 实现与 Spring AI 集成中的常见失败模式,给出可执行的验证顺序与边界说明,并明确标注需以官方文档核验的内容。
手搓生产级 AI Agent 系统(20):RAG形态选型实战:传统RAG、Graph R
本篇是《手搓生产级 AI Agent 系统》第20篇,聚焦传统RAG、Graph RAG与Agentic RAG三种形态的选型决策。当前搜索信号中引用的社区文章摘要提及企业客服、工厂质检、智能旅游等场景,但尚未经官方资料独立核验。文章基于通用工程分析,讨论不同业务场景下的选择依据、知识库构建与检索优化权衡,以及形态演进时的迁移路径与潜在成本,不涉及具体版本、框架或性能数字。
手搓生产级 AI Agent 系统(19):从AI Agent到Agentic AI的架构与安全考量
本文是《手搓生产级 AI Agent 系统》系列第19篇。基于搜索信号中关于Agentic AI与AI Agent区别的讨论,本文从工程视角分析如何判断任务场景是否需要引入Agentic AI能力,并梳理在架构层面需要提前考虑的安全设计、透明性保障与责任归属机制,避免算法公平性、隐私安全等风险在生产部署中失控。
手搓生产级 AI Agent 系统(18):从单MCP到多MCP架构选型与落地关注点
承接系列上一篇 Agent Identity 与 Delegated Authority 的治理视角,本篇聚焦 MCP Host、MCP Client、MCP Server 三段角色,梳理从单 MCP 到多 MCP 的接入结构差异、配置要点与调试关注点,并讨论 MCP 与 Tool Calling 的关系对架构选型的影响,形成面向生产落地的 MCP 集成架构对比研究框架。
DeepSeek API 401 排查:鉴权头与密钥环境隔离
针对服务端集成 DeepSeek API 时高频出现的 401 Unauthorized,本文从鉴权头构造、Token 拼接与换行符污染、环境变量加载时序、网关代理重写请求头四个维度拆解排查路径,并给出最小 HTTP 客户端隔离验证与容器环境差异比对的可执行方法,帮助开发者快速区分密钥失效、编码污染与代理改写三类根因。
DeepSeek API 流式返回在 Python 中的解析与拼接
从 Python 客户端出发,梳理流式响应在 requests 与 httpx 下的读取方式、SSE 行解析、结束标记判断、增量拼接与去重,以及网络中断后缓冲区残留和重复输出的处理方法。文中不臆造接口字段,落地前请以官方文档为准。