Cloudbase Agent (TypeScript) 是一个 TypeScript SDK，用于使用 AG-UI 协议将 AI 智能体部署为 HTTP 服务。该技能仅适用于 TypeScript/JavaScript 项目。
用途
当进行 AI 智能体开发并需要以下能力时，可以使用本技能：将 AI 智能体部署为支持 AG-UI 协议的 HTTP 服务；使用 LangGraph 或 LangChain 框架构建智能体后端；创建实现 AbstractAgent 接口的自定义智能体适配器；理解 AG-UI 协议事件与消息流；构建连接 AG-UI 兼容智能体的 Web UI 客户端；构建用于 AI 智能体交互的微信小程序 UI。
不适用场景：仅进行简单 AI 模型调用、不具备智能体能力（应使用 ai-model-* 技能）；CloudBase 云函数（应使用 cloud-functions 技能）；不具备智能体功能的 CloudRun 后端服务（应使用 cloudrun-development 技能）。
主要能力
该 SDK 提供将智能体作为 HTTP 服务暴露的能力，支持 AG-UI 协议。可选择以下适配器：LangGraph 适配器用于有状态、基于图的工作流；LangChain 适配器用于基于链的智能体模式；也可为专门化的智能体逻辑构建自定义适配器。服务器端通过 @cloudbase/agent-server 暴露 HTTP 端点，并可配置 CORS、日志与可观测性，部署到 CloudRun 或任意 Node.js 托管环境。客户端方面，Web 应用使用 @ag-ui/client，微信小程序使用 @cloudbase/agent-ui-miniprogram，并连接到智能体服务器的 /send-message 或 /agui 端点。
使用方式
快速开始的代码示例如下：
import { run } from "@cloudbase/agent-server"; import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";
run({ createAgent: () => ({ agent: new LanggraphAgent({ workflow }) }), port: 9000, });
文档路由（按任务查阅）：部署智能体服务器（@cloudbase/agent-server）查阅 server-quickstart；使用 LangGraph 适配器查阅 adapter-langgraph；使用 LangChain 适配器查阅 adapter-langchain；构建自定义适配器查阅 adapter-development；理解 AG-UI 协议查阅 agui-protocol；构建 UI 客户端（Web 或小程序）查阅 ui-clients；深入了解 @cloudbase/agent-ui-miniprogram 查阅 ui-miniprogram。
适用场景
需要以 HTTP 服务形式对外提供具备 AG-UI 协议支持的 AI 智能体的 TypeScript/JavaScript 项目；使用 LangGraph 或 LangChain 构建后端智能体的场景；需要自定义智能体适配器的场景；需要 Web UI 或微信小程序客户端与智能体交互的场景。
限制
该技能仅适用于 TypeScript/JavaScript 项目。不适用于简单 AI 模型调用、CloudBase 云函数、以及不具备智能体功能的 CloudRun 后端服务。关于具体的收费、价格、平台支持范围与运行效果，资料未提供更多信息。