Ant Design X

设计研发组件 X Markdown X SDK 演示国内镜像

介绍
数据流
- useXChat会话数据
  2.0.0
- useXConversations会话管理
  2.0.0
数据提供
工具
- XRequest请求
  2.0.0
- XStream流
  2.0.0

useXConversations
会话管理

用于多会话的对话保持和增删改查。

使用import { useXConversations } from "@ant-design/x";

源码components/use-x-conversations

文档

版本自 2.0.0 起支持

何时使用

需要进行会话列表管理，包括会话创建、删除、更新等操作时使用。

代码演示

API

useXConversations

tsx

type useXConversations = (config: XConversationConfig) => {
  conversations: ConversationData[];
  addConversation: (conversation: ConversationData) => boolean;
  removeConversation: (key: string) => boolean;
  setConversation: (key: string, conversation: ConversationData) => boolean;
  getConversation: (key: string) => ConversationData;
  setConversations: (conversations: ConversationData[]) => boolean;
};

XConversationConfig

tsx

interface XConversationConfig {
  defaultConversations?: ConversationData[];
  defaultActiveConversationKey?: string;
}

ConversationData

tsx

interface ConversationData extends AnyObject {
  key: string;
  label?: string;
}

Conversation Item 1
Conversation Item 2
This's Conversation Item 3, you can click me!
Conversation Item 4

使用 useXConversations 管理会话列表，展示基本的会话项目配置和交互功能。

Conversation Item 1
Conversation Item 2
This's Conversation Item 3, you can click me!
Conversation Item 4

Current Conversation Data:

{
  "key": "item1",
  "label": "Conversation Item 1"
}

展示会话的完整操作能力，包括动态添加、更新、删除、重置会话项目，以及获取当前会话数据。

List 1

Conversation Item 1
Conversation Item 2
This's Conversation Item 3, you can click me!
Conversation Item 4

List 2

Conversation Item 1
Conversation Item 2

展示多个会话实例的独立管理，支持添加、更新、删除会话项目，实现完全解耦的状态管理。

Conversation Item 1
Conversation Item 2
This's Conversation Item 3, you can click me!
Conversation Item 4

Hello! This is the welcome message for Conversation 1. I can help you answer various questions.

Hello, this is Conversation 1!

配合 useXChat 对话消息管理

结合 useXConversations 和 useXChat 实现会话管理与聊天功能的完整集成，支持多会话独立聊天和上下文切换。

Conversation Item 1
Conversation Item 2
This's Conversation Item 3, you can click me!
Conversation Item 4

请求远程历史消息

将 defaultMessages 设置为异步方法，可以在初始化时加载历史消息，该方法常与 useXConversations hook 配合使用，实现会话数据的动态管理和状态同步，适用于会话列表的消息更新和会话内容的初始化场景。