Zacks_xdc-优快云博客

原创【运维】Nginx 蓝绿部署与流式任务（SSE）不中断架构实战

本文探讨了在AI Agent应用中实现无缝部署的技术方案。当AI执行耗时3分钟的流式推理任务时，传统部署方式会导致连接中断，造成推理结果丢失。文章提出采用蓝绿部署架构，保持新旧环境并存，逐步排空旧连接。技术选型上，采用Next.js 15 App Router处理SSE流式输出，Vercel AI SDK简化协议封装，Prisma+PostgreSQL管理结构化数据，HeroUI提供适配的UI组件。这套方案能确保在版本发布时，正在执行的流式任务不会中断，用户可继续接收完整的推理结果，同时系统实现平滑升级。

2026-07-29 15:14:12 765

原创【从0开发一个 Agent】第十八章：未来扩展方向——从“工具”到“生态”的架构演进

1）Workflow实现业务流程自动化；2）Computer Use支持图形界面操作；3）Browser Agent执行网页级任务；4）Voice Agent实现自然语音交互；5）Coding Agent完成全链路开发；6）Deep Research进行深度知识发现。同时指出AI Agent将向生态协同、全链路自动化和开放平台三大趋势发展，建议通过模块化升级、协议标准化、安全增强等架构适配策略支持这些扩展。最终强调AI Agent的进化是持续过程，当前架构应具备面向未来的可扩展性。

2026-07-27 15:13:12 618

原创【从0开发一个 Agent】第十七章：完整项目回顾与架构终章

从零构建企业级AI Agent系统的完整架构。历经16个模块的开发后，文章从全局视角审视了模块间的协同机制：包括请求入口与上下文准备、任务规划与多Agent协作、知识检索与工具调用、推理与数据持久化等关键流程。系统采用分层解耦设计，通过结构化标签实现上下文安全注入，基于MCP协议标准化工具调用，并借助Vercel AI SDK实现流式响应。架构强调安全左移、成本感知和弹性设计，支持权限校验、多级缓存和熔断降级。该架构不仅具备生产级可用性，还预留了能力扩展、性能优化和安全增强的演进空间

2026-07-27 15:12:18 412

原创【从0开发一个 Agent】第十六章：企业级性能优化与高可用架构

AI Agent系统的深度优化策略。针对高并发、高延迟和成本控制等核心挑战，提出分层缓存、异步解耦、熔断降级的三位一体架构。内容包括：多级缓存体系（L1内存/L2语义/L3 Prompt Cache）可降低70%以上的LLM调用量原子化的Embedding缓存与索引重建机制，显著提升向量检索效率异步批量处理非实时操作，解耦核心链路熔断降级策略确保外部服务故障时的系统韧性成本感知架构实现Token消耗的精细化管控通过防御性编程和资源隔离设计，使系统在保证性能的同时，具备企业级的高可用性和可控性

2026-07-24 17:00:41 312

原创【从0开发一个 Agent】第十五章：Agent 生产环境部署

AI Agent系统从开发到生产环境部署的关键步骤，重点构建容器化、安全防护和可观测性架构。内容包括：生产部署必要性分析：解决环境差异、安全风险、成本失控和故障排查四大挑战；架构设计方案：采用Nginx反向代理+Docker容器化+可观测性三支柱（指标/日志/追踪）的一体化架构；核心配置实现：包括多阶段Docker构建优化、Nginx的HTTPS/限流/缓存配置、环境变量管理和Prometheus监控集成。通过不可变基础设施和可观测性驱动运维，确保AI服务的高可用性、安全性和成本可控性。

2026-07-24 16:59:45 318

原创【从0开发一个 Agent】第十四章：构建企业级用户系统与权限隔离

为AI Agent构建企业级安全架构的重要性及实现方案。传统Web安全模型在AI场景下存在诸多不足，如上下文污染、API Key滥用、审计盲区和多租户隔离失效等问题。使用"身份-权限-数据-审计"四层防护体系，核心设计包括分层会话管理、RBAC+数据权限双轨制、API Key动态注入和全链路审计。技术实现上展示了基于NextAuth.js的身份认证框架、Prisma权限模型以及Redis会话管理的关键代码，通过数据库行级安全(RLS)和向量检索过滤实现物理级数据隔离，为AI Agent构建端到端的安全防护。

2026-07-24 09:42:31 358

原创【从0开发一个 Agent】第十三章：实现多模态文件处理能力

文章摘要：本文探讨了如何为AI系统添加多模态文件处理能力，以解决企业场景中70%核心信息被锁定在非结构化文档中的问题。通用大模型直接处理企业文档存在版式结构丢失、算力消耗大和误差累积三大缺陷。为此，作者提出"解析-结构化-注入"三层架构，将文件解析与AI推理解耦，实现异步处理和结构化输出。技术实现包括多模态解析引擎适配层、文件上传异步接口，以及将解析内容注入Agent上下文的机制。通过专门设计的文档解析引擎，系统能有效处理PDF、Excel等格式，保留语义结构，使AI真正理解企业文档内容。

2026-07-24 09:39:46 457

原创【从0开发一个 Agent】第十二章：实现多 Agent 协作

剖析了单 Agent 在复杂任务中的结构性缺陷，并引入了 Orchestrator-Workers 多 Agent 协作架构。实现了 Researcher、Writer、Reviewer 三个专业化 Worker Agent，并通过 as_tool() 机制将其封装为 Manager 可调用的工具。构建了 Manager Agent 的协作流程，支持任务拆解、迭代审核和结果整合，同时确保用户无感知。解决了多 Agent 通信成本、责任归因和安全越权等核心工程问题，为生产环境部署奠定基础

2026-07-23 09:29:45 858

原创【从0开发一个 Agent】第十一章：构建 Planner

本文提出了基于REWOO架构的Planner解决方案，用于解决复杂任务处理中的上下文稀释和意图漂移问题。传统ReAct模式在处理长链路、多依赖任务时存在串行依赖、Token效率低和容错性差等缺陷。REWOO架构通过规划-执行-合并三阶段实现任务解耦：Planner生成结构化任务DAG，Executor负责按图执行并管理变量池，Solver整合最终结果。相比ReAct，该方案具有Token效率高（仅规划/合并阶段调用LLM）、稳定性强（支持任务重规划）和可观测性好（结构化DAG可视化）三大优势。

2026-07-23 09:25:38 195

原创【从0开发一个 Agent】第十章：Prompt Engineering 工程化

随着Agent功能模块增加，传统Prompt面临三大挑战：上下文稀释导致指令遗忘、意图漂移引发推理偏差、安全边界模糊易受攻击。为此，作者提出将Prompt从文本升级为动态管理系统，核心设计包括模块化拆分（角色定义、工具描述等）、动态上下文管理和防御性设计。技术实现上展示了原子化模板引擎、注入防御层和动态上下文管理器的代码示例，通过类型安全模板、输入过滤和反思机制确保Agent稳定性。最终在API路由中集成这些模块，实现安全、可维护的企业级Prompt工程方案。

2026-07-22 09:15:16 512

原创【从0开发一个 Agent】第九章：实现 RAG (检索增强生成)

本文介绍了在企业级AI应用中实现检索增强生成（RAG）的方法，解决大语言模型缺乏企业私有知识的问题。RAG通过在生成答案前检索外部知识库，将相关文档片段作为上下文输入模型，实现"开卷考试"效果。文章详细阐述了RAG架构的四个核心组件（文本块、向量嵌入、向量存储和检索器），并提供了数据库设计和代码实现方案，包括文档解析、向量化入库和检索注入流程。测试验证部分强调了对检索结果准确性的检查，最后讨论了常见的检索不相关和PDF解析问题及其解决方案。该技术能有效提升AI对企业内部知识的回答准确性。

2026-07-22 09:13:09 443

原创【从0开发一个 Agent】第八章：实现长期记忆

本文介绍了如何为AI构建记忆系统，解决其"健忘"问题。传统对话界面仅拼接历史对话作为上下文，超出窗口即丢失信息。作者提出分层记忆架构：短期会话记忆维持单次对话连贯性，长期记忆（语义/情景记忆）跨会话存储。系统采用读写分离设计，异步提取有价值信息存入数据库（含向量化存储）。核心实现包括：1）会话持久化；2）LLM异步提取记忆；3）基于向量检索的相关记忆注入。测试验证了记忆的保存、提取和检索功能，并讨论了记忆膨胀等问题的解决方案。

2026-07-21 09:26:59 258

原创【从0开发一个 Agent】第七章：实现 MCP (Model Context Protocol)

本文介绍了AI时代的"USB接口"——MCP（Model Context Protocol）协议，它解决了传统Tool Calling存在的耦合问题。文章详细阐述了MCP的核心架构与生命周期，包括初始化、能力发现、动态注入和协议化执行四个阶段，并提供了在Next.js项目中实现MCP客户端的代码示例。通过MCP，AI Agent可以动态发现和调用远程工具，无需修改核心代码即可实现无限扩展。文章还讨论了工具参数校验和连接管理等常见问题，展示了如何将MCP工具无缝接入AI SDK。

2026-07-21 09:25:55 524

原创【从0开发一个 Agent】第六章：实现 Tool Calling

本文摘要：本章介绍了如何为AI聊天应用赋予"Tool Calling"能力，使其从被动回答升级为主动执行任务。通过Vercel AI SDK和Zod构建工具集（时间查询、天气获取、数据库操作），实现模型决策与代码执行的解耦。关键点包括：1) 工具调用闭环机制（意图识别→生成指令→外部执行→结果整合）；2) 使用Zod确保参数安全；3) 前端状态可视化反馈；4) 多步调用(maxSteps)支持复杂任务链。测试验证后，AI已具备实时交互能力，为后续接入标准化外部服务(MCP协议)奠定基础。

2026-07-20 09:27:33 453

原创【从0开发一个 Agent】第五章：构建企业级聊天体验

摘要：本章聚焦企业级AI聊天体验优化，通过状态管理、交互控制和UI反馈提升生产力工具实用性。核心实现包括：交互控制：利用Vercel AI SDK内置方法实现停止生成/重新生成功能；代码复制：为Markdown代码块添加悬浮复制按钮；自动滚动：根据消息流动态保持可视区域；状态持久化：结合PostgreSQL存储对话记录，解决刷新丢失问题；主题适配：支持亮/暗色模式无缝切换。通过Zustand状态管理、响应式设计和数据库同步，将基础聊天功能升级为可靠的生产级系统。

2026-07-20 09:26:09 169

原创【从0开发一个 Agent】第四章：实现第一个 AI Chat

理解了 Streaming 对于 AI 应用体验的决定性作用。实现了基于 Vercel AI SDK 的 streamText 后端流式接口。利用 useChat Hook 在前端实现了零样板代码的状态管理。集成了 react-markdown 与 react-syntax-highlighter，实现了生产级的富文本渲染。

2026-07-17 09:16:55 438

原创【从0开发一个 Agent】第三章：初始化项目

创建了基于 App Router 的 Next.js 项目，选择了 src/ 目录结构。安装了 AI SDK、Prisma、HeroUI、react-markdown 等核心依赖。建立了符合 AI Agent 开发范式的目录结构，将 UI、AI 逻辑、数据库配置分离。完成了 Prisma 初始化与 AI SDK 基础配置。解决了 Prisma 连接池、HeroUI 样式等常见踩坑问题。

2026-07-17 09:15:42 207

原创【从0开发一个 Agent】第二章：技术选型与整体架构设计

本章的目标是解释我们为什么选择这些特定的技术，而不是简单地罗列依赖。我们将构建一个兼顾开发效率、运行性能和未来扩展性的企业级架构。

2026-07-16 15:15:21 362

原创【从0开发一个 Agent】第一章：为什么 AI Agent 是下一代应用形态

本章的目标是帮你建立对 AI Agent 的整体认知，理清它与传统 AI Chat 的本质区别，并为你展示在本教程结束时，你将亲手构建出的企业级应用全貌。

2026-07-16 14:53:48 362

原创【全栈】云服务器安装 MySQL + Next.js 连接完整 Demo

本文详细介绍了在阿里云服务器上搭建MySQL环境并与Next.js项目连接的完整流程。主要内容包括：1）在CentOS/Ubuntu系统安装配置MySQL，设置远程连接权限和安全组规则；2）创建Next.js项目，通过mysql2库建立数据库连接池；3）实现API接口查询MySQL数据并在前端展示。文章提供了完整的代码示例和常见问题排查方法，适用于任何云服务器环境，帮助开发者快速搭建Next.js+MySQL的开发环境。关键点包括MySQL远程访问配置、环境变量管理和连接池使用等最佳实践。

2026-03-27 16:18:27 310

原创【全栈】Next.js + MySQL 实现CRUD完整代码（包含部署生产环境）

本文介绍了使用Next.js 13+ App Router实现MySQL数据库CRUD操作的完整方案。主要内容包括：1) 安装MySQL2和dotenv依赖；2) 配置开发和生产环境变量；3) 创建支持连接池、防注入、错误处理的数据库工具类；4) 实现包含参数校验和安全返回的RESTful API接口。项目采用模块化结构，通过环境变量管理敏感信息，封装了生产级的数据库操作方法，并提供了用户表的增删改查示例代码。所有代码均经过测试可直接用于生产环境。

2026-03-24 11:40:15 325

原创【全栈】Next.js + PostgreSQL + Vercel 实现完整登录系统（完整源码）

本文介绍了一个基于Next.js 14+和PostgreSQL的生产级登录系统实现方案。系统采用JWT认证、Prisma ORM和bcrypt密码哈希技术，部署于Vercel平台。主要内容包括：1) 技术栈选择与核心思路；2) 环境准备与Vercel Postgres数据库创建；3) 项目初始化与Prisma配置；4) 后端API接口实现（注册/登录/用户信息获取）；5) 前端页面开发与状态管理。文章提供了完整的目录结构、代码示例和部署流程，帮助开发者快速搭建安全可靠的用户认证系统。

2026-03-17 18:23:59 575

原创【SEO】Next.js 15 SEO优化实战：Metadata API全解析

本文介绍了如何使用Next.js 15的Metadata API优化企业官网的SEO效果，重点针对百度搜索引擎。文章指出SSR只是SEO的基础，还需要正确配置元标签、结构化数据等。Next.js 15的Metadata API提供了类型安全的元数据管理方式，支持服务端生成完整HTML、静态生成等特性，对百度爬虫友好

2026-02-27 17:34:13 693

原创【全栈】从 0 到 1：用 Vercel AI SDK + Next.js 实现一个 AI 对话应用（完整源码）

本文是一篇从 0 到 1 的完整博客教程，教你如何用 Vercel AI SDK + Next.js（App Router）做一个带前端界面的 AI 对话应用，并带有数据库和部署教程。

2026-02-26 15:15:52 1016

原创【运维】Vercel修改自定义域名并支持国内访问

Vercel使用自定义域名支持国内访问

2025-09-05 16:45:08 3576

原创【前端】使用Vercel部署前端项目，api转发到后端服务器

本文介绍了两种方案，通过Vercel部署前端项目，api转发到后端服务。

2025-09-05 15:25:32 1994

原创【前端】React + Antd5 + react-resizable 实现 Table 拖拽调整列宽源码

本文介绍了基于Ant Design Table组件实现可伸缩列表头的技术方案。通过react-resizable库重写表头单元格，封装成通用的ResizeTable组件。关键技术点包括：1) 使用Resizable组件实现列宽拖拽功能；2) 通过onHeaderCell属性为表头添加调整功能；3) 状态管理处理列宽变化；4) 防抖优化避免频繁更新。该方案解决了Antd 3.x后官方示例缺失的问题，并提供了最小可用实现，开发者可根据业务需求进行扩展。组件支持动态记录列宽变化，防止重新渲染时的宽度重置问题。

2025-07-15 16:46:49 700

空空如也

空空如也