免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。
本 Skill 为 TypeScript/JavaScript 项目提供 AI Agent 全链路开发指引，涵盖服务端部署与多端 UI 接入两大层面。核心办事内容包括：基于 @cloudbase/agent-server 将 LangGraph 状态机或 LangChain 链路封装为符合 AG-UI 协议的 HTTP 服务；通过 manageAgent MCP 工具一键托管至 CloudBase，并提前规避云构建依赖版本冲突；同时支持 Web 端（@ag-ui/client）与微信小程序（@cloudbase/agent-ui-miniprogram）两种客户端接入方案。产出为可直接运行的 Agent 服务端代码、客户端连接逻辑及部署配置。
skill.md：技能主说明（本文件）：触发条件、路由表与快速启动代码agent-deployment.md：CloudBase 托管部署指南，含依赖对齐策略与 manageAgent MCP 工具用法server-quickstart.md：@cloudbase/agent-server 服务端配置、CORS 与可观测性设置adapter-langgraph.md：LangGraph 适配器接入，含 ClientStateAnnotation 状态注解用法adapter-langchain.md：LangChain 适配器接入，含 clientTools() 客户端工具注册adapter-development.md：自定义适配器开发，基于 AbstractAgent 接口的实现规范agui-protocol.md：AG-UI 协议详解，事件类型与消息流格式ui-clients.md：Web 客户端构建指南，@ag-ui/client 连接 /send-message 或 /agui 端点ui-miniprogram.md：微信小程序深度接入，@cloudbase/agent-ui-miniprogram 专用组件与事件处理ClientStateAnnotation 客户端状态同步clientTools() 动态工具注册AbstractAgent 接口实现专用 Agent 逻辑，满足非标准框架需求manageAgent MCP 工具部署，内置依赖版本对齐策略避免构建失败@ag-ui/client）与微信小程序（@cloudbase/agent-ui-miniprogram）两种客户端场景| 用户怎么说 | 本技能做什么 |
|---|---|
| "我要把 LangGraph 写的 Agent 部署成 HTTP 服务" | 读取 adapter-langgraph.md + server-quickstart.md，输出带 ClientStateAnnotation 的适配器代码与 run() 启动配置 |
| "微信小程序里要接 AI 对话，后端用什么方案" | 读取 ui-miniprogram.md + agent-deployment.md，输出小程序端组件调用 + CloudBase 托管部署步骤 |
| "CloudBase 上构建 Agent 总是报依赖错" | 读取 agent-deployment.md 中 Dependency Alignment Policy，输出 @cloudbase/agent-* 包的版本锁定与对齐规则 |
| "LangChain 的 Agent 怎么暴露给前端调用" | 读取 adapter-langchain.md，输出含 clientTools() 的适配器实现与端点配置 |
| "AG-UI 的 event 流格式看不懂，要自定义客户端" | 读取 agui-protocol.md + adapter-development.md，输出事件类型对照表与 AbstractAgent 最小实现模板 |