概述
什么是 Agent
Agent（智能体）是一种能够自主执行任务、与用户交互并调用外部工具的 AI 应用。与传统的对话式 AI 不同，Agent 具备以下核心能力：
- 自主决策：根据用户输入和上下文自主规划执行步骤
- 工具调用：调用外部 API、数据库、搜索引擎等工具完成任务
- 多轮交互：支持复杂的多轮对话和状态管理
- 流式输出：实时流式返回思考过程和执行结果
技术选型
CloudBase 目前对以下 Agent 框架进行了适配：
框架选择
| 框架 | 语言支持 | 特点 | 适用场景 |
|---|---|---|---|
| LangChain | TypeScript/Python | 成熟稳定、生态丰富 | 通用 Agent 开发 |
| LangGraph | TypeScript/Python | 图结构工作流、精细控制 | 复杂多步骤任务 |
| CrewAI | Python | 多 Agent 协作 | 团队协作型任务 |
部署方式
| 方式 | 特点 | 开发语言 | 适用场景 |
|---|---|---|---|
| HTTP 云函数 | 快速部署、按量计费、自动扩缩容 | JavaScript/TypeScript/Python | 轻量级 Agent、低频调用 |
| 云托管 | 长连接支持、自定义运行时 | 基于容器，支持任意编程语言 | 复杂 Agent、高并发场景 |
开发流程
1. 选择开发框架
根据项目需求选择合适的 Agent 框架：
2. 开发 Agent 逻辑
使用云开发提供的 Agent 适配器，将框架与 AG-UI 协议对接：
// LangChain 示例
import { LangchainAgent } from "@cloudbase/agent-adapter-langchain";
import { createAgent as createLangchainAgent } from "langchain";
// 创建 LangChain Agent
const lcAgent = createLangchainAgent({ model, checkpointer });
// 包装为 AG-UI 兼容的 Agent
const agent = new LangchainAgent({
agent: lcAgent,
});
3. 部署到云开发
选择合适的部署方式：
4. 客户端集成
在各端调用 Agent：
AG-UI 协议
云开发 Agent 完全兼容 AG-UI 协议，这是一个标准化的前后端通信协议，支持：
- SSE 流式传输：实时推送 Agent 执行过程
- 工具调用：前端和服务端工具的统一调用规范
- 人机交互：支持用户确认、输入等交互场景
- 状态同步：Agent 状态与客户端实时同步
快速开始
前置条件
5 分钟快速体验
# 1. 安装依赖
npm install @cloudbase/agent-adapter-langchain @cloudbase/agent-server langchain @langchain/openai @langchain/langgraph express
# 2. 设置环境变量
export TCB_ENV_ID=your-env-id # 云开发环境 ID
export TCB_API_KEY=your-api-key # 云开发 API Key
export TCB_AI_MODEL=hunyuan-turbos-latest # 模型名称
# 3. 创建 Agent
cat > index.js << 'EOF'
const { LangchainAgent } = require("@cloudbase/agent-adapter-langchain");
const { createExpressRoutes } = require("@cloudbase/agent-server");
const { createAgent: createLangchainAgent } = require("langchain");
const { ChatOpenAI } = require("@langchain/openai");
const { MemorySaver } = require("@langchain/langgraph");
const express = require("express");
const checkpointer = new MemorySaver();
function createAgent() {
// 使用云开发内置的大模型端点
const model = new ChatOpenAI({
model: process.env.TCB_AI_MODEL || "hunyuan-turbos-latest",
apiKey: process.env.TCB_API_KEY,
configuration: {
baseURL: `https://${process.env.TCB_ENV_ID}.api.tcloudbasegateway.com/v1/ai/hunyuan/v1`,
},
});
const lcAgent = createLangchainAgent({ model, checkpointer });
return {
agent: new LangchainAgent({ agent: lcAgent }),
};
}
const app = express();
createExpressRoutes({ createAgent, express: app });
app.listen(3000, () => console.log("Agent running on http://localhost:3000"));
EOF
# 4. 本地运行
node index.js
访问 http://localhost:3000 即可体验 Agent。
提示
云开发内置了腾讯混元和 DeepSeek 大模型，无需额外申请外部 API Key。详见 大模型配置指南。