跳到主要内容

多会话

Agent 允许用户拥有多个相互独立的会话,不同会话间的上下文互不影响。

启用多会话

在云开发平台 AI+ 菜单 -> Agent 详情页 -> 多会话模式,启用多会话模式

启用多会话

体验

启用多会话后,可在右侧预览区进行体验。

新会话:

新会话

会话记录:

会话记录

集成

用户可通过 Agent UI 组件、SDK、HTTP API 等方式集成多会话功能。

Agent UI

可视化低码组件、小程序源码组件、React 组件均内置多会话能力,具体用法可参考相关文档:

SDK 集成

初始化 SDK:

// 在 Web 项目的根目录下,使用 npm 或 yarn 安装所需的包:
// npm i @cloudbase/js-sdk

// 引入 SDK,这里我们引入了完整的 clousebase-js-sdk,也支持分模块引入
import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
env: "your-env", // 需替换为实际使用环境 id
});
const auth = app.auth();
await auth.signInAnonymously(); // 或者使用其他登录方式
const ai = await app.ai();
// 接下来就可以调用 ai 模块提供的方法了

新建会话:

const res = await ai.bot.createConversation({
botId: "botId-xxx",
title: "对话标题",
});

发送消息时携带会话 ID:

const res = await ai.bot.sendMessage({
botId: "botId-xxx",
history: [{ content: "你好", role: "user" }],
msg: "你好",
conversationId: "conversation-001",
});

查询消息记录时携带会话 ID:

await ai.bot.getChatRecords({
botId: "botId-xxx",
pageNumber: 1,
pageSize: 10,
sort: "asc",
conversationId: "conversation-001",
});

获取会话列表:

const res = await ai.bot.getConversation({
botId: "botId-xxx",
pageSize: 10,
pageNumber: 1,
});

删除会话:

await ai.bot.deleteConversation({
botId: "botId-xxx",
conversationId: "conversation-001",
});

详细参考 AI SDK 文档

HTTP API 集成

参考 HTTP API 文档