cloudbase-agent-ts

Cloudbase Agent（TypeScript）

用于通过 AG-UI 协议将 AI Agent 部署为 HTTP 服务的 TypeScript SDK。

注意： 此技能仅适用于 TypeScript/JavaScript 项目。

何时使用此技能

当你需要进行 AI Agent 开发 时，请使用此技能：

• 通过 AG-UI 协议支持将 AI Agent 部署为 HTTP 服务
• 使用 LangGraph 或 LangChain 框架构建 Agent 后端
• 创建实现 AbstractAgent 接口的自定义 Agent 适配器
• 了解 AG-UI 协议事件和消息流
• 构建连接到兼容 AG-UI 的 Agent 的 Web UI 客户端
• 构建用于 AI Agent 交互的微信小程序 UI

请勿用于：

• 不具备 Agent 能力的简单 AI 模型调用（请使用 ai-model-* 技能）
• CloudBase 云函数（请使用 cloud-functions 技能）
• 不具备 Agent 功能的 CloudRun 后端服务（请使用 cloudrun-development 技能）

如何使用此技能（面向编码 Agent）

必须阅读：阅读所有与你的任务相关的文档

编写任何代码之前，请确定需要哪些文档，并全部阅读。只阅读部分文档会导致实现不完整（例如遗漏 CORS、适配器模式错误或缺少 UI 客户端代码）。

按场景划分的阅读清单

如果任务要求你……	必须阅读这些文档
构建全栈 Agent（后端 + 前端）	server-quickstart.md + 适配器文档 + ui-clients.md
仅部署 Agent 服务	server-quickstart.md
使用 LangGraph 实现 Agent 逻辑	adapter-langgraph.md + server-quickstart.md
使用 LangChain 实现 Agent 逻辑	adapter-langchain.md + server-quickstart.md
构建自定义适配器（不使用 LangGraph/LangChain）	adapter-development.md + agui-protocol.md + server-quickstart.md
构建 Web/小程序 UI 客户端	ui-clients.md + agui-protocol.md

分步工作流

1. 从任务描述中确定适配器类型（LangGraph / LangChain / 自定义）
2. 阅读上表中对应的文档——阅读列出的所有文档，而不只是其中一篇
3. 使用 @cloudbase/agent-server 设置 Agent 服务——始终包含 cors: true
4. 使用选定的适配器实现 Agent 逻辑
5. 如果要构建 UI，请阅读 ui-clients.md 并创建客户端代码

参考文档索引

文档	阅读时机
server-quickstart	始终阅读——部署、CORS、日志、端点
adapter-langgraph	任务提到 LangGraph、StateGraph 或基于图的工作流时
adapter-langchain	任务提到 LangChain、链或基于链的模式时
adapter-development	任务需要自定义适配器（没有现成的框架适配器）时
agui-protocol	任务需要自定义适配器或深入了解协议时
ui-clients	任务提到 Web UI、前端、客户端或 SSE 流式传输时
ui-miniprogram	任务提到微信小程序或小程序 UI 时

快速开始

import { run } from "@cloudbase/agent-server";
import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";

run({
  createAgent: () => ({ agent: new LanggraphAgent({ workflow }) }),
  port: 9000,
});